wcInsertItem(), fonction

Insère la chaîne à la position spécifiée dans une zone de liste ou une zone de liste modifiable. Contrairement à wcAddItem(), la fonction wcInsertItem() ne tient pas compte du classement de la liste, même si celle-ci est créée avec un ordre de tri.

Catégorie

Contrôle Windows

Syntaxe

[NumErreur=]wcInsertItem("nomControle", positionElement, "Message");

Paramètres

nomControle

Nom du contrôle Windows. Par exemple, ListBox_1. Chaîne littérale ou variable de type message

positionElement

Numéro correspondant à la position de l’élément à ajouter. Si ce paramètre est forcé à -1, la chaîne est ajoutée à la fin de la liste. Nombre ou variable de type entier.

Message

Contient la chaîne à insérer à la position indiquée par positionElement. Chaîne littérale ou variable de type message

Remarques

Pour consulter la liste des numéros d’erreur renvoyés, voir Messages d’erreur des contrôles Windows.

S’applique à

zones de listes et listes modifiables.

Exemple(s)

L’instruction suivante insère un nouvel élément intitulé « Myrtille » dans une zone de liste, en quatrième position à partir du début, lorsque le script d’action est exécuté.

wcInsertItem("ListBox_1", 4, "Myrtille");

Voir aussi

wcAddItem()