4D v14.3

Element parent

Accueil

 
4D v14.3
Element parent

Element parent 


 

Element parent ( {* ;} liste ; refElément | * ) -> Résultat 
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é)
refElément | *  Opérateur, Entier long 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 courant de la liste
Résultat  Entier long in Numéro de référence de l'élément parent ou 0 s'il n'y en a pas

La commande Element parent retourne le numéro de référence de l'élément parent.

Passez dans liste le numéro de référence ou le nom d'objet de la 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.

Note : Si vous utilisez le caractère @ dans le nom d'objet de la liste et que le formulaire contient plusieurs listes répondant à ce nom, la commande Element parent s'appliquera au premier objet dont le nom correspond.

Passez dans réfElément le numéro de référence d'un élément de la liste ou 0, ou encore *. Si vous passez 0, la commande s’applique au dernier élément ajouté à la liste. Si vous passez *, la commande s’applique à l’élément courant de la liste. Si plusieurs éléments sont sélectionnés, l’élément courant est celui qui a été sélectionné en dernier.

En retour, si un élément correspondant existe bien dans la liste et si cet élément se trouve bien dans une sous-liste (et a donc un élément parent), vous récupérez le numéro de référence de l'élément parent.

S'il n'existe pas d'élément numéro réfElément, ou si vous avez passé * et qu’aucun élément n’est sélectionné, ou si cet élément n'a pas d'élément parent, Element parent retourne 0 (zéro).

Si vous travaillez avec les numéros de référence des éléments, assurez-vous d'utiliser des numéros uniques, sinon vous ne pourrez pas différencier les éléments. Pour plus d'informations sur ce point, reportez-vous à la description de la commande AJOUTER A LISTE.

Exemple  

Voici une liste hList affichée en mode Application :

Voici les numéros de référence des éléments de cette liste :

ElémentNuméro
a100
a-1101
a-2102
b200
b-1201
b-2202
b-3203
  • Avec le code ci-dessous, si l'élément “b-3” est sélectionné, la variable $vlParentElémRef prend la valeur 200, c'est-à-dire le numéro de référence de l'élément “b” :
 $vlElémPos:=Elements selectionnes(hList)
 INFORMATION ELEMENT(hList;$vlElémPos;$vlElémRef;$vsItemText)
 $vlParentElémRef:=Element parent(hList;$vlElémRef` $vlParentElémRef vaut 200
  • Si l'élément “a-1” était sélectionné, la variable $vlParentElémRef prendrait la valeur 100, c'est-à-dire le numéro de référence de l'élément “a”.
  • Si l'élément “a” ou “b” était sélectionné, la variable $vlParentElémRef prendrait la valeur 0 car ces éléments n'ont pas d'élément parent.

 
PROPRIÉTÉS 

Produit : 4D
Thème : Listes hiérarchiques
Numéro : 633
Nom intl. : List item parent

 
HISTORIQUE 

Modifié : 4D v11 SQL

 
VOIR AUSSI  

CHANGER ELEMENT
INFORMATION ELEMENT
Position element liste
SELECTIONNER ELEMENTS PAR REFERENCE

 
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)