4D v14.3

INSERER DANS LISTE

Accueil

 
4D v14.3
INSERER DANS LISTE

INSERER DANS LISTE 


 

INSERER DANS LISTE ( {* ;} liste ; avantElément | * ; libelléElément ; réfElément {; sous_Liste ; déployée} ) 
Paramètre Type   Description
Opérateur in Si spécifié, liste est un nom d'objet (chaîne) Si omis, liste est une référence de liste
liste  RefListe, Chaîne in Numéro de référence de liste (si * omis) ou Nom d'objet de type liste (si * passé)
avantElément | *  Entier long, Opérateur in Numéro de référence d'élément ou 0 pour le dernier élément ajouté à la liste ou * pour l'élément de la liste actuellement sélectionné
libelléElément  Chaîne in Libellé du nouvel élément
réfElément  Entier long in Numéro de référence unique du nouvel élément
sous_Liste  RefListe in Sous-liste optionnelle rattachée au nouvel élément
déployée  Booléen in Indique si la sous-liste doit être déployée ou non

La commande INSERER DANS LISTE insère l'élément désigné par le paramètre réfElément dans la liste dont le numéro de référence ou le nom d'objet est passé dans liste.

Si vous passez le premier paramètre optionnel *, vous indiquez que le paramètre liste est un nom d’objet (chaîne) correspondant à une représentation de liste dans le formulaire. Si vous ne passez pas ce paramètre, vous indiquez que le paramètre liste est une référence de liste hiérarchique (RéfListe). Si vous utilisez une seule représentation de liste ou travaillez avec les éléments structurels (le second * est omis), vous pouvez utiliser indifféremment l’une ou l’autre syntaxe. En revanche, si vous utilisez plusieurs représentations d’une même liste et travaillez avec l’élément courant (le second * est passé), la syntaxe basée sur le nom d’objet est requise car chaque représentation peut disposer de son propre élément courant.

Le paramètre avantElément permet de désigner l'élément avant lequel vous souhaitez insérer le nouvel élément :

  • Vous pouvez passer la valeur 0 afin de désigner le dernier élément ajouté à la liste. Le nouvel élément devient l'élément sélectionné.
  • Vous pouvez passer * afin que le nouvel élément soit inséré avant l'élément actuellement sélectionné dans la liste. Le nouvel élément devient l'élément sélectionné.
  • Si vous souhaitez insérer le nouvel élément avant un élément spécifique, passez le numéro de référence de cet élément comme deuxième paramètre. Dans ce cas, le nouvel élément inséré n'est pas automatiquement sélectionné. Si le numéro que vous passez ne correspond à aucun élément de la liste, la commande ne fait rien.

Vous passez le texte et le numéro de référence du nouvel élément dans les paramètres libelléElément et réfElément.

Si vous souhaitez que l'élément comporte des sous-éléments, passez un numéro de référence de liste valide dans le paramètre sous_Liste. Dans ce cas, vous devez également passer le paramètre déployée. Passez Vrai ou Faux dans ce paramètre pour que cette sous-liste s'affiche respectivement déployée ou contractée.

Exemple  

L'exemple suivant insère un élément (associé à aucune sous-liste) juste devant l'élément actuellement sélectionné dans la liste hList:

 vlUniqueRef:=vlUniqueRef+1
 INSERER DANS LISTE(hList;*;"Nouvel élément";vlUniqueRef)

 
PROPRIÉTÉS 

Produit : 4D
Thème : Listes hiérarchiques
Numéro : 625
Nom intl. : INSERT IN LIST

 
HISTORIQUE 

Modifié : 4D v11 SQL

 
VOIR AUSSI  

AJOUTER A LISTE

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v12.4)
4D - Langage ( 4D v11 SQL Release 6)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)