Le pen avec des tirets doit avoir été défini avec la fonction GdipSetPenDashArray().
Si le pen n'est pas défini avec des tirets, la fonction n'échoue pas et les extrémités sont modifiés selon les valeurs des paramètres startCap et endCap.
startCap permet d'assigner au pen un style d'extrémité prédéfini utilisé au début des lignes.
startCap peut prendre une des valeurs de l'énumération LineCap :
Les valeurs #LineCapCustom et #LineCapAnchorMask peuvent être utilisées pour retrouver le type d'extrémité avec la commande GdipGetPenStartCap().
Aperçu des différentes extrémités :
Le trait vertical noir représente la position du premier point du pen. Certaines formes débutent au niveau du premier point, d'autres on la forme centrée sur ce point.
endCap permet d'assigner au pen, un style d'extrémité prédéfini utilisé à la fin des lignes.
endCap peut prendre une des valeurs de l'énumération LineCap :
Les valeurs #LineCapCustom et #LineCapAnchorMask seront utilisée pour retrouver le type d'extrémité avec la commande GdipGetPenEndCap().Aperçu des différentes extrémités :
Le trait vertical noir représente la position du dernier point du pen. Certaines formes se terminent au niveau du dernier point, d'autres on la forme centrée sur ce point.
dashCap permet
de donner une forme arrondie ou triangulaire aux extrémités
des tirets ou de supprimer ces formes.
dashCap peut prendre une des valeurs de l'énumération DashCap :
Aperçu :
| #DashCapFlat |  |
| #DashCapRound |  |
| #DashCapTriangle |  |
#DashCapFlat est la valeur par défaut.
Si l'alignement du pen vaut #PenAlignmentInset qui est un élément de l'énumération PenAlignment, il n'est pas possible d'avoir les extrémités triangulaires (#DashCapTriangle). L'alignement du pen est géré par la fonction GdipSetPenMode().