StreamGeometryContext.PolyBezierTo Methode

  • Referenz

Definition

Namespace:
System.Windows.Media
Assembly:
PresentationCore.dll

Zeichnet eine oder mehrere verbundene Bézierkurven.

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)

Parameter

points
IList<Point>

Die Liste der Punkte, die Kontrollpunkte und Zielpunkte für eine oder mehrere Bézierkurven angeben. Die Anzahl der Punkte in dieser Liste sollte ein Vielfaches von drei sein.

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

InvalidOperationException

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 mehrere verbundene Bezierkurven mithilfe der PolyBezierTo Methode zeichnen.

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

Hinweise

Der erste Punkt in points gibt den ersten Steuerelementpunkt an, der nächste gibt den zweiten Steuerelementpunkt an, der dritte Punkt gibt den Endpunkt an, der nächste Punkt gibt den ersten Steuerelementpunkt der nächsten Kurve an und so weiter.

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

Siehe auch