GdipSetPenDashOffset()

Resultat.i = GdipSetPenDashOffset(*pen, offset.f)

*pen

[in] Pointeur sur un objet Pen.

offset.f

[in] Facteur le décalage par rapport à l'origine appliqué au pen en pointillé. Chaque décalage est égal au produit de l'épaisseur du pen par le facteur de décalage. Une valeur positive du facteur de décalage décale le premier tiret en avant le long du chemin (si le pen est horizontal, le décalage se fait vers la gauche) et une valeur négative décale le début du chemin en arrière (si le pen est horizontal, le décalage se fait vers la droite).

Cette fonction permet de définir le décalage appliqué à l'origine d'une ligne en pointillé.
Un pen avec des pointillés commence avec un tiret suivi d'un espace puis éventuellement un autre espace etc.
Le pen commence au début du tiret. En modifiant l'offset, on peut faire "glisser" l'origine du pen tel que décrit au paramètre offset.f.

Voici l'exemple du fichier :

On utilise un pen de 20 pixels de large de couleur noir. Sur l'image ci-dessous, il démarre à son origine normale, il n'y a pas d'offset.
Le pen comporte 4 éléments, 1 tiret, 1 espace, 1 tiret (forme carrée) et un espace, ensuite les motifs sont répétés.
Les 4 lignes rouges horizontales ont un facteur de décalage positif avec la valeur marquée après le 1er tiret.
Les 4 lignes bleues horizontales ont un facteur de décalage négatif avec la valeur marquée après le 1er ou deuxième tiret.
Chaque décalage avec les valeurs choisies vaut 20 pixels multiplié par le facteur. On voit tout de suite le glissement de l'origine, soit en avant soit en arrière.

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