Skip to content

Latest commit

 

History

History
71 lines (53 loc) · 2.93 KB

path_data.md

File metadata and controls

71 lines (53 loc) · 2.93 KB
Raw
-api-id -api-type
P:Windows.UI.Xaml.Shapes.Path.Data
winrt property

Windows.UI.Xaml.Shapes.Path.Data

-description

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

-xaml-syntax

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

-xaml-values

singleGeometry
singleGeometryA 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. A PathGeometry, which supports child object elements that establish a path geometry object model of figures and segments. See the "XAML Values" section of PathGeometry.
moveAndDrawCommands
moveAndDrawCommandsThis is a complex syntax that cannot be adequately summarized here. See Move and draw commands syntax.
## -property-value A description of the shape to be drawn.

-remarks

-examples

The following example uses a Path to draw an ellipse.

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

In XAML, you can also use Move and draw commands syntax as the value for the Data property. This example uses this syntax to specify the shape of a Path.

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

The Data attribute string begins with the move to command, indicated by "M", which establishes a start point for the path in the coordinate system of the Canvas. Strings in the Move and draw commands syntax are case-sensitive and determine whether commands use relative (offset) or absolute coordinates. The first segment is a cubic Bezier curve beginning at (100,200) and ending at (400,175), drawn using the two control points (100,25) and (400,350).

The second segment begins with an absolute horizontal line to command "H", which specifies a line drawn from the preceding subpath's endpoint (400,175) to a new endpoint (280,175). Because it is a horizontal line to command, the value specified is an x-coordinate.

-see-also

Move and draw commands syntax