UpsGng.FeuilleDeStyles.AjouterStyleTexte

Fonction Optimiser(NulAbsorbant) HabilitationContextuelle AjouterStyleTexte(Nom : Nul Ou Caractere, S : SorteStyleTexte, NomPolice : Nul OuCaractere, Crayon : Nul Ou Pinceau, Fond : Nul Ou Motif, Taille : Reel, Crenage : Reel=0.0, Orientation : Reel=0.0, Gras : Booleen=Faux, Italique : Booleen=Faux, Souligne : Nul Ou StyleCadre=Nul, Barre : Nul Ou StyleCadre=Nul, Encadre : Nul Ou StyleCadre=Nul, Orthogonale : Booleen=Faux) Retourner Nul Ou StyleTexte;

Description

La méthode AjouterStyleTexte permet d'ajouter un nouveau style de texte de nom Nom à la feuille de styles courante.

La sorte du style de texte est donnée par le paramètre S. Pour plus de précisions sur les sortes de styles de texte, merci de se référer à la fiche SorteStyleTexte.

Le nom de la police est donné par le paramètre NomPolice. Elle doit être déclarée dans la configuration d'Up ! Graphical Engine.

Le crayon pour dessiner les glyphes est donné par le paramètre Pinceau. A ce jour, seule la couleur d'avant plan est utilisée.

Le fond des glyphes est donné par le paramètre Fond. Par défaut, le fond est transparent.

La hauteur des lettres est donnée par le paramètre Taille. Elle est exprimée dans l'unité de mesure à la feuille de styles au moment de la création du style de texte.

Le crénage entre les lettres est donné par le paramètre Crenage. Il est exprimé dans l'unité de mesure de la feuille de styles au moment de la création du style de texte. Par défaut, il n'y pas d'espacement supplémentaire entre les lettres d'un mot.

L'orientation de la ligne sur laquelle repose le texte est donnée par le paramètre Orientation. Elle est exprimée en radians. Par défaut, l'écriture est horizontale pour les glyphes occidentales et verticale pour les glyphes asiatiques.

L'écriture est en gras si le paramètre Gras a pour valeur Vrai. Par défaut, le mode n'est pas gras.

L'écriture est en italique si le paramètre Italique a pour valeur Vrai. Par défaut, le mode n'est pas italique.

L'écriture est soulignée avec le style de cadre donné par le paramètre Souligne. Par défaut, il n'y a pas de soulignement.

L'écriture est barrée avec le style de cadre donné par le paramètre Barre. Par défaut, il n'y a pas de barré.

L'écriture est encadrée avec le style de cadre donné par le paramètre Encadre. Par défaut, il n'y a pas d'encadrement.

L'écriture est orthogonale si le paramètre Orthogonale a pour valeur Vrai. En ce cas, les glyphes occidentales sont écrites verticalement et les glyphes asiatiques sont écrites horizontalement. Par défaut, le mode d'écriture est non orthogonale.

Le résultat est le nouveau style de cadre.

Le nom du style de cadre doit être unique. Sinon l'exception ObjetGraphiqueExisteDeja est envoyée.

Si Nom, NomPolice, Crayon ou Fond sont Nul, alors le résultat est Nul.

Exemple

Principal
/*******/
Variable
/******/

Debut
F.Unite=SousMetriquePoint;
/* L'unite est le point typographique. */
...
S1=F.AjouterStyleTexte("MonStyleTexte1", StyleTexteContour, "Arial", MonPinceauRouge, F.MotifNul, 16.0);
/* Ajoute un nouveau style de texte en Arial haut de 16 points de couleur rouge. */
...
S2=F.AjouterStyleTexte("MonStyleTexte2", StyleTexteRelief, "Univers", MonPinceauCyan, F.MotifNul, 14.0, 0.0, Vrai);
/* Ajoute un nouveau style de texte en Univers gras haut de 14 points de couleur cyan. */
...
S3=F.AjouterStyleTexte("MonStyleTexte3", StyleTexteNormal, "Courrier", F.PinceauNoir, F.MotifNul, 12.0, 0.0, Faux, Faux, F.PinceauNoir);
/* Ajoute un nouveau style de texte en Courrier souligné haut de 10 points de couleur noir. */
...
Fin Principal

Voir aussi

ListerStylesTexte pour lister les styles de texte.

Traduction

---------