Draws a series of connected lines and curves. The line and curve dimensions are declared through the Data property, and can be specified either with a Path-specific mini-language, or with an object model.
Namespace:
System.Windows.Shapes
Assembly:
System.Windows (in System.Windows.dll)
Visual Basic (Declaration)
Public NotInheritable Class Path _
Inherits Shape
public sealed class Path : Shape
XAML Object Element Usage
Fundamentally, a Path is a Shape. But the Path can be used to create much more complex two-dimensional graphics than the other Shapes are capable of. The Path object can draw closed or open shapes, lines, and curves. For a description of the shapes that the Path element supports, see the Data property.
A Path supports two parallel techniques for declaring its contents: as an object model using discrete geometries declared in markup or code, or as a mini-language declared in markup. The geometry object model can use the GeometryGroup as data in order to specify a composite of multiple geometries. For details, see Geometries. The mini-language is analogous to a pathing language output used in some graphics tools. For more information on using the mini-language definition format for Path in markup, see Path Markup Syntax.
Note: |
|---|
Performance Note: For best performance, avoid explicitly setting the Width and Height of a Path. Setting the Width and Height results in additional stretching, which has a performance cost. Instead, rely on the explicitly set coordinates of the Path and its contained data to control its shape and position. In effect, the Path will have a natural height/width, although those values are not reported to the object model. For more information, see Stretch. |
The following example uses a Path to draw an ellipse.
An EllipseGeometry drawn at (50,50)
<Canvas>
<Path Fill="Gold" Stroke="Black" StrokeThickness="1">
<Path.Data>
<EllipseGeometry Center="50,50" RadiusX="50" RadiusY="50" />
</Path.Data>
</Path>
</Canvas>
System..::.Object
System.Windows..::.DependencyObject
System.Windows..::.UIElement
System.Windows..::.FrameworkElement
System.Windows.Shapes..::.Shape
System.Windows.Shapes..::.Path
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.
Reference
Other Resources