PureBasic & GDI+ 1.0
Pen


Les Pen sont des objets permettant de dessiner des lignes et des courbes avec une largeur et un style spécifiés. Ils peuvent être basés sur une couleur ou sur une brush.
De nombreuses fonctions permettent de modifier l'aspect des lignes dessinées par les pen.
La propriété DashStyle peut être utilisé pour dessiner plusieurs types de lignes en pointillés. Il est possible de remplir la ligne dessinée par un objet Pen avec différents styles de remplissage dont les couleurs unies et les textures.

La propriété DashCap peut être utilisé pour dessiner l'extrémité des lignes.
La propriété LineJoin peut être utilisé pour définir la jonction de lignes.
La propriété CompoundArray peut être utilisé pour définir un effet multilignes.
Lorsqu'un pen est créée, il est possible d'appliquer des transformations géométriques à l'aide matrices ou de fonctions prédéfinies.
- Les méthodes de transformation géométrique (rotation --> rotate).
- Les méthodes de mise à l'échelle (scale).
Les translations sont sans effets sur les pen.
Certaines modifications utilisent des matrices de transformation dont un paramètre permet de positionner l'ordre des modifications tel que décrit par les valeurs MatrixOrder.
Les couleurs passées en paramètre aux pen doivent avoir été préalablement modifiées par la procédure ARGB() (voir le fichier gdiplus.pbi)
Lorsque l'on retrouve une couleur avec une des commandes existantes, il faut la modifier à l'aide de la fonction ARGBEX() qui se trouve dans le fichier gdiplus.pbi
Valeur de retour:
D'une manière générale, les fonctions retournent les valeurs suivantes :
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.

Liste des commandes

GdipClonePen
GdipCreatePen1
GdipCreatePen2
GdipDeletePen
GdipGetPenBrushFill
GdipGetPenColor
GdipGetPenCompoundArray
GdipGetPenCompoundCount
GdipGetPenCustomEndCap
GdipGetPenCustomStartCap
GdipGetPenDashArray
GdipGetPenDashCap197819
GdipGetPenDashCount
GdipGetPenDashOffset
GdipGetPenDashStyle
GdipGetPenEndCap
GdipGetPenFillType
GdipGetPenLineJoin
GdipGetPenMiterLimit
GdipGetPenMode
GdipGetPenStartCap
GdipGetPenTransform
GdipGetPenUnit
GdipGetPenWidth
GdipMultiplyPenTransform
GdipResetPenTransform
GdipRotatePenTransform
GdipScalePenTransform
GdipSetPenBrushFill
GdipSetPenColor
GdipSetPenCompoundArray
GdipSetPenCustomEndCap
GdipSetPenCustomStartCap
GdipSetPenDashArray
GdipSetPenDashCap197819
GdipSetPenDashOffset
GdipSetPenDashStyle
GdipSetPenEndCap
GdipSetPenLineCap197819
GdipSetPenLineJoin
GdipSetPenMiterLimit
GdipSetPenMode
GdipSetPenStartCap
GdipSetPenTransform
GdipSetPenUnit
GdipSetPenWidth
GdipTranslatePenTransform