Découvrir les listes hiérarchiques en 4D 2004

Date de publication : Février 2005

Par Jamras KOMONCHAROENSIRI (4D Inc.)
 

I. Introduction

II. Commandes CHANGER PROPRIETES LISTE et LIRE PROPRIETES LISTE

Passer la valeur 1 au paramètre multiSélection permet à l'utilisateur de sélectionner plusieurs éléments dans une même liste :



Les sélections multiples peuvent être effectuées à l'aide des combinaisons de touches Maj+clic pour une sélection continue ou Ctrl+clic (Windows) / Commande+clic (MacOS) pour une sélection discontinue.

Le paramètre modifiable permet d'indiquer si la liste sera modifiable par l'utilisateur lorsqu'elle sera affichée sous forme d'énumération associée à un champ ou une variable en saisie. Lorsque l'énumération est modifiable, un bouton Modifier est inséré dans la fenêtre d'énumération et l'utilisateur peut ajouter, supprimer et trier les valeurs via un éditeur spécifique.

Pour que les changement soient pris en compte la commande STOCKER LISTE doit être appliquée après CHANGER PROPRIETES LISTE.

Note : référez-vous à l’exemple 1 dans la base "HList_Demo"

III. Commandes CHANGER PROPRIETES ELEMENT et LIRE PROPRIETES ELEMENT

Le paramètre * passé dans réfElément fait référence à l’élément courant dans la liste hiérarchique. Si plusieurs éléments ont été sélectionnés, l’élément courant est celui sélectionné en dernier.

Par exemple, imaginons que 4D exécute la commande suivante après que l’utilisateur ait fait une sélection :

LIRE PROPRIETES ELEMENT (vlList;*;vbEnterable;vlStyle;vlIcon)



* fait référence à A-1 , le seul élément sélectionné dans la liste.



Si les éléments ont été sélectionnés dans l'ordre suivant : A-1 , A-3 puis A-5, le paramètre * fera référence au dernier élément sélectionné : A-5.

Le paramètre couleur dans CHANGER PROPRIETES ELEMENT doit être au format RVB (un entier long sur 4 bits au format 0x00RRVVBB). Il est également possible d’écrire selon la syntaxe :

   (ValeurRouge << 16)+(ValeurVert << 8)+ValeurBleu

où ValeurRouge, ValeurVert, ValeurBleu sont tous les trois compris entre 0 et 255.


Pour aller plus loin dans les formats de couleurs RVB, reportez-vous à la commande FIXER COULEUR RVB :
http://www.4d.fr/documentation/4Ddoc2004/CMF/CMF00628.HTM.


Ce nouveau paramètre couleur vous permet maintenant d'attribuer une couleur spécifique à chaque élément de votre liste.

Note : référez-vous à l’exemple 2 dans la base "HList_Demo" .

IV. Commandes CHANGER ELEMENT et INFORMATION ELEMENT

Note : référez-vous à l’exemple 3 dans la base "HList_Demo".

V. Commande Element parent

Si vous passez *, la commande s'applique à l'élément courant de la liste. Si plusieurs éléments ont été sélectionnés manuellement, alors le dernier sélectionné est l’élément courant.


Exemple d’une sélection unitaire :



Dans ce cas, l'exécution de la commande Element parent (hList;*) retournera le numéro de référence de A.


Exemple d’une sélection multiple dans un ordre précis : A1-A3-B2



Ici, Element parent (hList;*) retournera le numéro de référence de B, B-2 étant le dernier élément à avoir été sélectionné.

Note : référez-vous à l’exemple 4 dans la base "HList_Demo".

VI. Commande Nombre elements

La commande Nombre elements accepte dorénavant le paramètre *. Lorsque ce paramètre est passé, la commande retourne le nombre total d'éléments présents dans la liste, quel que soit son état courant déployé/contracté.
Lorsque ce paramètre est omis, la commande retourne le nombre d'éléments déployés, en d'autres termes, visibles, en fonction de l'état actuel de la liste et de ses sous-listes.


Exemple :



Dans ce cas, Nombre elements (list) et Nombre elements (list ;*) retourneront tous les deux 9



Alors qu'ici Nombre elements (list) retournera 4 et Nombre elements (list ;*) retournera 9

Note : référez-vous à l’exemple 5 dans la base "HList_Demo".

VII. Commandes SELECTIONNER ELEMENTS PAR REFERENCE et SELECTIONNER ELEMENTS PAR POSITION

SELECTIONNER ELEMENTS PAR REFERENCE

Exemple :

   TABLEAU ENTIER LONG (arrayRef;3)
   arrayRef{1}:=11 ` 11 est le numéro de référence de A-1
   arrayRef{2}:=13 ` 13 est le numéro de référence de A-3
   arrayRef{3}:=20 ` 20 est le numéro de référence de B
   SELECTIONNER ELEMENTS PAR REFERENCE (hlist;20;arrayRef)
      `On désigne l’élément dont le numéro de référence est 20 (B) comme élément courant
   REDESSINER LISTE (hlist)

SELECTIONNER ELEMENTS PAR POSITION

Exemple :

   TABLEAU ENTIER LONG (arrayPosition;3)
   arrayPosition {1}:=2 ` A-1 est positionné en 2
   arrayPosition {2}:=4 ` A-3 est positionné en 4
   arrayPosition {3}:=7 ` B est positionné en 7
   SELECTIONNER ELEMENTS PAR POSITION (hlist;4; arrayPosition)
      `On désigne l’élément en position 4 (A-3) comme étant l’élément courant
   REDESSINER LISTE (hlist)

Note : référez-vous à l’exemple 6 dans la base "HList_Demo".

VIII. Commande Elements selectionnes

Note : référez-vous à l’exemple 7 dans la base "HList_Demo".

IX. Edition par l'utilisateur

La version 2004 permet à l'utilisateur de modifier directement le libellé de chaque élément d'une liste hiérarchique, cette fonctionnalité est gérée via la fenêtre liste des propriétés de l'objet. Pour activer manuellement cette propriété, il suffit de cocher la case saisissable dans la section saisie de la liste des propriétés de la liste hiérarchique.




Quand la liste hiérarchique est affichée en mode "Utilisation" ou "Menus créés", l'utilisateur a la possibilité de modifier le libellé d'un élément en cliquant une première fois sur celui-ci :



puis en cliquant une deuxième fois et en gardant le bouton de la souris enfoncé pendant environ une seconde. Le libellé apparaît alors en mode inversé (surligné) et il peut être édité :



Si vous désirez attribuer individuellement la propriété saisissable à un élément d'une liste, vous pouvez utiliser la commande CHANGER PROPRIETES ELEMENT.

Vous pouvez également forcer le mode édition d'un élément d'une liste (indépendamment de sa propriété saisissable ou non-saisissable) en utilisant la commande EDITER ELEMENT.


Exemple :

   C_ENTIER LONG ($selectitempos)
   $selectitempos:=Elements selectionnes(HList)
   Si ($selectitempos>0)
      EDITER ELEMENT(HList;$selectitempos)
   Fin de si

X. Nouveaux événements pour les listes hiérarchiques

XI. Conclusion

XII. Base exemple

__________________________________________________
Copyright © 1985-2008 4D SA - Tous droits réservés
Tous les efforts ont été faits pour que le contenu de cette note technique présente le maximum de fiabilité possible.
Néanmoins, les différents éléments composant cette note technique, et le cas échéant, le code, sont fournis sans garantie d'aucune sorte. L'auteur et 4D S.A. déclinent donc toute responsabilité quant à l'utilisation qui pourrait être faite de ces éléments, tant à l'égard de leurs utilisateurs que des tiers.
Les informations contenues dans ce document peuvent faire l'objet de modifications sans préavis et ne sauraient en aucune manière engager 4D SA. La fourniture du logiciel décrit dans ce document est régie par un octroi de licence dont les termes sont précisés par ailleurs dans la licence électronique figurant sur le support du Logiciel et de la Documentation afférente. Le logiciel et sa documentation ne peuvent être utilisés, copiés ou reproduits sur quelque support que ce soit et de quelque manière que ce soit, que conformément aux termes de cette licence.
Aucune partie de ce document ne peut être reproduite ou recopiée de quelque manière que ce soit, électronique ou mécanique, y compris par photocopie, enregistrement, archivage ou tout autre procédé de stockage, de traitement et de récupération d'informations, pour d'autres buts que l'usage personnel de l'acheteur, et ce exclusivement aux conditions contractuelles, sans la permission explicite de 4D SA.
4D, 4D Calc, 4D Draw, 4D Write, 4D Insider, 4ème Dimension ®, 4D Server, 4D Compiler ainsi que les logos 4e Dimension, sont des marques enregistrées de 4D SA.
Windows,Windows NT,Win 32s et Microsoft sont des marques enregistrées de Microsoft Corporation.
Apple, Macintosh, Power Macintosh, LaserWriter, ImageWriter, QuickTime sont des marques enregistrées ou des noms commerciaux de Apple Computer,Inc.
Mac2Win Software Copyright © 1990-2002 est un produit de Altura Software,Inc.
4D Write contient des éléments de "MacLink Plus file translation", un produit de DataViz, Inc,55 Corporate drive,Trumbull,CT,USA.
XTND Copyright 1992-2002 © 4D SA. Tous droits réservés.
XTND Technology Copyright 1989-2002 © Claris Corporation.. Tous droits réservés ACROBAT © Copyright 1987-2002, Secret Commercial Adobe Systems Inc.Tous droits réservés. ACROBAT est une marque enregistrée d'Adobe Systems Inc.
Tous les autres noms de produits ou appellations sont des marques déposées ou des noms commerciaux appartenant à leurs propriétaires respectifs.
__________________________________________________