4D Doc Center : LISTBOX INSERER LIGNE

4D v12.4

LISTBOX INSERER LIGNE


LISTBOX INSERER LIGNE ( {* ;} objet ; positionLigne )

Paramètre	Type	Description
*		Si spécifié, objet est un nom d’objet (chaîne) Si omis, objet est une variable
objet	Objet de formulaire	Nom d’objet (si * est spécifié) ou Variable (si * est omis)
positionLigne	Entier long	Emplacement de la ligne à insérer

Description

La commande LISTBOX INSERER LIGNE insère une nouvelle ligne dans l’objet list box désigné 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 Propriétés des objets.

La ligne est insérée à l’emplacement défini par le paramètre positionLigne. Une nouvelle ligne est automatiquement ajoutée à cet emplacement dans tous les tableaux composant la list box, quel que soit leur type, y compris dans les tableaux (colonnes) masqués.

Si le paramètre positionLigne est supérieur au nombre de lignes des tableaux de la list box, la ligne est ajoutée à la fin de chaque tableau. S'il est égal à 0, la ligne est ajoutée au début de chaque tableau. S'il contient une valeur négative, la commande ne fait rien.