StreamGeometryContext.PolyQuadraticBezierTo Methode

Referenz

Definition

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Zeichnet eine oder mehrere verbundene quadratische Bézierkurven.

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

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

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

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

Parameter

points: IList<Point>

Die Auflistung der Punkte, die Kontrollpunkte und Zielpunkte für eine oder mehrere quadratische Bézierkurven angeben. Der erste Punkt in der Liste gibt den Kontrollpunkt der Kurve an, der nächste Punkt gibt den Zielpunkt an, der nächste Punkt gibt den Kontrollpunkt der nächsten Kurve an usw. Die Liste muss eine gerade Anzahl von Punkten enthalten.

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 quadratische Kurven mithilfe der PolyQuadraticBezierTo 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 StreamGeometryPolyQuadraticBezierToExample : Page
    {
        public StreamGeometryPolyQuadraticBezierToExample()
        {
            // 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 PolyQuadraticBezierTo 
                // Method to create two quadratic Bezier curves.
                List<Point> pointList = new List<Point>();

                // First quadratic Bezier curve is specified with these two points.

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

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

                // Second quadratic Bezier curve is specified with these two points.

                // Control point for second quadratic Bezier curve.
                pointList.Add(new Point(300, 300));

                // End point for second quadratic Bezier curve.
                pointList.Add(new Point(400, 100));

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

            // Freeze the geometry (make it unmodifiable)
            // for additional performance benefits.
            geometry.Freeze();
            
            // specify the shape (quadratic Benzier 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 StreamGeometryPolyQuadraticBezierToExample
        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 PolyQuadraticBezierTo 
                ' Method to create two quadratic Bezier curves.
                Dim pointList As New List(Of Point)()

                ' First quadratic Bezier curve is specified with these two points.

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

                ' End point for first quadratic Bezier curve.
                pointList.Add(New Point(200, 200))

                ' Second quadratic Bezier curve is specified with these two points.

                ' Control point for second quadratic Bezier curve.
                pointList.Add(New Point(300, 300))

                ' End point for second quadratic Bezier curve.
                pointList.Add(New Point(400, 100))

                ' Create a Bezier curve using the collection of Point Structures.
                ctx.PolyQuadraticBezierTo(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 (quadratic Benzier 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

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