PathFigure PathFigure PathFigure Class

Represents a subsection of a geometry, a single connected series of two-dimensional geometric segments.

Syntax

Declaration

public sealed class PathFigurepublic sealed class PathFigurePublic NotInheritable Class PathFigure
<PathFigure .../>
-or-
<PathFigure ...>
  oneOrMorePathSegments
</PathFigure

Inheritance Hierarchy

Remarks

PathFigureCollection is a strongly typed collection for PathFigure items. PathFigureCollection is the type used by the Figures property. In XAML, specify one or more PathFigure elements for this property.

This class is relevant for setting the vector data for either a Path or a PathIcon.

Rather than creating an instance or an object element, you can also define segments and a single PathFigure as part of a vector within the string for a Move and draw commands syntax.

Examples

This example creates a simple PathGeometry made up of a single PathFigure with a LineSegment and displays it using a Path element. The PathFigure object's StartPoint is set to (10,20) and a LineSegment is defined with an end point of (100,130).

<Canvas>
    <Path Stroke="Black" StrokeThickness="4">
        <Path.Data>
            <PathGeometry>
                <PathGeometry.Figures>
                    <PathFigure StartPoint="10,20">
                        <PathFigure.Segments>
                            <LineSegment Point="100,130"/>
                        </PathFigure.Segments>
                    </PathFigure>
                </PathGeometry.Figures>
            </PathGeometry>
        </Path.Data>
    </Path>
</Canvas>
<Canvas>
    <Path Stroke="Black" StrokeThickness="4" >
        <Path.Data>
            <PathGeometry>
                <PathGeometry.Figures>
                    <PathFigure StartPoint="10,50">
                        <PathFigure.Segments>
                            <BezierSegment Point1="100,0"
                                           Point2="200,200"
                                           Point3="300,100"/>
                            <LineSegment Point="400,100" />
                            <ArcSegment Size="50,50" 
                                        RotationAngle="45"
                                        IsLargeArc="True" 
                                        SweepDirection="Clockwise"
                                        Point="200,100"/>
                        </PathFigure.Segments>
                    </PathFigure>
                </PathGeometry.Figures>
            </PathGeometry>
        </Path.Data>
    </Path>
</Canvas>

Constructors summary

Initializes a new instance of the PathFigure class.

Properties summary

Gets or sets a value that indicates whether this figure's first and last segments are connected.

Identifies the IsClosed dependency property.

Gets or sets a value that indicates whether the contained area of this PathFigure is to be used for hit-testing, rendering, and clipping.

Identifies the IsFilled dependency property.

Gets or sets the collection of segments that define the shape of this PathFigure object.

Identifies the Segments dependency property.

Gets or sets the Point where the PathFigure begins.

Identifies the StartPoint dependency property.

Constructors

  • PathFigure()
    PathFigure()
    PathFigure()
    PathFigure()

    Initializes a new instance of the PathFigure class.

    public PathFigure()public New()Public Sub New()public PathFigure()

Properties

  • IsClosed
    IsClosed
    IsClosed
    IsClosed

    Gets or sets a value that indicates whether this figure's first and last segments are connected.

    public bool IsClosed { get; set; }public bool IsClosed { get; set; }Public ReadWrite Property IsClosed As boolpublic bool IsClosed { get; set; }
    <PathFigure IsClosed="bool"/>
    

    Property Value

    • bool
      bool
      bool

      true if the first and last segments of the figure are connected; otherwise, false.

  • IsClosedProperty
    IsClosedProperty
    IsClosedProperty
    IsClosedProperty

    Identifies the IsClosed dependency property.

    public static DependencyProperty IsClosedProperty { get; }public static DependencyProperty IsClosedProperty { get; }Public Static ReadOnly Property IsClosedProperty As DependencyPropertypublic static DependencyProperty IsClosedProperty { get; }

    Property Value

  • IsFilled
    IsFilled
    IsFilled
    IsFilled

    Gets or sets a value that indicates whether the contained area of this PathFigure is to be used for hit-testing, rendering, and clipping.

    public bool IsFilled { get; set; }public bool IsFilled { get; set; }Public ReadWrite Property IsFilled As boolpublic bool IsFilled { get; set; }
    <PathFigure IsFilled="bool"/>
    

    Property Value

    • bool
      bool
      bool

      true if the contained area of this PathFigure is to be used for hit-testing, rendering, and clipping; otherwise, false. The default is true.

  • IsFilledProperty
    IsFilledProperty
    IsFilledProperty
    IsFilledProperty

    Identifies the IsFilled dependency property.

    public static DependencyProperty IsFilledProperty { get; }public static DependencyProperty IsFilledProperty { get; }Public Static ReadOnly Property IsFilledProperty As DependencyPropertypublic static DependencyProperty IsFilledProperty { get; }

    Property Value

  • Segments
    Segments
    Segments
    Segments

    Gets or sets the collection of segments that define the shape of this PathFigure object.

    public PathSegmentCollection Segments { get; set; }public PathSegmentCollection Segments { get; set; }Public ReadWrite Property Segments As PathSegmentCollectionpublic PathSegmentCollection Segments { get; set; }
    <PathFigure>
      oneOrMorePathSegments
    </PathFigure>
    

    Property Value

  • SegmentsProperty
    SegmentsProperty
    SegmentsProperty
    SegmentsProperty

    Identifies the Segments dependency property.

    public static DependencyProperty SegmentsProperty { get; }public static DependencyProperty SegmentsProperty { get; }Public Static ReadOnly Property SegmentsProperty As DependencyPropertypublic static DependencyProperty SegmentsProperty { get; }

    Property Value

  • StartPoint
    StartPoint
    StartPoint
    StartPoint

    Gets or sets the Point where the PathFigure begins.

    public Point StartPoint { get; set; }public Point StartPoint { get; set; }Public ReadWrite Property StartPoint As Pointpublic Point StartPoint { get; set; }
    <PathFigure StartPoint="x,y"/>
    

    Property Value

  • StartPointProperty
    StartPointProperty
    StartPointProperty
    StartPointProperty

    Identifies the StartPoint dependency property.

    public static DependencyProperty StartPointProperty { get; }public static DependencyProperty StartPointProperty { get; }Public Static ReadOnly Property StartPointProperty As DependencyPropertypublic static DependencyProperty StartPointProperty { get; }

    Property Value

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.ActivatableAttribute
Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.MarshalingBehaviorAttribute
Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.ThreadingAttribute
Windows.Foundation.Metadata.WebHostHiddenAttribute
Windows.UI.Xaml.Markup.ContentPropertyAttribute

Details

Assembly

Windows.UI.Xaml.Media.dll