LISTBOX SET ROW FONT STYLE
LISTBOX SET ROW FONT STYLE ( {* ;} 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 | any | → | Nom d'objet (si * est spécifié) ou Variable (si * est omis) |
| ligne | Integer | → | Numéro de ligne |
| style | Integer | → | Style de police |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
Note : Cette commande fonctionne uniquement avec les list box de type tableau.
La commande LISTBOX SET ROW FONT STYLE 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 |
|---|---|---|
| Bold | Entier long | 1 |
| Italic | Entier long | 2 |
| Plain | Entier long | 0 |
| Underline | 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 Get array.
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 SET ROW FONT STYLE(*;"Col5";3;Bold)
// équivaut à ArrCol5Style{3}:=Gras
LISTBOX SET ROW FONT STYLE(*;"List Box";3;Italic+Underline)
// é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).