UpsGng.FeuilleDeStyles.AjouterPinceau

Fonction Optimiser(NulAbsorbant) HabilitationContextuelle AjouterPinceau(Nom : Nul Ou Caractere, S : SortePinceau, Taille : Reel, AvantPlan : Nul Ou Couleur, ArrierePlan : Nul Ou Couleur=Nul) Retourner Nul Ou Pinceau;

Description

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

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

La taille du pinceau 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 du pinceau.

La couleur d'avant plan est donnée par le paramètre AvantPlan. Elle se substitue au noir quand le pinceau 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 pinceau 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 pinceau n'est pas continu.

Le résultat est le nouveau pinceau.

Le nom du pinceau 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. */
...
P1=F.AjouterPinceau("MonPinceau1", PinceauTiret, 1.0, P.CouleurRouge, P.CouleurVert);
/* Ajoute un nouveau pinceau alternant des tirets rouges et verts. Il est épais d'un point. */
...
P2=F.AjouterPinceau("MonPinceau2", PinceauPersonnalise, 3.0, P.CouleurBleu, P.CouleurJaune);
/* Ajoute un nouveau pinceau personnalisé bleu sur fond jaune. Il est épais de trois points. */
P2.Personnaliser("${UPS_HOME}/demo/resources/monpinceau2.upl");
/* Personnalise le pinceau. */
...
Fin Principal

Voir aussi

ListerPinceaux pour lister les pinceaux.

Traduction

---------