4D Doc Center : SELECTIONNER ELEMENTS PAR POSITION

4D v14.3

SELECTIONNER ELEMENTS PAR POSITION


SELECTIONNER ELEMENTS PAR POSITION ( {* ;} liste ; positionElém {; tabPositions} )

Paramètre	Type	Description
*	Opérateur	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	Numéro de référence de liste (si * omis) ou Nom d'objet de type liste (si * passé)
positionElém	Entier long	Position de l'élément dans la ou les liste(s) déployée(s)/contractée(s)
tabPositions	Tableau entier long	Tableau de positions dans la ou les liste(s) déployée(s)/contractée(s)

Description

La commande SELECTIONNER ELEMENTS PAR POSITION sélectionne le ou les élément(s) dont vous avez passé la position dans positionElém et, facultativement, dans tabPositions, à l'intérieur de la liste dont vous avez passé le numéro de référence ou le nom d'objet dans liste.

Si vous passez le 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, vous pouvez utiliser indifféremment l’une ou l’autre syntaxe. En revanche, si vous utilisez plusieurs représentations d’une même liste, la syntaxe basée sur le nom d’objet est requise car chaque représentation peut disposer de sa propre configuration déployée/contractée.

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 SELECTIONNER ELEMENTS PAR POSITION s'appliquera au premier objet dont le nom correspond.

La position des éléments est toujours exprimée en tenant compte de l'état déployé/contracté de la liste et de ses sous-listes. Passez des positions comprises entre 1 et la valeur retournée par Nombre elements. Si vous passez une valeur située en-dehors de cet intervalle, aucun élément n'est sélectionné.

Si vous ne passez pas le paramètre tabPositions, le paramètre positionElém représente la position de l'élément à sélectionner.

Le paramètre facultatif tabPositions permet de sélectionner simultanément plusieurs éléments au sein de la liste. Vous devez passer dans tabPositions un tableau dont chaque ligne indique la position d’un élément à sélectionner.
Lorsque vous passez ce paramètre, l’élément désigné par le paramètre positionElém désigne parmi la sélection résultante le nouvel élément courant de la liste. Il peut appartenir ou non à l’ensemble d’éléments définis par le tableau. L’élément courant est notamment celui qui passe en mode édition si la commande EDITER ELEMENT est utilisée.

Note : Pour que plusieurs éléments puissent être sélectionnés simultanément dans une liste hiérarchique (manuellement ou par programmation), la propriété multiSélection doit avoir été activée pour cette liste. Cette propriété est définie via la commande CHANGER PROPRIETES LISTE.

Exemple

Soit une liste hiérarchique nommée hList affichée en mode Application :

Après l'exécution des lignes de code suivantes :

SELECTIONNER ELEMENTS PAR POSITION(hList;Nombre elements(hList))

... le dernier élément visible est sélectionné :

Après l'exécution des lignes de code suivantes :

 CHANGER PROPRIETES LISTE(hList;0;0;18;0;1)

  `Il est impératif de passer 1 en dernier paramètre pour autoriser les multi-sélections

 TABLEAU ENTIER LONG($tab;3)

 $tab{1}:=2

 $tab{2}:=3

 $tab{3}:=5

 SELECTIONNER ELEMENTS PAR POSITION(hList;3;$tab)

  `Le 3e élément est désigné comme élément courant

... les 2e, 3e et 5e éléments de la liste hiérarchique sont sélectionnés :