|
|
|
|
|
|
|
|
|
|
version 2004 (Modifiée)
Elements selectionnes (liste{; tabEléments{; *}}) 
Entier long
| Paramètre | Type | Description | |
| liste | RéfListe | | Numéro de référence de liste |
| tabEléments | Tab Entier long |  | Si * omis : Tableau des positions des éléments |
| sélectionnés parmi la ou les liste(s) déployée(s) | |||
| Si * passé : Tableau des références des éléments | |||
| sélectionnés parmi la ou les liste(s) déployée(s) | |||
| * | * | | Si omis : Position(s) d'élément(s) |
| Si passé : Référence(s) d'élément(s) | |||
| Résultat | Entier long | | Si * omis : Position de l'élément sélectionné |
| parmi la ou les liste(s) déployée(s) | |||
| Si * passé : Référence de l'élément sélectionné |
Description
La fonction Elements selectionnes retourne la position ou la référence de l'élément sélectionné dans la liste dont vous avez passé le numéro de référence dans le paramètre liste. En cas de sélection multiple, la fonction peut également retourner dans le tableau tabEléments la position ou la référence de chaque élément sélectionné. Cette fonction doit être appliquée à une liste affichée dans un formulaire afin de détecter le ou les élément(s) sélectionné(s) par l'utilisateur.
Le paramètre * permet d'indiquer si vous souhaitez travailler avec des positions courantes d'éléments (dans ce cas, ce paramètre doit être omis) ou des références absolues d'éléments (dans ce cas, il doit être passé).
Vous pouvez passer dans le paramètre tabEléments un tableau d'entiers longs. Si nécessaire, le tableau sera créé et redimensionné par la commande. A l'issue de l'exécution de la commande, tabEléments contiendra :
• la position de chaque élément sélectionné parmi la ou les liste(s) déployée(s) si le paramètre * est omis.
• la référence absolue de chaque élément sélectionné si le paramètre * est passé.
Le tableau est retourné vide si aucun élément n'est sélectionné.
Note : En cas de sélection multiple, la commande retourne la position ou la référence de l'élément courant de liste. L'élément courant est le dernier élément sur lequel l'utilisateur a cliqué (sélection manuelle) ou l'élément désigné par la commande SELECTIONNER ELEMENTS PAR POSITION ou SELECTIONNER ELEMENTS PAR REFERENCE (sélection par programmation).
Si la liste comporte des sous-listes, appliquez la fonction à la liste principale (celle qui est associée au formulaire), et non à une de ses sous-listes. Les positions sont exprimées relativement à l'élément supérieur de la liste principale, en tenant compte de l'état courant déployé/contracté de la liste et de ses sous-listes.
Dans tous les cas, si aucun élément n'est sélectionné, la fonction retourne 0.
Exemple
Voici la liste hList telle qu'elle apparaît en mode Utilisation :
$vlItemPos:=Elements selectionnes(hList) ` à ce stade, $vlItemPos vaut 2
$vlItemPos:=Elements selectionnes(hList) ` à ce stade, $vlItemPos vaut 5 $vlItemRef:=Elements selectionnes(hList;*) ` $vlItemRef vaut 200 (par exemple)
$vlItemPos:=Elements selectionnes(hList) ` à ce stade, $vlItemPos vaut 8 $vlItemRef:=Elements selectionnes(hList;*) ` $vlItemRef vaut 203 (par exemple)
$vlItemPos:=Elements selectionnes(hList;$tabPos) ` à ce stade, $vlItemPos vaut 3
` $tabPos{1} vaut 3, $tabPos{2} vaut 4 et $tabPos{3} vaut 5
$vlItemRef:=Elements selectionnes(hList;$tabRefs;*) ` $vlItemRef vaut 203 (par exemple)
` $tabRefs{1} vaut 101, $tabRefs{2} vaut 203 (par exemple)
Référence
SELECTIONNER ELEMENTS PAR POSITION, SELECTIONNER ELEMENTS PAR REFERENCE.
|
|
|
|
|
|
|
|
|
|