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
<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)

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()

Initializes a new instance of the PathFigure class.

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

Properties

Dispatcher Dispatcher Dispatcher

Gets the CoreDispatcher that this object is associated with. The CoreDispatcher represents a facility that can access the DependencyObject on the UI thread even if the code is initiated by a non-UI thread.

(Inherited from DependencyObject)

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

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

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.

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
<PathFigure IsFilled="bool"/>
Value
Platform::Boolean 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

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.

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.

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.

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.

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.

Methods

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

Clears the local value of a dependency property.

(Inherited from DependencyObject)

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

Returns any base value established for a dependency property, which would apply in cases where an animation is not active.

(Inherited from DependencyObject)

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

Returns the current effective value of a dependency property from a DependencyObject.

(Inherited from DependencyObject)

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

Returns the local value of a dependency property, if a local value is set.

(Inherited from DependencyObject)

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

Registers a notification function for listening to changes to a specific DependencyProperty on this DependencyObject instance.

(Inherited from DependencyObject)

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

Sets the local value of a dependency property on a DependencyObject.

(Inherited from DependencyObject)

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

Cancels a change notification that was previously registered by calling RegisterPropertyChangedCallback.

(Inherited from DependencyObject)

See Also