Path.Data Property

Definition

Namespace:

System.Windows.Shapes

Assembly:

PresentationFramework.dll

Gets or sets a Geometry that specifies the shape to be drawn.

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

public System.Windows.Media.Geometry Data { get; set; }

member this.Data : System.Windows.Media.Geometry with get, set

Public Property Data As Geometry

Property Value

Geometry

A description of the shape to be drawn.

Examples

The following example shows how to create a Path element and set the Data property by using code.

//Add the Path Element
myPath = gcnew Path();
myPath->Stroke = Brushes::Black;
myPath->Fill = Brushes::MediumSlateBlue;
myPath->StrokeThickness = 4;
myPath->HorizontalAlignment = HorizontalAlignment::Left;
myPath->VerticalAlignment = VerticalAlignment::Center;
EllipseGeometry^ myEllipseGeometry = gcnew EllipseGeometry();
myEllipseGeometry->Center = Point(50, 50);
myEllipseGeometry->RadiusX = 25;
myEllipseGeometry->RadiusY = 25;
myPath->Data = myEllipseGeometry;
myGrid->Children->Add(myPath);

//Add the Path Element
myPath = new Path();
myPath.Stroke = System.Windows.Media.Brushes.Black;
myPath.Fill = System.Windows.Media.Brushes.MediumSlateBlue;
myPath.StrokeThickness = 4;
myPath.HorizontalAlignment = HorizontalAlignment.Left;
myPath.VerticalAlignment = VerticalAlignment.Center;
EllipseGeometry myEllipseGeometry = new EllipseGeometry();
myEllipseGeometry.Center = new System.Windows.Point(50,50);
myEllipseGeometry.RadiusX = 25;
myEllipseGeometry.RadiusY = 25;
myPath.Data = myEllipseGeometry;
myGrid.Children.Add(myPath);

' Add a Path Element
Dim myPath As New Path()
myPath.Stroke = Brushes.Black
myPath.Fill = Brushes.MediumSlateBlue
myPath.StrokeThickness = 4
myPath.HorizontalAlignment = HorizontalAlignment.Left
myPath.VerticalAlignment = VerticalAlignment.Center
Dim myEllipseGeometry As New EllipseGeometry()
myEllipseGeometry.Center = New System.Windows.Point(50, 50)
myEllipseGeometry.RadiusX = 25
myEllipseGeometry.RadiusY = 25
myPath.Data = myEllipseGeometry
myGrid.Children.Add(myPath)

Remarks

To draw simple shapes, use the EllipseGeometry, LineGeometry, and RectangleGeometry objects. To draw curves, arcs, or complex shapes, use the PathGeometry object. To create a composite geometry, use a GeometryGroup. To combine geometries, use a CombinedGeometry.

XAML Property Element Usage

<Path>  
  <Path.Data>  
    singleGeometry  
  </Path.Data>  
</Path>  

XAML Attribute Usage

<object Data="moveAndDrawCommands"/>  

XAML Values

singleGeometry
A single object element that derives from Geometry. This can be one of the following:

• One of the simple geometries EllipseGeometry, LineGeometry, or RectangleGeometry.

• A single GeometryGroup, which supports other geometries as child elements. See XAML Values section for GeometryGroup.

• A PathGeometry, which supports child object elements that establish a path geometry object model of figures and segments. See XAML Values section for PathGeometry.

moveAndDrawCommands
One or more move and draw commands. For the complete syntax, see Path Markup Syntax.

Dependency Property Information

Identifier field	DataProperty
Metadata properties set to true	AffectsRender, AffectsMeasure