OBJECT SET STYLE SHEET
OBJECT SET STYLE SHEET ( {* ;} objet ; nomFeuilleStyle )
| Paramètre | Type | Description | |
|---|---|---|---|
| * | Opérateur | → | Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est un champ ou une variable |
| objet | any | → | Nom d'objet (si * est spécifié) ou Champ ou variable (si * est omis) |
| nomFeuilleStyle | Text | → | Nom de la feuille de style |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande OBJECT SET STYLE SHEET vous permet de modifier, pour le process courant, la feuille de style associée à l’objet ou aux objets désigné(s) par les paramètres objet et *. Une feuille de style modifie la police, la taille de police et (hormis pour les feuilles de style automatique) le style de police.
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 le paramètre, vous indiquez que le paramètre objet est un champ ou une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de champ ou de variable (champ ou variable objet uniquement).
Passez dans le paramètre nomFeuilleStyle le nom de la feuille de style à appliquer à l’objet. Vous pouvez également passer soit :
- un nom de feuille de style existante (si la feuille de style n’existe pas, une erreur est retournée, que vous pouvez intercepter l’aide d’une méthode installée par la commande ON ERR CALL),
- une chaîne vide ("") pour ne pas appliquer de feuille de style à l’objet.
- une des constantes suivantes du thème "Styles de caractères" pour appliquer une feuille de style automatique :
| Constante | Type | Valeur | Comment |
|---|---|---|---|
| Automatic style sheet | Chaîne | __automatic__ | Utilisée par défaut pour tous les objets |
| Automatic style sheet_additional | Chaîne | __automatic_additional_text__ | Prise en charge par les textes statiques, champs et variables uniquement. Utilisée pour du texte additionnel dans les boîtes de dialogue. |
| Automatic style sheet_main | Chaîne | __automatic_main_text__ | Prise en charge par les textes statiques, champs et variables uniquement. Utilisée pour le texte principal des boîtes de dialogue. |
Si une feuille de style avait déjà été associée à l’objet en mode Développement, l’appel de cette commande la remplace pour le process courant.
Si vous utilisez au cours de la session les commandes ST SET ATTRIBUTES, ST SET TEXT, OBJECT SET FONT ou OBJECT SET FONT SIZE sur l’objet afin de modifier sa police ou sa taille de police, la référence à la feuille de style est automatiquement supprimée de l’objet -- même si vous affectez des attributs identiques à ceux de la feuille de style. En revanche, si vous modifiez le style (gras, italique...), par exemple avec les commandes ST SET ATTRIBUTES ou OBJECT SET FONT STYLE, ces nouvelles propriétés s’ajoutent à la feuille de style pour la durée de la session.
Note de compatibilité
Dans l'architecture Projet, seules les trois feuilles de style automatiques sont prises en charge par cette commande.
Voir aussi
GET STYLE SHEET INFO
LIST OF STYLE SHEETS
OBJECT Get style sheet
Styles de caractères