| CHGSTL |
"Chgstl" permet d'affecter dynamiquement un style au contenu d'un champ d'écran.
Syntaxe
Chgstl[ classe] [ liste_zones]Withstyle
Paramètres
Elément | Description | Restrictions |
En l'absence de ce paramètre, le masque par défaut est utilisé. | classe désigne un masque ouvert par l'ordre Mask. | |
Liste de | Aucune | |
Identification d'une zone sous l'une desformes suivantes : | Les zones dont le nom est donné doivent être définies dans le masque correspondant. | |
Expression entière dont la valeur est l'indice de la variable à afficher. | L'indice doit être dans l'intervalle défini par le facteur de répétition. | |
Intervalle de zones, c'est-à-dire deux noms de zones séparés par le caractère '-' (signe moins). | Les deux zones doivent appartenir aumasque correspondant | |
Nombre entier dont la valeur est un numéro de rang. | 1 <= no_rang <= 99 | |
Intervalle de rangs, c'est-à-dire deux numéros de rangs rang1 et rang2 séparés par le caractère '-' | rang1 <= rang2 | |
Expression alphanumérique dont le résultat est un nom de variable ou un rang |
| |
Chaîne de description au format css. |
|
Exemples
# Affectation du style contenu dans la variable STYLE,
# des zones de rang 1, 15 à 30, et des zones CHP1, VAR à FIN du masque courant.
Chgstl1, 15-30, CHP1,VAR-FIN With STYLE
# Changement de style de toutes les zones du masque d'abréviation FACT.
Chgstl[FACT] With STYLE
# Changement de style des champs du masque courant.
ChgstlWith STYLE
# Affectation du style par défaut
ChgstlCHP1 With""
# Changement de style d'une cellule d'un tableau
# COLONNE est un champ d'un bloc tableau
ChgstlCOLONNE(nolign-1)With STYLE
# Changement de style d'une colonne d'un tableau
ChgstlCOLONNE With STYLE
# Changement de style d'une ligne d'un tableau
# NBLIG est la variable de bas de tableau
ChgstlNBLIG(nolign-1) WithSTYLE
# Changement de style de tout un tableau
# NBLIG est la variable de bas de tableau
ChgstlNBLIG With STYLE
Description et commentaires
"Chgstl" permet de changer le style de tout ou partie du contenu des zones d'un masque. Le style est défini par un nom auquel on associe des caractéristiques graphiques : couleur du texte, couleur de fond, police de caractères, taille de la police, attributs ( souligné, barré, italique, gras ).
Si le style n'est pas défini, il n'y a pas d'erreur mais il n'y a pas d'application de style.
Si le style n'est pas précisé ( With "" ), le style par défaut est affecté. Dans X3, ce style par défaut est défini dans le menu "Outils / Options / Polices et styles".
Dans un tableau, il n'est pas nécessaire d'avoir fait un affzo, pour modifier le style d'une colonne ce qui n'est pas le cas, pour une ligne ou une cellule.
L'ordre de traitement des champs utilisé est toujours celui découlant des rangs de saisie et de la position des champs à l'écran. Par conséquent, si on veut changer cet ordre de traitement, il est nécessaire d'utiliser plusieurs instructions "Chgstl".
De même, lorsqu'on donne un intervalle de zones à traiter, c'est l'ordre de saisie qui est considéré pour déterminer quelles sont les zones de l'intervalle.
Remarques
Quelques limites existent au sujet des styles appliqués à des champs désactivés (ie dont la valeur n'a pas de sens dans un contexte donné : cette caractéristique est obtenue par l'instruction adonix nommée Grizo), et des champs affichés uniquement (cette caractéristique est obtenue par l'instruction adonix nommée Diszo). Pour plus de détail, se reporter au paragraphe "Limitation à la gestion des styles" de la documentation des styles de présentation.
Erreurs associées
ERVARI(6) | Zoneinexistante dans le masque donné. |
ERCLAS(7) | Masquenon déclaré. |
Mots-clés associés
Adonix X3(r) L4G |