StreamGeometryContext.PolyBezierTo 方法

定义

绘制一条或多条互相连接的贝塞尔曲线。

public:
 abstract void PolyBezierTo(System::Collections::Generic::IList<System::Windows::Point> ^ points, bool isStroked, bool isSmoothJoin);
public abstract void PolyBezierTo (System.Collections.Generic.IList<System.Windows.Point> points, bool isStroked, bool isSmoothJoin);
abstract member PolyBezierTo : System.Collections.Generic.IList<System.Windows.Point> * bool * bool -> unit
Public MustOverride Sub PolyBezierTo (points As IList(Of Point), isStroked As Boolean, isSmoothJoin As Boolean)

参数

points
IList<Point>

为一条或多条贝塞尔曲线指定控制点和目标点的点列表。 此列表中的点数应为三的倍数。

isStroked
Boolean

若要在使用 Pen 呈现线段时使线段描边,则为 true;否则为 false

isSmoothJoin
Boolean

在用 Pen 描边时,如果要将此线段与前一条线段之间的联接视为角,则为 true;否则为 false

例外

试图添加一条线段,但未通过调用 BeginFigure(Point, Boolean, Boolean) 方法来指定图形的起点。

示例

以下示例演示如何使用 PolyBezierTo 方法绘制多个连接的贝塞尔曲线。

using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Shapes;
using System.Collections.Generic;

namespace SDKSample
{
    public partial class StreamGeometryPolyBezierToExample : Page
    {
        public StreamGeometryPolyBezierToExample()
        {
            // Create a path to draw a geometry with.
            Path myPath = new Path();
            myPath.Stroke = Brushes.Black;
            myPath.StrokeThickness = 1;

            // Create a StreamGeometry to use to specify myPath.
            StreamGeometry geometry = new StreamGeometry();
            geometry.FillRule = FillRule.EvenOdd;

            // Open a StreamGeometryContext that can be used to describe this StreamGeometry 
            // object's contents.
            using (StreamGeometryContext ctx = geometry.Open())
            {
                // Set the begin point of the shape.
                ctx.BeginFigure(new Point(10, 100), true /* is filled */, false /* is closed */);

                // Create a collection of Point structures that will be used with the PolyBezierTo 
                // Method to create the Bezier curve.
                List<Point> pointList = new List<Point>();

                // First Bezier curve is specified with these three points.

                // First control point for first Bezier curve.
                pointList.Add(new Point(100,0));

                // Second control point for first Bezier curve.
                pointList.Add(new Point(200, 200));

                // Destination point for first Bezier curve.
                pointList.Add(new Point(300, 100));

                // Second Bezier curve is specified with these three points.

                // First control point for second Bezier curve.
                pointList.Add(new Point(400, 0));

                // Second control point for second Bezier curve.
                pointList.Add(new Point(500, 200));

                // Destination point for second Bezier curve.
                pointList.Add(new Point(600, 100));

                // Create a Bezier curve using the collection of Point Structures.
                ctx.PolyBezierTo(pointList, true /* is stroked */, false /* is smooth join */);
            }

            // Freeze the geometry (make it unmodifiable)
            // for additional performance benefits.
            geometry.Freeze();
            
            // specify the shape (Bezier curve) of the path using the StreamGeometry.
            myPath.Data = geometry;

            // Add path shape to the UI.
            StackPanel mainPanel = new StackPanel();
            mainPanel.Children.Add(myPath);
            this.Content = mainPanel;
        }
    }
}

Imports System.Windows
Imports System.Windows.Controls
Imports System.Windows.Media
Imports System.Windows.Shapes
Imports System.Collections.Generic

Namespace SDKSample
    Partial Public Class StreamGeometryPolyBezierToExample
        Inherits Page
        Public Sub New()
            ' Create a path to draw a geometry with.
            Dim myPath As New Path()
            myPath.Stroke = Brushes.Black
            myPath.StrokeThickness = 1

            ' Create a StreamGeometry to use to specify myPath.
            Dim geometry As New StreamGeometry()
            geometry.FillRule = FillRule.EvenOdd

            ' Open a StreamGeometryContext that can be used to describe this StreamGeometry 
            ' object's contents.
            Using ctx As StreamGeometryContext = geometry.Open()
                ' Set the begin point of the shape.
                ctx.BeginFigure(New Point(10, 100), True, False) ' is closed  -  is filled 

                ' Create a collection of Point structures that will be used with the PolyBezierTo 
                ' Method to create the Bezier curve.
                Dim pointList As New List(Of Point)()

                ' First Bezier curve is specified with these three points.

                ' First control point for first Bezier curve.
                pointList.Add(New Point(100,0))

                ' Second control point for first Bezier curve.
                pointList.Add(New Point(200, 200))

                ' Destination point for first Bezier curve.
                pointList.Add(New Point(300, 100))

                ' Second Bezier curve is specified with these three points.

                ' First control point for second Bezier curve.
                pointList.Add(New Point(400, 0))

                ' Second control point for second Bezier curve.
                pointList.Add(New Point(500, 200))

                ' Destination point for second Bezier curve.
                pointList.Add(New Point(600, 100))

                ' Create a Bezier curve using the collection of Point Structures.
                ctx.PolyBezierTo(pointList, True, False) ' is smooth join  -  is stroked 

            End Using

            ' Freeze the geometry (make it unmodifiable)
            ' for additional performance benefits.
            geometry.Freeze()

            ' specify the shape (Bezier curve) of the path using the StreamGeometry.
            myPath.Data = geometry

            ' Add path shape to the UI.
            Dim mainPanel As New StackPanel()
            mainPanel.Children.Add(myPath)
            Me.Content = mainPanel
        End Sub
    End Class
End Namespace

注解

中的第一个点 points 指定第一个控制点,下一个点指定第二个控制点,第三个点指定终点,下一个点指定下一条曲线的第一个控制点,依依此。

此方法使用上一段的终结点作为起点。 如果这是图中的第一段,则使用 方法指定的 BeginFigure 点作为起点。

StreamGeometry如果 包含 Transform 或任何非笔划或未填充段,则无法序列化 。

适用于

另请参阅