4D v16.3

LISTBOX INSERER LIGNES

Accueil

 
4D v16.3
LISTBOX INSERER LIGNES

LISTBOX INSERER LIGNES 


 

LISTBOX INSERER LIGNES ( {* ;} objet ; positionLigne {; nbLignes} )  
Paramètre Type   Description
Opérateur in Si spécifié, objet est un nom d’objet (chaîne) Si omis, objet est une variable
objet  Objet de formulaire in Nom d’objet (si * est spécifié) ou Variable (si * est omis)
positionLigne  Entier long in Emplacement de la ligne à insérer
nbLignes  Entier long in Nombre de lignes à insérer

La commande LISTBOX INSERER LIGNES insère une ou plusieurs nouvelle(s) ligne(s) 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 Objets de formulaires.

Par défaut, si le paramètre nbLignes est omis, une seule ligne est insérée. Sinon, la commande insère le nombre de lignes défini dans ce paramètre.

La ou les ligne(s) est (sont) insérée(s) à l’emplacement défini par le paramètre positionLigne et est (sont) automatiquement ajoutée(s) à 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 commande effectue l'ajout à la fin de chaque tableau. S'il est égal à 0, la commande effectue l'ajout au début de chaque tableau. S'il contient une valeur négative, la commande ne fait rien.



Voir aussi  

LISTBOX SUPPRIMER LIGNES

 
PROPRIÉTÉS 

Produit : 4D
Thème : List Box
Numéro : 913
Nom intl. : LISTBOX INSERT ROWS

Cette commande modifie la variable système OK

 
HISTORIQUE 

Créé : 4D 2004
Renommé : 4D v12
Modifié : 4D v13
Renommé : 4D v13

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)