UpsGng.FeuilleDeStyles.AjouterMotif

Fonction Optimiser(NulAbsorbant) HabilitationContextuelle AjouterMotif(Nom : Nul Ou Caractere, S : SorteMotif, AvantPlan : Nul Ou Couleur, ArrierePlan : Nul Ou Couleur=Nul) Retourner Nul Ou Motif;

Description

La méthode AjouterMotif permet d'ajouter un nouveau motif de nom Nom à la feuille de styles courante.

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

La couleur d'avant plan est donnée par le paramètre AvantPlan. Elle se substitue au noir quand le motif est personnalisé par une dessin en noir et blanc.

La couleur d'arrière plan est donnée par le paramètre ArrierePlan. Elle se substitue au blanc quand le motif est personnalisé par une dessin en noir et blanc. Par défaut, l'arrière plan est transparent. La couleur d'arrière plan n'a un intérêt que si le motif n'est pas uni.

Le résultat est le nouveau motif.

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

Si Nom ou AvantPlan sont Nul, alors le résultat est Nul.

Exemple

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

Debut
F.Unite=SousMetriquePoint;
/* L'unite est le point typographique. */
...
M1=F.AjouterMotif("MonMotif1", MotifHachureVerticale, P.CouleurRouge, P.CouleurVert);
/* Ajoute un nouveau motif hachuré rouge sur vert. */
...
M2=C.AjouterMotif("MonMotif2", MotifPersonnalise, P.CouleurBleu, P.CouleurJaune);
/* Ajoute un nouveau motif personnalisé bleu sur fond jaune. */
M2.Personnaliser("${UPS_HOME}/demo/resources/monmotif2.upl");
/* Personnalise le motif. */
...
Fin Principal

Voir aussi

ListerMotifs pour lister les motifs.

Traduction

---------