StreamGeometryContext.BezierTo(Point, Point, Point, Boolean, Boolean) 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 Bézierkurve zum angegebenen Punkt.

public:
 abstract void BezierTo(System::Windows::Point point1, System::Windows::Point point2, System::Windows::Point point3, bool isStroked, bool isSmoothJoin);

public abstract void BezierTo (System.Windows.Point point1, System.Windows.Point point2, System.Windows.Point point3, bool isStroked, bool isSmoothJoin);

abstract member BezierTo : System.Windows.Point * System.Windows.Point * System.Windows.Point * bool * bool -> unit

Public MustOverride Sub BezierTo (point1 As Point, point2 As Point, point3 As Point, isStroked As Boolean, isSmoothJoin As Boolean)

Parameter

point1: Point

Der erste Kontrollpunkt, mit dem die Form der Kurve angegeben wird.

point2: Point

Der zweite Kontrollpunkt, mit dem die Form der Kurve angegeben wird.

point3: Point

Der Zielpunkt für das Ende der Kurve.

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 sie mithilfe der BezierTo Methode eine Zierkurve zeichnen.

using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Shapes;

namespace SDKSample
{
    public partial class StreamGeometryBezierToExample : Page
    {
        public StreamGeometryBezierToExample()
        {

            // 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 Bezier curve using the 3 specifed points where the first two points
                // are control points and the last point is the destination point for the curve.
                ctx.BezierTo(new Point(100, 0), new Point(200,200), new Point(300,100), 
                             true /* is stroked */, false /* is smooth join */);
            }

            // Create a path to draw a geometry with.
            Path myPath = new Path();
            myPath.Stroke = Brushes.Black;
            myPath.StrokeThickness = 1;

            // 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

Namespace SDKSample
    Partial Public Class StreamGeometryBezierToExample
        Inherits Page
        Public Sub New()

            ' 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 Bezier curve using the 3 specifed points where the first two points
                ' are control points and the last point is the destination point for the curve.
                ctx.BezierTo(New Point(100, 0), New Point(200,200), New Point(300,100), True, False) ' is smooth join  -  is stroked 

            End Using

            ' Create a path to draw a geometry with.
            Dim myPath As New Path()
            myPath.Stroke = Brushes.Black
            myPath.StrokeThickness = 1

            ' 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

Eine kubische Zierkurve wird durch einen Startpunkt, einen Endpunkt und zwei Kontrollpunkte definiert. Der erste Kontrollpunkt bestimmt die Krümmung der ersten Hälfte des Segmentes, und der zweite Kontrollpunkt bestimmt die Krümmung der zweiten Hälfte des Segments.

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

Teilen über