version 2004 (Modifiée)
Element parent (liste; réfElément | *) Entier long
Paramètre | Type | Description | |
liste | RéfListe | Numéro de référence de liste | |
réfElément | * | Entier long | * | 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 | Numéro de référence de l'élément parent | |
ou 0 s'il n'y en a pas |
Description
La commande Element parent retourne le numéro de référence de l'élément parent.
Vous passez dans liste un numéro de référence de liste et dans réfElément le numéro de référence d'un élément de cette 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.
Exemples
Voici une liste hList affichée en mode Utilisation :
Voici les numéros de référence des éléments de cette liste :
Elément | Numéro |
a | 100 |
a-1 | 101 |
a-2 | 102 |
b | 200 |
b-1 | 201 |
b-2 | 202 |
b-3 | 203 |
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.
Référence
CHANGER ELEMENT, INFORMATION ELEMENT, Position element liste, SELECTIONNER ELEMENTS PAR REFERENCE.