LIRE PARAMETRE ELEMENT

4D - Documentation   Français   English   German   Español   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant

version 11


LIRE PARAMETRE ELEMENT ({*; }liste; réfElément | *; sélecteur; valeur)

ParamètreTypeDescription
**Si spécifié, liste est un nom d'objet (chaîne)
Si omis, liste est un numéro de référence de liste
listeRéfListe | ChaîneNuméro de référence de liste (si * omis) ou
Nom d'objet de type liste (si * passé)
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
sélecteurChaîneConstante de paramètre
valeurChaîne | Booléen | NumValeur courante du paramètre

Description

La commande LIRE PARAMETRE ELEMENT permet de connaître la valeur courante du paramètre sélecteur pour l'élément réfElément de la liste hiérarchique dont vous avez passé la référence ou le nom d'objet dans le paramètre 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 LIRE PARAMETRE ELEMENT s'appliquera au premier objet dont le nom correspond.

Vous pouvez passer un numéro de référence dans réfElément. Si ce numéro ne correspond à aucun élément de la liste, la commande ne fait rien. Vous pouvez également passer 0 dans réfElément afin de désigner le dernier élément ajouté à la liste (à l'aide de AJOUTER A LISTE).

Vous pouvez enfin passer * dans réfElément : dans ce cas, la commande s'appliquera à l'élément courant de la liste. Si plusieurs éléments sont sélectionnés manuellement, l'élément courant est celui qui a été sélectionné en dernier. Si aucun élément n'est sélectionné, la commande ne fait rien.

Vous pouvez passer dans sélecteur la constante Texte supplémentaire (placée dans le thème "Listes hiérarchiques") ou toute valeur personnalisée. Pour plus d'informations sur les paramètres sélecteur et valeur, reportez-vous à la description de la commande FIXER PARAMETRE ELEMENT.

Référence

FIXER PARAMETRE ELEMENT.


4D - Documentation   Français   English   German   Español   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant