Cairo.Dash (gb.cairo)
Retourne ou définit le motif de pointillé utilisé par
Cairo.Stroke.
Un motif de pointillé est spécifié par
dashes, un tableau de valeurs positives. Chaque valeur fixe la longueur des portions alternativement "on" et "off" du trait.
-
Si le nombre de dashes est 0 le pointillé est désactivé.
-
Si le nombre de dashes est 1 un motif symétrique est appliqué avec des portions alternées on et off de la taille spécifiée par valeur entier simple dans dashes.
-
Si une valeur quelconque dans dashes est négative, ou si toutes les valeurs sont 0, Cairo sera mis en erreur avec un status Cairo.StatusInvalidDash.
Chaque segment "on" aura des extrémités comme si le segment était un sous tracé séparé. En particulier, il est valide d’utiliser une longueur "on" de 0.0 avec
Cairo.LineCapRound ou
Cairo.LineCapSquare pour répartir des points ou des carrés le long d’un tracé.
Les valeurs de longueur sont en unités espace utilisateur comme elles sont évaluées au moment du tracé. Ce n’est pas nécessairement les mêmes que celles de l’espace utilisateur lors de la définition de la propriété.
Voir aussi