UpsGng.FeuilleDeStyles.AjouterBrosse

Fonction Optimiser(NulAbsorbant) HabilitationContextuelle AjouterBrosse(Nom : Nul Ou Caractere, S : SorteBrosse, Taille : Reel, AvantPlan : Nul Ou Couleur, ArrierePlan : Nul Ou Couleur=Nul) Retourner Nul Ou Motif;

Description

La méthode AjouterBrosse permet d'ajouter une nouvelle brosse de nom Nom à la feuille de styles courante.

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

La taille de la brosse est donnée par le paramètre Taille. Elle est exprimée dans l'unité de mesure de la feuille de styles au moment de la création de la brosse. Elle n'a d'importance que pour une brosse non personnalisée.

La couleur d'avant plan est donnée par le paramètre AvantPlan. Elle se substitue au noir quand la brosse est personnalisée 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 la brosse est personnalisée 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 la nouvelle brosse.

Le nom de la brosse 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. */
...
B1=F.AjouterBrosse("MaBrosse1", BrosseCerclePoint, P.CouleurRouge, P.CouleurVert);
/* Ajoute une nouvelle brosse en forme de cercle creux avec un point rouge sur vert. */
...
B2=F.AjouterBrosse("MaBrosse2", BrossePersonnalisee, P.CouleurBleu, P.CouleurJaune);
/* Ajoute une nouvelle brosse personnalisée bleu sur fond jaune. */
B2.Personnaliser("${UPS_HOME}/demo/resources/mabrosse2.upl");
/* Personnalise la brosse. */
...
Fin Principal

Voir aussi

ListerBrosses pour lister les brosses.

Traduction

---------