ID2D1SimplifiedGeometrySink::EndFigure-Methode (d2d1.h)

Artikel
08/22/2023

Beendet die aktuelle Abbildung; schließt sie optional.

Syntax

void EndFigure(
  D2D1_FIGURE_END figureEnd
);

Parameter

figureEnd

Typ: D2D1_FIGURE_END

Ein Wert, der angibt, ob die aktuelle Abbildung geschlossen ist. Wenn die Abbildung geschlossen ist, wird eine Linie zwischen dem aktuellen Punkt und dem von BeginFigure angegebenen Startpunkt gezeichnet.

Rückgabewert

Keine

Bemerkungen

Beim Aufrufen dieser Methode ohne einen entsprechenden Aufruf von BeginFigure wird die Geometriesenke in einen Fehlerzustand versetzt. Nachfolgende Aufrufe werden ignoriert, und der Gesamtfehler wird zurückgegeben, wenn die Close-Methode aufgerufen wird.

Beispiele

Im folgenden Beispiel wird eine ID2D1PathGeometry erstellt, eine Senke abgerufen, zum Definieren einer Sanduhrform verwendet und dann EndFigure mit dem D2D1_FIGURE_END_CLOSED-Wert aufgerufen, um die Erstellung der Sanduhr zu beenden. Das vollständige Beispiel finden Sie unter Zeichnen und Füllen einer komplexen Form.

ID2D1GeometrySink *pSink = NULL;

// Create a path geometry.
if (SUCCEEDED(hr))
{
    hr = m_pD2DFactory->CreatePathGeometry(&m_pPathGeometry);

    if (SUCCEEDED(hr))
    {
        // Write to the path geometry using the geometry sink.
        hr = m_pPathGeometry->Open(&pSink);

        if (SUCCEEDED(hr))
        {
            pSink->BeginFigure(
                D2D1::Point2F(0, 0),
                D2D1_FIGURE_BEGIN_FILLED
                );

            pSink->AddLine(D2D1::Point2F(200, 0));

            pSink->AddBezier(
                D2D1::BezierSegment(
                    D2D1::Point2F(150, 50),
                    D2D1::Point2F(150, 150),
                    D2D1::Point2F(200, 200))
                );

            pSink->AddLine(D2D1::Point2F(0, 200));

            pSink->AddBezier(
                D2D1::BezierSegment(
                    D2D1::Point2F(50, 150),
                    D2D1::Point2F(50, 50),
                    D2D1::Point2F(0, 0))
                );

            pSink->EndFigure(D2D1_FIGURE_END_CLOSED);

            hr = pSink->Close();
        }
        SafeRelease(&pSink);
    }
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1.h
Bibliothek	D2d1.lib
DLL	D2d1.dll

Weitere Informationen

ID2D1SimplifiedGeometrySink

Freigeben über