Path.Data Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml.Shapes

Ruft eine Geometry ab, die die zu zeichnende Form angibt, oder legt diese fest.

public:
 property Geometry ^ Data { Geometry ^ get(); void set(Geometry ^ value); };

Geometry Data();

void Data(Geometry value);

public Geometry Data { get; set; }

var geometry = path.data;
path.data = geometry;

Public Property Data As Geometry

<Path>
  <Path.Data>
    singleGeometry
  </Path.Data>
</Path>
- or -
<Path Data="moveAndDrawCommands"/>

Eigenschaftswert

Geometry

Eine Beschreibung der zu zeichnenden Form.

Beispiele

Im folgenden Beispiel wird ein Pfad verwendet, um eine Ellipse zu zeichnen.

<Canvas> 
  <Path Fill="Gold" Stroke="Black" StrokeThickness="1">
    <Path.Data>
      <EllipseGeometry Center="50,50" RadiusX="50" RadiusY="50" />
    </Path.Data>
  </Path> 
</Canvas>

In XAML können Sie auch die Syntax von Befehlen verschieben und zeichnen als Wert für die Data-Eigenschaft verwenden. In diesem Beispiel wird diese Syntax verwendet, um die Form eines Pfads anzugeben.

<Canvas>
  <Path Stroke="DarkGoldenRod" StrokeThickness="3"
    Data="M 100,200 C 100,25 400,350 400,175 H 280"/>
</Canvas>

Die Data-Attributzeichenfolge beginnt mit dem befehl move to , der durch "M" angegeben wird, der einen Startpunkt für den Pfad im Koordinatensystem des Canvas-Bereichs festlegt. Bei Zeichenfolgen in der Syntax der Befehle Verschieben und Zeichnen wird die Groß-/Kleinschreibung beachtet und bestimmt, ob Befehle relative (Offset) oder absolute Koordinaten verwenden. Das erste Segment ist eine kubische Bézierkurve, die bei (100,200) beginnt und bei (400,175) endet. Sie wird mit zwei Kontrollpunkten bei (100,25) und (400,350) gezeichnet.

Das zweite Segment beginnt mit einer absoluten horizontalen Linie zum Befehl "H", der eine Linie angibt, die vom Endpunkt des vorherigen Unterpfads (400.175) zu einem neuen Endpunkt (280.175) gezeichnet wird. Da es sich um eine horizontale Zeile zum Befehl handelt, ist der angegebene Wert eine x-Koordinate.

Weitere Informationen

• Syntax für die Verschieben- und Zeichnen-Befehle