LISTBOX SET HIERARCHY
LISTBOX SET HIERARCHY ( {* ;} objet ; hiérarchique {; hiérarchie} )
| Paramètre | Type | Description | |
|---|---|---|---|
| * | Opérateur | → | Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est une variable |
| objet | any | → | Nom d'objet (si * est spécifié) ou Variable (si * est omis) |
| hiérarchique | Boolean | → | Vrai = list box hiérarchique, Faux = list box non hiérarchique |
| hiérarchie | Pointer array | → | Tableau de pointeurs |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande LISTBOX SET HIERARCHY vous permet de configurer l'objet list box désigné par les paramètres objet et * en mode hiérarchique ou non.
Note : Cette commande fonctionne uniquement avec les list box basées sur des tableaux. Si elle est utilisée avec une list box basée sur des sélections, elle ne fait rien.
Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d'objet (une chaîne). Si vous ne passez pas ce paramètre, vous indiquez que le paramètre objet est une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de variable.
Le paramètre booléen hiérarchique vous permet de définir le mode de la list box :
- si vous passez Vrai, la list box est affichée en mode hiérarchique,
- si vous passez Faux, la list box est affichée en mode non hiérarchique (mode tableau standard).
Lorsque vous passez une list box en mode hiérarchique, certaines propriétés sont automatiquement restreintes. Pour plus d’informations, reportez-vous à la section Gestion des List box hiérarchiques.
Le paramètre hiérarchie vous permet de désigner les tableaux de la list box à utiliser pour construire la hiérarchie (cf. exemple).
Si vous affichez la list box en mode hiérarchique et omettez ce paramètre :
- si la list box est déjà en mode hiérarchique, la commande ne fait rien.
- si la list box est en mode non hiérarchique et n’a jamais été déclarée hiérarchique, le premier tableau est utilisé comme hiérarchie par défaut.
- si la list box est en mode non hiérarchique mais avait été déclarée hiérarchique précédemment, la dernière hiérarchie est rétablie.
Exemple
Définition des tableaux tPays, tRegion et tVille comme hiérarchie d’une list box :
ARRAY POINTER($TabHierarch;3)
$TabHierarch{1}:=->tPays //Premier niveau de rupture
$TabHierarch{2}:=->tRegion //Deuxième niveau de rupture
$TabHierarch{3}:=->tVille //Troisième niveau de rupture
LISTBOX SET HIERARCHY(*;"mylistbox";True;$TabHierarch)