GdipSetCustomLineCapWidthScale()

Resultat.i = GdipSetCustomLineCapWidthScale(*customCap, widthScale.f)

*customCap

[in] Pointeur sur un objet CustomLineCap.

widthScale.f

[in] Facteur d'échelle associé au pen du CustomLineCap.

Cette fonction permet de définir la manière de représenter l'objet CustomLineCap par rapport à la largeur de l'objet Pen utilisé pour dessiner cet embout personnalisé.
widthScale spécifie une valeur qui sera multipliée par la largeur du Pen. Ce produit sera utilisé pour dimensionner la hauteur et largeur de l'embout dessiné.

Si widthScale vaut 1.0, la fonction n'a pas d'effet.
Si l'embout personnalisée est un embout prédéfini AdjustableArrowCap avec l'option isFilled à #True (l'embout de la flèche est rempli), les valeurs de widthScale inférieures ou égales à 1 ne modifient pas la taille de l'embout.

Par exemple, pour un embout qui est un segment de droite :

si widthScale vaut 1, la largeur de l'embout personnalisé vaut 5, sa hauteur vaut 10 et le pen a une largeur de 3 pixels.

La largeur de la ligne de l'embout réellement dessinée sera de : 5 x 1 = 5 pixels
La hauteur de la ligne de l'embout réellement dessinée sera de : 10 x 1 = 10 pixels

Si widthScale vaut 3, la largeur sera de 15 pixels et la hauteur de 30 pixels.