StreamGeometryContext.PolyLineTo(IList<Point>, Boolean, Boolean) Methode

Definition

Zeichnet eine oder mehrere verbundene Geraden.

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

Parameter

points
IList<Point>

Die Auflistung der Punkte, die Zielpunkte für eine oder mehrere verbundene Geraden angeben.

isStroked
Boolean

true, um ein Segment mit Strichen zu zeichnen, wenn ein Pen verwendet wird, andernfalls false.

isSmoothJoin
Boolean

true, um die Verbindung zwischen diesem Segment und dem vorherigen Segment als Ecke zu zeichnen, wenn mit einem Pen Striche gezeichnet werden, andernfalls false.

Ausnahmen

Es wurde versucht, ein Segment hinzuzufügen, ohne durch Aufrufen der BeginFigure(Point, Boolean, Boolean)-Methode mit einer Figur zu beginnen.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie ein Dreieck mithilfe der PolyLineTo Methode zeichnen.

C#
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;
        }
    }
}

Hinweise

Diese Methode verwendet den Endpunkt des vorherigen Segmentes als Ausgangspunkt. Wenn dies das erste Segment in einer Abbildung ist, wird der Punkt verwendet, der durch die BeginFigure Methode als Startpunkt angegeben wird.

Eine StreamGeometry Serialisierung kann nicht ausgeführt werden, wenn sie ein oder keine Transform nicht gestrichelten oder nicht ausgefüllten Segmente enthält.

Gilt für

Produkt Versionen
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7

Siehe auch