4D Doc Center : LISTBOX FIXER STYLE LIGNE

4D v14.3

LISTBOX FIXER STYLE LIGNE


LISTBOX FIXER STYLE LIGNE ( {* ;} objet ; ligne ; style )

Paramètre	Type	Description
*	Opérateur	Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est une variable
objet	Objet de formulaire	Nom d'objet (si * est spécifié) ou Variable (si * est omis)
ligne	Entier long	Numéro de ligne
style	Entier long	Style de police

Description

Note : Cette commande fonctionne uniquement avec les list box de type tableau.

La commande LISTBOX FIXER STYLE LIGNE vous permet de définir un style de police pour une ligne ou une cellule de la list box tableau désignée par les paramètres objet et *.

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.

Vous pouvez désigner comme paramètre objet une list box ou une colonne de list box :

si objet désigne une list box, la commande s’applique à la ligne
si objet désigne une colonne, la commande s’applique à la cellule située à l’intersection colonne/ligne

Passez dans ligne le numéro de la ligne à laquelle le nouveau style doit être appliqué.

Note : La commande ne tient pas compte de l’éventuel statut masqué/affiché des lignes de la list box.

Passez dans style une valeur de style. Vous devez utiliser une ou une combinaison de constante(s) du thème Styles de caractères :

Constante	Type	Valeur
Gras	Entier long	1
Italique	Entier long	2
Normal	Entier long	0
Souligné	Entier long	4

Si un tableau de styles de police a été associé à la list box ou à la colonne, seul l’élément correspondant à la ligne sera modifié. Autrement dit, dans ce cas, l’exécution de la commande produit le même effet que la modification d’un élément du tableau de styles de police.
Si aucun tableau de styles de police n’a été associé à la list box ou à la colonne, il est créé dynamiquement lors de l’appel de la commande. Vous pourrez y accéder à l’aide de la commande LISTBOX Lire tableau.

Si des propriétés de style contradictoires sont définies pour la colonne ou la list box, un ordre de priorité est appliqué. Pour plus d’informations, reportez-vous au manuel Mode Développement.

Note : Comme les tableaux de style des colonnes ont priorité sur le tableau de style de la list box, la commande, si elle est appliquée à une list box, n’aura d’effet que si aucun tableau de style n’a été affecté aux colonnes.

Exemple

Soit une list box tableau ayant les caractéristiques suivantes :

un tableau de styles de police est associé à la list box (ArrGlobalStyle)
un tableau de styles de police est associé à la colonne 5 (ArrCol5Style)
les autres colonnes n’ont pas de tableau de style

 LISTBOX FIXER STYLE LIGNE(*;"Col5";3;Gras)

     // équivaut à ArrCol5Style{3}:=Gras

 LISTBOX FIXER STYLE LIGNE(*;"List Box";3;Italique+Souligné)

     // équivaut à ArrGlobalStyle{3}:=Italique+Souligné

Après la deuxième instruction, toutes les cellules de la troisième ligne passent en italique et souligné sauf celle de la colonne 5, qui reste en gras uniquement (les tableaux de colonnes sont prioritaires sur les tableaux de list box).