PathFigure PathFigure PathFigure Class

Definition

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

public sealed class PathFigure : DependencyObject, IPathFigurepublic sealed class PathFigure : DependencyObject, IPathFigurePublic NotInheritable Class PathFigure Inherits DependencyObject Implements IPathFigure
<PathFigure .../>
-or-
<PathFigure ...>
  oneOrMorePathSegments
</PathFigure
Inheritance
PathFigurePathFigurePathFigure
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Inherited Members

Inherited methods

Inherited properties

Remarks

PathFigureCollection is a strongly typed collection for PathFigure items. PathFigureCollection is the type used by the PathGeometry.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

PathFigure() PathFigure() PathFigure()

Initializes a new instance of the PathFigure class.

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

Properties

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 bool
<PathFigure IsClosed="bool"/>
Value
bool bool bool

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

Attributes

IsClosedProperty IsClosedProperty IsClosedProperty

Identifies the IsClosed dependency property.

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

The identifier for the IsClosed dependency property.

Attributes

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 bool
<PathFigure IsFilled="bool"/>
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.

Attributes

IsFilledProperty IsFilledProperty IsFilledProperty

Identifies the IsFilled dependency property.

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

The identifier for the IsFilled dependency property.

Attributes

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 PathSegmentCollection
<PathFigure>
  oneOrMorePathSegments
</PathFigure>
Value
PathSegmentCollection PathSegmentCollection PathSegmentCollection

The collection of segments that define the shape of this PathFigure object. The default is an empty collection.

Attributes

SegmentsProperty SegmentsProperty SegmentsProperty

Identifies the Segments dependency property.

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

The identifier for the Segments dependency property.

Attributes

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 Point
<PathFigure StartPoint="x,y"/>
Value
Point Point Point

The Point where the PathFigure begins. The default is a Point with value 0,0.

Attributes

StartPointProperty StartPointProperty StartPointProperty

Identifies the StartPoint dependency property.

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

The identifier for the StartPoint dependency property.

Attributes

See Also