PathFigure 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, IPathFigure
public sealed class PathFigure : DependencyObject, IPathFigure
Public NotInheritable Class PathFigure Inherits DependencyObject Implements IPathFigure
var pathFigure = new pathFigure();
<PathFigure .../>
-or-
<PathFigure ...>
  oneOrMorePathSegments
</PathFigure
Inheritance
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

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>

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.

Constructors

PathFigure() PathFigure() PathFigure() PathFigure()

Initializes a new instance of the PathFigure class.

public : PathFigure()
public PathFigure()
Public Sub New()
var pathFigure = new pathFigure();

Properties

IsClosed IsClosed IsClosed IsClosed

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

public : Platform::Boolean IsClosed { get; set; }
public bool IsClosed { get; set; }
Public ReadWrite Property IsClosed As bool
var bool = pathFigure.isClosed;
pathFigure.isClosed = bool;
<PathFigure IsClosed="bool"/>
Value
Platform::Boolean 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 DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Media.PathFigure.isClosedProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the IsClosed dependency property.

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 : Platform::Boolean IsFilled { get; set; }
public bool IsFilled { get; set; }
Public ReadWrite Property IsFilled As bool
var bool = pathFigure.isFilled;
pathFigure.isFilled = bool;
<PathFigure IsFilled="bool"/>
Value
Platform::Boolean 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 DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Media.PathFigure.isFilledProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the IsFilled dependency property.

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 PathSegmentCollection
var pathSegmentCollection = pathFigure.segments;
pathFigure.segments = pathSegmentCollection;
<PathFigure>
  oneOrMorePathSegments
</PathFigure>
Value
PathSegmentCollection PathSegmentCollection PathSegmentCollection PathSegmentCollection

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

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 DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Media.PathFigure.segmentsProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the Segments dependency property.

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 Point
var point = pathFigure.startPoint;
pathFigure.startPoint = point;
<PathFigure StartPoint="x,y"/>
Value
Point Point Point Point

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

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 DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Media.PathFigure.startPointProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the StartPoint dependency property.

Dispatcher Dispatcher Dispatcher Dispatcher

Inherited from DependencyObject

Methods

ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Inherited from DependencyObject

GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty)

Inherited from DependencyObject

GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Inherited from DependencyObject

ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Inherited from DependencyObject

RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback)

Inherited from DependencyObject

SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object)

Inherited from DependencyObject

UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64)

Inherited from DependencyObject

See Also