SET LIST PROPERTIES

SET LIST PROPERTIES ( liste ; apparence {; icône {; hauteurLigne {; doubleClic {; multiSélection {; modifiable}}}}} )

Paramètre	Type		Description
liste	Integer	→	Numéro de référence de la liste
apparence	Integer	→	*** paramètre obsolète, toujours passer 0 ***
icône	Integer	→	*** Paramètre obsolète, toujours passer 0 ***
hauteurLigne	Integer	→	Hauteur minimale de la ligne (pixels)
doubleClic	Integer	→	Déploiement/contraction sur double-clic 0 = autoriser, 1= empêcher
multiSélection	Integer	→	Sélections multiples 0 = interdire (défaut), 1 = autoriser
modifiable	Integer	→	Enumération modifiable 0 = non, 1 = oui (défaut)

Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.

Description

La commande SET LIST PROPERTIES définit la hauteur de ligne et le fonctionnement de la liste hiérarchique dont la référence est passée dans le paramètre liste.

Note de compatibilité : Les paramètres apparence et icône sont obsolètes, ils doivent toujours prendre la valeur 0.

Note : Si vous voulez personnaliser l'icône de chaque élément d'une liste hiérarchique, utilisez la commande SET LIST ITEM PROPERTIES.

Si vous ne passez pas le paramètre hauteurLigne, la hauteur de ligne d'une liste hiérarchique sera déterminée par la police et la taille de police utilisées pour l'objet. Vous pouvez également passer dans le paramètre hauteurLigne la hauteur minimale des lignes de la liste hiérarchique. Si la valeur que vous passez est supérieure à la hauteur des lignes définie par la police et la taille de police, elle sera utilisée pour fixer la hauteur des lignes. Passez 0 pour utiliser la hauteur par défaut.

Le paramètre facultatif doubleClic permet d’empêcher que le double-clic sur un élément de la liste ne provoque le déploiement ou la contraction de sa sous-liste.
Par défaut, une sous-liste est déployée ou contractée en cas de double-clic sur l’élément parent. Certains types d’interfaces peuvent toutefois nécessiter une désactivation de ce mécanisme. Pour cela, passez 1 dans le paramètre doubleClic. A noter que seul le double-clic sera désactivé. Les sous-listes pourront toujours être déployées ou contractées par un clic sur l’icône de déploiement.
Si vous passez 0 ou omettez ce paramètre, le fonctionnement par défaut est appliqué.

Le paramètre facultatif multiSélection permet d’indiquer si la liste doit accepter les sélections multiples.
Par défaut, il n’est pas possible de sélectionner simultanément plusieurs éléments d’une liste hiérarchique. Si vous souhaitez que cette fonction soit disponible pour la liste, passez la valeur 1 dans le paramètre multiSélection. Dans ce cas, les sélections multiples peuvent être effectuées :
- manuellement, à l’aide des combinaisons de touches Maj+clic pour une sélection continue ou Ctrl+clic (Windows) / Commande+clic (Mac OS) pour une sélection discontinue,
- par programmation, à l’aide des commandes SELECT LIST ITEMS BY POSITION et SELECT LIST ITEMS BY REFERENCE.
Si vous passez 0 ou omettez le paramètre multiSélection, le fonctionnement par défaut est appliqué.

Le paramètre facultatif 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.
Si vous passez 1 ou omettez le paramètre modifiable, l’énumération sera modifiable par l’utilisateur ; si vous passez 0, elle ne sera pas modifiable.

Exemple

Vous souhaitez interdire le déploiement/contraction sur double-clic. Vous pouvez écrire dans la méthode du formulaire :

 Case of
    :(FORM Event=On Load)
       hlVilles:=Load list("Villes") //charger l'énumération Villes dans l'objet hlVilles
       SET LIST PROPERTIES(hlVilles;0;0;0;1) //pas de déploiement sur double-clic
 End case

Voir aussi

GET LIST ITEM PROPERTIES
GET LIST PROPERTIES
SET LIST ITEM PROPERTIES