GdipCreatePen1()

Resultat.i = GdipCreatePen1(color.l, width.f, unit.i, *pen)

color.l

[in] Couleur ARGB du pen.

width.f

[in] Largeur du pen exprimé dans l'unité définie par le paramètre unit.l.

unit.i

[in] Élément de l'énumération Unit qui défini l'unité utilisée pour la largeur du pen.

*pen

[out] *pen recevra l'objet Pen créé.

Cette fonction crée un objet pen de couleur color.l permettant de dessiner des lignes et courbes. La largeur du trait est définie par width.f et unit.l.

La largeur width.f doit être un nombre positif. Si width.f est inférieur ou égal à 0, la largeur du pen sera fixé à 1.

Le paramètre unit.l peut valoir une des valeurs suivante (énumération unit) :

#UnitWorld

Les coordonnées sont exprimées en " World coordinate" qui est une unité de mesure non physique. La mesure n'est pas liée au monde physique (affichage, impression etc.) mais a un sens au par rapport à l'application qui l'utilise. Elle est aussi appelée unité universelle.

#UnitDisplay

Spécifie une unité de mesure d'affichage. Par exemple, si le dispositif d'affichage est un moniteur, alors l'unité vaut 1 pixel.
Uniquement pour les transformations de page.

#UnitPixel

Spécifie le pixel de périphérique comme unité de mesure. Chaque unité vaut 1 pixel.

#UnitPoint

Spécifie une unité de mesure égale au point d'imprimante (1/72ème de pouce = 1/72 inch).

#UnitInch

Spécifie le pouce comme unité de mesure. Chaque unité vaut 1 pouce (=inch).

#UnitDocument

Spécifie une unité de mesure égale à l'unité du document. Chaque unité vaut 1/300ème de pouce = 1/300 inch).

#UnitMillimeter

Spécifie le millimètre comme unité de mesure. Chaque unité vaut 1 millimètre.

Les couleurs passées en paramètre au Pen doivent avoir été préalablement modifiées par la procédure ARGB (voir le fichier gdiplus.pbi)

Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status.
Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.

PureBasic v4.30 bêta 4 (Windows - x86)
Testé avec Windows Vista édition familiale Premium