StreamGeometryContext.PolyLineTo(IList<Point>, Boolean, Boolean) 方法

定義

命名空間:

System.Windows.Media

組件:

PresentationCore.dll

繪製一個或多個連接的直線。

public:
 abstract void PolyLineTo(System::Collections::Generic::IList<System::Windows::Point> ^ points, bool isStroked, bool isSmoothJoin);

public abstract void PolyLineTo (System.Collections.Generic.IList<System.Windows.Point> points, bool isStroked, bool isSmoothJoin);

abstract member PolyLineTo : System.Collections.Generic.IList<System.Windows.Point> * bool * bool -> unit

Public MustOverride Sub PolyLineTo (points As IList(Of Point), isStroked As Boolean, isSmoothJoin As Boolean)

參數

points

IList<Point>

點集合，指定一個或多個連接的貝茲曲線的目的點。

isStroked

Boolean

使用 Pen 轉譯區段，將區段劃上底線時，則為 true，否則為 false。

isSmoothJoin

Boolean

使用 Pen 畫底線時，將這個區段和前一個區段之間的這個聯結視為邊角，則為 true，否則為 false。

例外狀況

InvalidOperationException

嘗試加入區段，而不需呼叫 BeginFigure(Point, Boolean, Boolean) 方法來啟動圖表。

範例

下列範例示範如何使用 方法來繪製三角形 PolyLineTo 。

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 StreamGeometryPolyLineToExample : Page
    {
        public StreamGeometryPolyLineToExample()
        {
            // 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();

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

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

                // Two Points are added to the collection. The PolyLineTo method will draw lines
                // between the Points of the collection.
                pointList.Add(new Point(100, 100));
                pointList.Add(new Point(100, 50));

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

            // Freeze the geometry (make it unmodifiable)
            // for additional performance benefits.
            geometry.Freeze();
            
            // specify the shape (triangle) 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 StreamGeometryPolyLineToExample
        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()

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

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

                ' Two Points are added to the collection. The PolyLineTo method will draw lines
                ' between the Points of the collection.
                pointList.Add(New Point(100, 100))
                pointList.Add(New Point(100, 50))

                ' Create a triangle using the collection of Point Structures.
                ctx.PolyLineTo(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 (triangle) 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

備註

這個方法會使用上一個區段的終點做為其起點。 如果這是圖中的第一個區段，它會使用 方法所 BeginFigure 指定的點做為其起點。

StreamGeometry如果包含 Transform 或任何非筆劃或未填滿的線段，則無法序列化 。

另請參閱

• LineTo(Point, Boolean, Boolean)