Voir égalementAccès aux propriétés du contrôle List-box.
Support WebVue partiel. Voir le tableau avec la liste des modes ci-dessous. Les modes non supportés renvoient un code d'erreur si exécutés dans ce contexte.
|
Mode |
Mnémonique |
Syntaxe |
Support WebVue |
| 1 | COUNT | 1 | Oui |
| 2 | GETSELECTEDINDEX | 1 | Oui |
| 3 | SETSELECTEDINDEX | 2 | Oui |
| 4 | GETTEXT | 3 | Oui |
| 5 | GETUSERDATA | 3 | Oui |
| 6 | LOAD | 4 | Oui |
| 7 | INSERT | 5 | Oui |
| 8 | REMOVE | 6 | Oui |
| 9 | SORT | 7 | Non |
| 10 | CLEAR | 1 | Non |
| 11 | SETTEXT | 8 | Non |
| 12 | SETUSERDATA | 8 | Non |
| 13 | SAVE | 4 | Non |
Arguments communs à plus d'un mode
|
Argument |
Définition |
| Window | Nom de la fenêtre contenant le contrôle. Type STR |
| Branch | Branche (si elle existe) de la fenêtre. Utiliser "*" pour indiquer la branche courante du programme. Type STR. |
| Identity | Identifiant du contrôle de formulaire dans la fenêtre spécifiée. Type STR |
| Index |
Index de l'élément à sélectionner. Type de retour : LONG. |
Syntaxe 1
LongVal = LISTBOX(Mode, Window, Branch, Identity);
Type de retour : LONG
Exécution
|
Mode |
Mnémonique |
Action |
|
1 |
COUNT |
Retourne le nombre d'éléments. |
| 2 |
GETSELECTEDINDEX |
Retourne l'index de l'élément actuellement sélectionné. |
| 10 | CLEAR |
Vide le contenu de la liste et toute sélection. Retour : 1 si OK. |
| Retour : 0 en cas d'erreur. |
Syntaxe 2
LongVal = LISTBOX(Mode, Window, Branch, Identity, Index[, Notify]);
Type de retour : LONG
|
Argument |
Définition |
|
Notify |
Indique si la sélection déclenche l'exécution de la fonction SCADA Basic définie dans la configuration Opérations du contrôle. Type INTEGER |
Exécution
|
Mode |
Mnémonique |
Action |
|
3 |
SETSELECTEDINDEX |
Sélectionne l'élément selon son index. Si l'index est -1 aucun élément n'est sélectionné. Si nécessaire, la fonction fera défiler le contrôle pour afficher l'élément. Retour : 1 si OK, 0 sinon. |
Syntaxe 3
StrVal = LISTBOX(Mode, Window, Branch, Identity, Index);
Type de retour : STR
Exécution
|
Mode |
Mnémonique |
Action |
|
4 |
GETTEXT |
Retourne le Texte de l'élément Index comme défini dans la langue actuellement utilisée. |
| 5 | GETUSERDATA | Retourne les données utilisateur associées à l'élément Index. |
Syntaxe 4
LongVal = LISTBOX(Mode, Window, Branch, Identity, FileName);
Type de retour : LONG.
|
Argument |
Définition |
|
FileName |
Nom du fichier contenant les données du contrôle. |
Exécution
|
Mode |
Mnémonique |
Action |
|
6 |
LOAD |
Charge le contenu du fichier de la liste du contrôle des éléments. Retour : 1 si OK (fichier chargé), 0 sinon. |
| 13 | SAVE |
Enregistre la liste des éléments du contrôle de formulaire dans un fichier. La source du contrôle de formulaire doit être définie à Fichier ou l'instruction échouera. Retour : 1 si OK (éléments enregistrés dans un fichier), 0 sinon. |
Syntaxe 5
LongVal = LISTBOX(Mode, Window, Branch, Identity, Text, Userdata, [Index]);
Type de retour : LONG.
|
Argument |
Définition |
| Text | Texte à insérer. Type STR. |
| Userdata | Données utilisateur à insérer. Type STR. |
Exécution
|
Mode |
Mnémonique |
Action |
|
7 |
INSERT |
Insère un nouvel élément avec le Text et les UserData optionnelles dans la liste du contrôle. Si Index est omis, l'élément est inséré à la fin. Sinon, l'élément est inséré à la position indiquée par Index, démarre à 0 pour le premier élément. |
Syntaxe 6
LongVal = LISTBOX(Mode, Window, Branch, Identity, Index);
Type de retour : LONG.
Exécution
|
Mode |
Mnémonique |
Action |
|
8 |
REMOVE |
Supprime l'élément Index de la liste. |
Syntaxe 7
LongVal = LISTBOX(Mode, Window, Branch, Identity[, Sortorder, Orderby]);
Type de retour : LONG.
|
Argument |
Définition |
| Sortorder | Flag indiquant l'ordre du tri. 0 = ascendant, 1 = descendant. |
| Orderby | Flag indiquant quelles données à trier. 0 = Texte, 1 = Données utilisateur. |
Exécution
|
Mode |
Mnémonique |
Action |
|
9 |
SORT |
Trie la liste du contrôle en utilisant le critère spécifié. |
Syntaxe 8
LongVal = LISTBOX(Mode, Window, Branch, Identity[, Index, StrVal]);
Type de retour: LONG.
|
Argument |
Définition |
| StrVal | La valeur de la chaîne à définir. |
Exécution
|
Mode |
Mnémonique |
Action |
| 11 | SETTEXT | Définit le texte de l'élément à Index avec la valeur StrVal. |
| 12 | SETUSERDATA | Définit les données utilisateur associées à l'élément à Index avec la valeur StrVal. |
| Retour : 1 si OK, 0 sinon. |
Exemple
Pour un exemple, sélectionnez le lien Exemple ci-dessus.