INFORMATION ELEMENT

4D - Documentation   Français   English   German   4e Dimension 2003, Commandes par thèmes   4e Dimension 2003, Liste alphabétique des commandes   4e Dimension 2003, Constantes par thèmes   Retour   Précédent   Suivant

version 6.0


INFORMATION ELEMENT (liste; positionElém; numElém; textElém{; sous_Liste{; déployé}})

ParamètreTypeDescription
listeRéfListeNuméro de référence de liste
positionElémNumériquePosition de l'élément dans la ou les liste(s)
déployée(s)
numElémNumériqueNuméro de référence de l'élément
textElémAlphaLibellé de l'élément
sous_ListeRéfListeNuméro de référence de sous-liste (s'il y en a)
déployéBooléenSi une sous-liste est rattachée à l'élément :
Vrai = la sous-liste est déployée
Faux = la sous-liste est contractée

Description

La commande INFORMATION ELEMENT retourne des informations sur l'élément dont vous avez passé la position dans le paramètre positionElém parmi la liste dont vous avez passé le numéro de référence dans liste.

La position doit être exprimée relativement à l'état déployé/contracté de la liste et de ses sous-listes. Vous devez passer une valeur de position comprise entre 1 et la valeur retournée par Nombre elements. Si vous passez une valeur située hors de cet intervalle, INFORMATION ELEMENT retourne les paramètres inchangés.

Après l'appel, vous récupérez :

Le numéro de référence de l'élément dans numElém.

Le libellé de l'élément dans textElém.

Si vous passez les paramètres optionnels sous_Liste et déployé :

sous_Liste contient le numéro de référence de la sous-liste rattachée à l'élément. Si l'élément n'a pas de sous-liste associée, sous_Liste retourne zéro.

Si l'élément comporte une sous-liste, déployé retourne Vrai si la sous-liste est déployée, et Faux sinon.

Exemples

(1) En partant de l'hypothèse que hList est une liste dont les éléments ont des numéros de référence uniques, le code suivant inverse automatiquement l'état déployé/contracté de la sous-liste, si elle existe, rattachée à l'élément sélectionné :

   C_BOOLEEN($vbDéployé)
   C_ENTIER LONG($hSousListe;$vlElemRef)
   C_ALPHA(31;$vsElemText)
      `La déclaration de ces variables est nécessaire si vous souhaitez compiler la méthode

   $vlElemPos:=Element selectionne(hList)
   Si ($vlElemPos>0)
      INFORMATION ELEMENT(hList;$vlElemPos;$vlElemRef;$vsElemText;$hSousListe;$vbDéployé)
      Si (Liste existante($hSousListe))
         CHANGER ELEMENT(hList;$vlElemRef;$vsElemText;$hSousListe;Non($vbDéployé))
         REDESSINER LISTE(hList)
      Fin de si 
   Fin de si  

(2) Reportez-vous à l'exemple de la commande AJOUTER A LISTE.

Référence

CHANGER ELEMENT, CHANGER PROPRIETES ELEMENT, Element parent, Element selectionne, LIRE PROPRIETES ELEMENT, Position element liste.


4D - Documentation   Français   English   German   4e Dimension 2003, Commandes par thèmes   4e Dimension 2003, Liste alphabétique des commandes   4e Dimension 2003, Constantes par thèmes   Retour   Précédent   Suivant