LISTBOX DELETE ROWS
LISTBOX DELETE ROWS ( {* ;} objet ; positionLigne {; nbLignes} )
| Paramètre | Type | Description | |
|---|---|---|---|
| * | Opérateur | → | Si spécifié, objet est un nom d’objet (chaîne) Si omis, objet est une variable |
| objet | any | → | Nom d’objet (si * est spécifié) ou Variable (si * est omis) |
| positionLigne | Integer | → | Numéro de la première ligne à supprimer |
| nbLignes | Integer | → | Nombre de lignes à supprimer |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande LISTBOX DELETE ROWS supprime une ou plusieurs ligne(s) à partir de la ligne numéro positionLigne (visible ou non) de la list box désignée par les paramètres objet et *.
Note : Cette commande fonctionne uniquement avec les list box basées sur des tableaux. Lorsque cette commande est utilisée avec une list box basée sur des sélections, elle ne fait rien et la variable système OK retourne 0.
Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d’objet (une chaîne). Si vous ne passez pas ce paramètre, vous indiquez que le paramètre objet est une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de variable. Pour plus d'informations sur les noms d’objets, reportez-vous à la section Objets de formulaires.
La ligne positionLigne est supprimée automatiquement de tous les tableaux composant la list box.
Notez qu’après l’exécution de la commande, il n’y a plus d’élément sélectionné dans la list box.
Si le paramètre positionLigne est supérieur au nombre de lignes des tableaux de la list box ou s'il est inférieur à 1, la commande ne fait rien.
Note : Cette commande ne tient pas compte de l'éventuel statut masqué/affiché des lignes de la list box.