StreamGeometryContext.PolyLineTo(IList<Point>, Boolean, Boolean) Méthode

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Dessine une ou plusieurs lignes droites connectées.

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)

Paramètres

points

IList<Point>

Collection de points qui spécifient des points de destination pour une ou plusieurs lignes droites connectées.

isStroked

Boolean

true pour rayer le segment quand un Pen est utilisé pour restituer le segment ; sinon, false.

isSmoothJoin

Boolean

true pour traiter la jointure entre ce segment et le segment précédent comme un coin lorsqu'il est rayé d'un Pen ; sinon, false.

Exceptions

InvalidOperationException

Une tentative a été effectuée pour ajouter un segment sans commencer une figure en appelant la méthode BeginFigure(Point, Boolean, Boolean).

Exemples

L’exemple suivant montre comment dessiner un triangle à l’aide de la PolyLineTo méthode .

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

Remarques

Cette méthode utilise le point de terminaison du segment précédent comme point de départ. S’il s’agit du premier segment d’une figure, il utilise le point spécifié par la BeginFigure méthode comme point de départ.

Un StreamGeometry ne peut pas être sérialisé s’il contient un ou des Transform segments non tracés ou non remplis.

Voir aussi

• LineTo(Point, Boolean, Boolean)