PathFigure 类

定义

命名空间:

Windows.UI.Xaml.Media

表示几何图形的一个子部分、一系列单独连接的二维几何线段。

public ref class PathFigure sealed : DependencyObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Segments")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class PathFigure final : DependencyObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Segments")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class PathFigure : DependencyObject

Public NotInheritable Class PathFigure
Inherits DependencyObject

<PathFigure .../>
-or-
<PathFigure ...>
  oneOrMorePathSegments
</PathFigure

继承

Object Platform::Object IInspectable DependencyObject PathFigure

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

此示例使用 LineSegment 创建由单个 PathFigure 组成的简单 PathGeometry，并使用 Path 元素显示它。 PathFigure 对象的 StartPoint 设置为 (10，20) 并且 LineSegment 定义为 (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>

注解

PathFigureCollection 是 PathFigure 项的强类型集合。 PathFigureCollection 是 PathGeometry.Figures 属性使用的类型。 在 XAML 中，为此属性指定一个或多个 PathFigure 元素。

此类与设置 Path 或 PathIcon 的矢量数据相关。

对于 Move 和 draw 命令语法，还可以将段和单个 PathFigure 定义为字符串中向量的一部分，而不是创建实例或对象元素。

构造函数

PathFigure()

初始化 PathFigure 类的新实例。

属性

Dispatcher	获取与此 对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
IsClosed	获取或设置一个值，该值指示此图的第一段和最后一段是否连接。
IsClosedProperty	标识 IsClosed 依赖属性。
IsFilled	获取或设置一个值，该值指示是否将此 PathFigure 的包含区域用于命中测试、呈现和剪辑。
IsFilledProperty	标识 IsFilled 依赖属性。
Segments	获取或设置段的集合，这些段定义此 PathFigure 对象的形状。
SegmentsProperty	标识 Segments 依赖属性。
StartPoint	获取或设置 PathFigure 开始的点。
StartPointProperty	标识 StartPoint 依赖属性。

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
GetValue(DependencyProperty)	从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject)
ReadLocalValue(DependencyProperty)	如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	注册一个通知函数，用于侦听此 DependencyObject 实例上特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

另请参阅

• DependencyObject
• PathGeometry
• PathSegment
• PathFigureCollection
• 基于 XAML 矢量的绘图示例
• 绘制图形
• 移动和绘制命令语法