Printer Friendly Version      Send     
Click to Rate and Give Feedback
MSDN
MSDN Library
Web Development
Silverlight
Path Class
Other versions are also available for the following:
.NET Framework Class Library for Silverlight
Path Class
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

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)
XMLNS for XAML: Not mapped to an xmlns.

Visual Basic (Declaration)
Public NotInheritable Class Path _
    Inherits Shape
Visual Basic (Usage)
Dim instance As Path
C#
public sealed class Path : Shape
Visual C++
public ref class Path sealed : public Shape
JScript
public final class Path extends Shape
XAML Object Element Usage
                    <Path .../>
                

Fundamentally, a Path is a Shape. But the Path can be used to create much more complex 2-D graphics than the other Shapes are capable of. The Path object can draw closed or open shapes, lines, and curves. See the Data property for a description of the shapes that the Path element supports.

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 (Silverlight 2). 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 (Silverlight 2).

Note:

Performance Note: For best performance, avoid explicitly setting the Width and Height of a Path. Setting the Width and Height will result 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. See Stretch.

The following example uses a Path to draw an ellipse.

An EllipseGeometry drawn at (50,50)

XAML
<Canvas> 
  
  <Path Fill="Gold" Stroke="Black" StrokeThickness="1">
    <Path.Data>
      <EllipseGeometry Center="50,50" RadiusX="50" RadiusY="50" />
    </Path.Data>
  </Path> 
</Canvas>
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
© 2008 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker