Syntax für die Verschieben- und Zeichnen-Befehle
Informieren Sie sich über die Verschieben- und Zeichnen-Befehle (eine Minisprache), mit denen Sie Pfadgeometrien als XAML-Attributwert angeben können. Verschieben- und Zeichnen-Befehle werden von vielen Design- und Grafiktools, die eine Vektorgrafik oder Form ausgeben können, als Serialisierungs- und Austauschformat verwendet.
Eigenschaften, die Verschieben- und Zeichnen-Befehlszeichenfolgen verwenden
Die Syntax für die Verschieben- und Zeichnen-Befehle wird von einem internen Typkonverter für XAML verwendet, der die Befehle analysiert und eine Laufzeit-Grafikdarstellung erzeugt. Diese Darstellung ist im Grunde ein fertiger Satz von Vektoren, die zur Anzeige bereit sind. Mit den Vektoren selbst sind die Darstellungsdetails noch nicht vollständig. Sie müssen weitere Werte für die Elemente festlegen. Für ein Path-Objekt benötigen Sie auch Werte für Fill, Stroke und andere Eigenschaften. Anschließend muss der Path mit der visuellen Struktur verbunden werden. Für ein PathIcon-Objekt legen Sie die Foreground-Eigenschaft fest.
Die Windows-Runtime enthält zwei Eigenschaften, die eine Zeichenfolge verwenden können, die Verschieben- und Zeichnen-Befehle darstellt: Path.Data und PathIcon.Data. Wenn Sie eine dieser Eigenschaften festlegen, indem Sie Verschieben- und Zeichnen-Befehle angeben, legen Sie dafür in der Regel einen XAML-Attributwert sowie weitere erforderliche Attribute dieses Elements fest. Ohne auf die Einzelheiten einzugehen, sieht das Ganze so aus:
<Path x:Name="Arrow" Fill="White" Height="11" Width="9.67"
Data="M4.12,0 L9.67,5.47 L4.12,10.94 L0,10.88 L5.56,5.47 L0,0.06" />
Verwenden von Verschieben- und Zeichnen-Befehlen oder einer PathGeometry-Klasse
Für Windows-Runtime-XAML erzeugen die Verschieben- und Zeichnen-Befehle eine PathGeometry-Klasse mit einem einzigen PathFigure-Objekt, das über einen Figures-Eigenschaftswert verfügt. Jeder Zeichnen-Befehl erzeugt eine von der PathSegment-Klasse abgeleitete Klasse in der Segments-Collection dieses einen PathFigure-Objekts. Der Verschieben-Befehl ändert die StartPoint-Eigenschaft. Zudem wird durch das Vorhandensein eines Schließen-Befehls IsClosed auf true festgelegt. In dieser Struktur können Sie dann wie in einem Objektmodell navigieren, wenn Sie zur Laufzeit die Data-Werte untersuchen.
Grundlegende Syntax
Hier ein Überblick der Syntax für Verschieben- und Zeichnen-Befehle:
- Beginnen Sie mit einer optionalen Füllregel. Normalerweise geben Sie diese Füllregel nur an, wenn Sie den EvenOdd-Standard nicht verwenden möchten. (EvenOdd wird später erläutert.)
- Geben Sie genau einen Verschieben-Befehl an.
- Geben Sie mindestens einen Zeichnen-Befehl an.
- Geben Sie einen Schließen-Befehl an. Sie können den Schließen-Befehl weglassen, aber dann bleibt die Figur geöffnet (das wäre ungewöhnlich).
Allgemeine Regeln für diese Syntax:
- Jeder Befehl wird durch genau einen Buchstaben dargestellt.
- Dabei kann es sich um einen Groß- oder Kleinbuchstaben handeln. Die Groß-/Kleinschreibung spielt eine Rolle. Darauf gehen wir noch ein.
- Auf jeden Befehl mit Ausnahme des Schließen-Befehls folgt normalerweise mindestens eine Zahl.
- Wenn Sie für einen Befehl mehrere Zahlen angeben, trennen Sie diese durch Komma oder Leerzeichen.
[fillRule]moveCommanddrawCommand[drawCommand*][closeCommand]
Viele der Zeichnen-Befehle verwenden Punkte, für die Sie einen x,y-Wert angeben. Immer wenn ein *Punkt-Platzhalter angezeigt wird, können Sie davon ausgehen, dass Sie zwei Dezimalwerte für den x,y-Wert eines Punkts angeben.
Leerzeichen können bei eindeutigen Ergebnissen häufig weggelassen werden. Tatsächlich können Sie alle Leerzeichen weglassen, wenn Sie Kommas als Trennzeichen für alle Zahlengruppen (Punkte und Größe) verwenden. Diese Verwendung ist zum Beispiel gültig: F1M0,58L2,56L6,60L13,51L15,53L6,64z. Typischer ist allerdings die Verwendung von Leerzeichen zwischen Befehlen, um die Übersichtlichkeit zu verbessern.
Verwenden Sie als Dezimalzeichen für Dezimalzahlen kein Komma. Die Befehlszeichenfolge wird von XAML interpretiert und berücksichtigt keine länderspezifischen Konventionen für die Zahlenformatierung, die von den Konventionen im Gebietsschema en-us abweichen.
Einzelheiten zur Syntax
Füllregel
Es gibt zwei mögliche Werte für die optionale Füllregel: F0 oder F1. (Das F wird immer großgeschrieben.) F0 ist der Standardwert. Er erzeugt das EvenOdd-Füllverhalten, sodass Sie dieses normalerweise nicht angeben. Verwenden Sie F1, um das Füllverhalten für Nonzero abzurufen. Diese Füllwerte sind an die Werte der FillRule-Aufzählung angepasst.
Befehl "Verschieben"
Gibt den Ausgangspunkt einer neuen Figur an.
| Syntax |
|---|
M startPoint - oder - mstartPoint |
| Begriff | Beschreibung |
|---|---|
| startPoint | Point Der Ausgangspunkt einer neuen Figur. |
Der Großbuchstabe M gibt an, dass startPoint eine absolute Koordinate ist. Der Kleinbuchstabe m gibt an, dass startPoint ein Offset zum vorherigen Punkt ist. Wenn kein vorheriger Punkt vorhanden ist, wird (0,0) angegeben.
Hinweis Es ist zulässig, mehrere Punkte nach dem Befehl zum Verschieben anzugeben. Es wird eine Linie zu diesen Punkten gezeichnet, als hätten Sie den Linienbefehl angegeben. Dieser Stil wird aber nicht empfohlen, verwenden Sie stattdessen den speziellen Linienbefehl.
Zeichnen von Befehlen
Ein Zeichnen-Befehl kann aus mehreren Formbefehlen bestehen: Linie, horizontale Linie, vertikale Linie, kubische Bézierkurve, quadratische Bézierkurve, glatte Bézierkurve, glatte quadratische Bézierkurve und Ellipsenbogen.
Bei allen Zeichnen-Befehlen spielt die Groß-/Kleinschreibung eine Rolle. Großbuchstaben geben absolute Koordinaten an und Kleinbuchstaben geben relative Koordinaten zum vorherigen Befehl an.
Die Kontrollpunkte für ein Segment sind relativ zum Endpunkt des vorherigen Segments. Wenn Sie nacheinander mehrere Befehle des gleichen Typs eingeben, müssen Sie die Befehle nicht doppelt eingeben. L 100,200 300,400 entspricht beispielsweise L 100,200 L 300,400.
Line-Befehl
Erstellt eine gerade Linie zwischen dem aktuellen Punkt und dem angegebenen Endpunkt. l 20 30 und L 20,30 sind Beispiele für gültige Linienbefehle. Definiert das Äquivalent eines LineGeometry-Objekts.
| Syntax |
|---|
LendPoint - oder - lendPoint |
| Begriff | BESCHREIBUNG |
|---|---|
| endPoint | Point Der Endpunkt der Linie. |
Befehl "Horizontale Zeile"
Erstellt eine horizontale Linie zwischen dem aktuellen Punkt und der angegebenen x-Koordinate. H 90 ist ein Beispiel für einen gültigen Befehl für eine horizontale Linie.
| Syntax |
|---|
H x - oder - h x |
| Begriff | BESCHREIBUNG |
|---|---|
| w | Double Die x-Koordinate des Endpunkts der Linie. |
Befehl "Vertikale Linie"
Erstellt eine vertikale Linie zwischen dem aktuellen Punkt und der angegebenen y-Koordinate. v 90 ist ein Beispiel für einen gültigen Befehl für eine vertikale Linie.
| Syntax |
|---|
V y - oder - v y |
| Begriff | Beschreibung |
|---|---|
| y | Double Die y-Koordinate des Endpunkts der Linie. |
Befehl für eine kubische Bézierkurve
Erstellt eine kubische Bézierkurve zwischen dem aktuellen Punkt und dem angegebenen Endpunkt. Dabei werden die beiden angegebenen Kontrollpunkte (controlPoint1 und controlPoint2) verwendet. C 100,200 200,400 300,200 ist ein Beispiel für einen gültigen Kurvenbefehl. Definiert das Äquivalent eines PathGeometry-Objekts mit einem BezierSegment-Objekt.
| Syntax |
|---|
C controlPoint1controlPoint2endPoint - oder - c controlPoint1controlPoint2endPoint |
| Begriff | BESCHREIBUNG |
|---|---|
| controlPoint1 | Point Der erste Kontrollpunkt der Kurve, der die beginnende Tangente der Kurve bestimmt. |
| controlPoint2 | Point Der zweite Kontrollpunkt der Kurve, der die endende Tangente der Kurve bestimmt. |
| endPoint | Point Der Punkt, bis zu dem die Kurve gezeichnet wird. |
Befehl für eine quadratische Bézierkurve
Erstellt eine quadratische Bézierkurve zwischen dem aktuellen Punkt und dem angegebenen Endpunkt. Dabei wird der angegebene Kontrollpunkt (controlPoint) verwendet. q 100,200 300,200 ist ein Beispiel für einen gültigen Befehl für eine quadratische Bézierkurve. Definiert das Äquivalent eines PathGeometry-Objekts mit einem QuadraticBezierSegment-Objekt.
| Syntax |
|---|
Q controlPoint endPoint - oder - q controlPoint endPoint |
| Begriff | BESCHREIBUNG |
|---|---|
| controlPoint | Point Der Kontrollpunkt der Kurve, der die beginnende und endende Tangente der Kurve bestimmt. |
| endPoint | Point Der Punkt, bis zu dem die Kurve gezeichnet wird. |
Befehl für eine glatte kubische Bézierkurve
Erstellt eine kubische Bézierkurve zwischen dem aktuellen Punkt und dem angegebenen Endpunkt. Der erste Kontrollpunkt soll die Reflektion des zweiten Kontrollpunkts des vorherigen Befehls relativ zum aktuellen Punkt sein. Wenn kein vorheriger Befehl vorhanden ist oder der vorherige Befehl kein Befehl für eine kubische Bézierkurve oder eine glatte kubische Bézierkurve war, können Sie annehmen, dass der erste Kontrollpunkt mit dem aktuellen Punkt deckungsgleich ist. Der zweite Kontrollpunkt – der Kontrollpunkt für das Ende der Kurve – wird mit controlPoint2 angegeben. S 100,200 200,300 ist zum Beispiel ein gültiger Befehl für eine glatte kubische Bézierkurve. Dieser Befehl definiert das Äquivalent eines PathGeometry-Objekts mit einem BezierSegment-Objekt, wobei ein vorhergehendes Kurvensegment vorhanden war.
| Syntax |
|---|
ScontrolPoint2endPoint - oder - scontrolPoint2 endPoint |
| Begriff | BESCHREIBUNG |
|---|---|
| controlPoint2 | Point Der Kontrollpunkt der Kurve, der die endende Tangente der Kurve bestimmt. |
| endPoint | Point Der Punkt, bis zu dem die Kurve gezeichnet wird. |
Befehl für eine glatte quadratische Bézierkurve
Erstellt eine quadratische Bézierkurve zwischen dem aktuellen Punkt und dem angegebenen Endpunkt. Der Kontrollpunkt soll die Reflektion des Kontrollpunkts des vorherigen Befehls relativ zum aktuellen Punkt sein. Wenn kein vorheriger Befehl vorhanden ist oder der vorherige Befehl kein Befehl für eine quadratische Bézierkurve oder eine glatte quadratische Bézierkurve war, ist der Kontrollpunkt mit dem aktuellen Punkt deckungsgleich. Dieser Befehl definiert das Äquivalent eines PathGeometry-Objekts mit einem QuadraticBezierSegment-Objekt, wobei ein vorhergehendes Kurvensegment vorhanden war.
| Syntax |
|---|
TcontrolPointendPoint - oder - tcontrolPointendPoint |
| Begriff | BESCHREIBUNG |
|---|---|
| controlPoint | Point Der Kontrollpunkt der Kurve, der die beginnende Tangente der Kurve bestimmt. |
| endPoint | Point Der Punkt, bis zu dem die Kurve gezeichnet wird. |
Befehl "Elliptischer Bogen"
Erstellt einen elliptischen Bogen zwischen dem aktuellen Punkt und dem angegebenen Endpunkt. Definiert das Äquivalent eines PathGeometry-Objekts mit einem ArcSegment-Objekt.
| Syntax |
|---|
A sizerotationAngleisLargeArcFlagsweepDirectionFlagendPoint - oder - a sizerotationAngleisLargeArcFlagsweepDirectionFlagendPoint |
| Begriff | BESCHREIBUNG |
|---|---|
| size | Size Der x-Radius und y-Radius des Bogens |
| rotationAngle | Double Die Drehung der Ellipse in Grad. |
| isLargeArcFlag | Ist auf 1 festgelegt, wenn der Winkel des Bogens 180 Grad oder größer sein soll; andernfalls auf 0 festgelegt. |
| sweepDirectionFlag | Ist auf 1 festgelegt, wenn der Bogen in einer Richtung mit positivem Winkel gezeichnet wird; andernfalls auf 0 festgelegt. |
| endPoint | Point Der Punkt, bis zu dem der Bogen gezeichnet wird. |
Befehl schließen
Beendet die aktuelle Figur und erstellt eine Linie, die den aktuellen Punkt mit dem Startpunkt der Figur verbindet. Dieser Befehl erstellt einen LineJoin (Ecke) zwischen dem letzten Segment und dem ersten Segment der Figur.
| Syntax |
|---|
Z - oder - z |
Punktsyntax
Beschreibt die x-Koordinate und y-Koordinate eines Punkts. Weitere Informationen finden Sie auch unter Point.
| Syntax |
|---|
| x,y - oder - xy |
| Begriff | Beschreibung |
|---|---|
| x | Double Die x-Koordinate des Punkts. |
| y | Double Die y-Koordinate des Punkts. |
Zusätzliche Hinweise
Anstelle eines numerischen Standardwerts können Sie auch die folgenden speziellen Werte verwenden. Bei diesen Werten wird zwischen Groß-/Kleinschreibung unterschieden.
- Infinity: repräsentiert PositiveInfinity.
- -Unendlichkeit: Stellt NegativeInfinity dar.
- NaN: repräsentiert NaN.
Anstelle von Dezimalzahlen oder Ganzzahlen können Sie die wissenschaftliche Notation verwenden. +1.e17 ist zum Beispiel ein gültiger Wert.
Designtools zum Erzeugen von Verschieben- und Zeichnen-Befehlen
Mit dem Pen-Tool und anderen Zeichentools in Blend for Microsoft Visual Studio 2015 erzeugen Sie normalerweise ein Path-Objekt mit Verschieben- und Zeichnen-Befehlen.
Möglicherweise sehen Sie vorhandene Daten für Verschieben- und Zeichnen-Befehle in einigen Steuerelementkomponenten, die in den Standardvorlagen für Steuerelemente in Windows-Runtime-XAML definiert sind. So verwenden zum Beispiel einige Steuerelemente ein PathIcon-Objekt, dessen Daten als Verschieben- und Zeichnen-Befehle definiert sind.
Für andere häufig verwendete Vektorgrafik-Designtools, die den Vektor in XAML-Form ausgeben können, sind Exporter oder Plug-Ins verfügbar. Diese erstellen gewöhnlich Path-Objekte in einem Layoutcontainer mit Verschieben- und Zeichnen-Befehlen für die Path.Data-Eigenschaft. XAML kann mehrere Path-Elemente enthalten, sodass verschiedene Pinsel angewendet werden können. Viele dieser Exporteure oder Plug-Ins wurden ursprünglich für Windows Presentation Foundation (WPF) XAML oder Silverlight geschrieben, aber die XAML-Pfadsyntax ist mit Windows-Runtime XAML identisch. In der Regel können Sie XAML-Abschnitte aus einem Exporter verwenden und direkt in eine Windows-Runtime-XAML-Seite einfügen. (Es ist aber nicht möglich, einen RadialGradientBrush-Pinsel zu verwenden, wenn dieser Bestandteil der konvertierten XAML war, da Windows-Runtime-XAML diesen Pinsel nicht unterstützt.)
Zugehörige Themen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für