Bezeichnung
ccontext:SetDash -- Legt das Strichmuster fest
Übersicht
ccontext:SetDash(offset[, dash1, ...])
Beschreibung
Legt das Strichmuster fest, das von ccontext:Stroke() verwendet werden soll. Ein Strichmuster wird durch eine Reihe positiver Strichwerte angegeben, beginnend mit dash1. Jeder Wert gibt die Länge der abwechselnden "Ein"- und "Aus"-Abschnitte des Strichmusters an. Der offset gibt einen Versatz im Muster an, bei dem der Strich beginnt.

Auf jedes "Ein"-Segment werden Obergrenzen angewendet, als wäre das Segment ein separater Unterpfad. Insbesondere ist es gültig, eine "Ein"-Länge von 0,0 mit #CAIRO_LINE_CAP_ROUND oder #CAIRO_LINE_CAP_SQUARE zu verwenden, um Punkte oder Quadrate entlang eines Pfads zu verteilen.

Hinweis: Die Längenwerte sind in Benutzerbereicheinheiten angegeben, die zum Zeitpunkt des Zeichnens ausgewertet wurden. Dies ist nicht unbedingt derselbe wie der Benutzerbereich zum Zeitpunkt von ccontext:SetDash().

Wenn Sie die optionalen Argumente dash1 usw. weglassen, ist die Strichelung deaktiviert.

Wenn Sie nur einen einzelnen Strichmusterwert übergeben, wird ein symmetrisches Muster mit abwechselnd ein- und ausgeschalteten Teilen der Größe angenommen, die durch den einzelnen Wert in dash1 angegeben wird.

Wenn ein Strichmusterwert negativ ist oder alle Werte 0 sind, wird der Cairo-Kontext in einen Fehlerzustand mit dem Status #CAIRO_STATUS_INVALID_DASH versetzt.

Eingaben
offset
ein Versatz im Strichmuster, bei dem der Strich beginnen soll
dash1
Optional: Wert für den ersten Strichmusterabschnitt (im Abschnitt).
...
Optional: Weitere Werte, die abwechselnde Längen der Ein- und Aus-Strichmusterabschnitte angeben

Navigation zeigen