ID2D1SimplifiedGeometrySink::Close メソッド (d2d1.h)

ジオメトリ シンクを閉じ、エラー状態であるかどうかを示し、シンクのエラー状態をリセットします。

構文

HRESULT Close();

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 それ以外の場合は、 HRESULT エラー コードが返されます。

注釈

図形の進行中は、ジオメトリ シンクを閉じないでください。これにより、ジオメトリ シンクがエラー状態になります。 閉じる操作を成功させるには、 BeginFigure の呼び出しごとに 1 つの EndFigure 呼び出しが必要です。

このメソッドを呼び出すと、ジオメトリ シンクが使用できなくなる可能性があります。 このインターフェイスの Direct2D 実装では、閉じた後にジオメトリ シンクを変更することはできませんが、他の実装ではこの制限が適用されない場合があります。

例

次の例では、 ID2D1PathGeometry を作成し、シンクを取得し、それを使用して砂時計の図形を定義します。

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);
    }
}

要件

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	d2d1.h
Library	D2d1.lib
[DLL]	D2d1.dll

こちらもご覧ください

ID2D1SimplifiedGeometrySink