ID2D1PathGeometry

円弧、曲線、直線で構成される複合的な形状を表します。

ID2D1PathGeometry オブジェクトを使用すると、幾何学的なパスを記述できます。ID2D1PathGeometry オブジェクトのパスを記述するには、オブジェクトの Open メソッドを使用して ID2D1GeometrySink を取得します。このシンクを使用して、パスジオメトリに図形(フィギュア)とセグメントを追加します。

ID2D1PathGeometry オブジェクトの作成

ID2D1PathGeometry オブジェクトは、ID2D1Factory によって作成されるデバイス非依存のリソースです。一般に、ジオメトリは一度作成したら、アプリケーションの存続期間中、または変更が必要になるまで保持しておくべきです。デバイス非依存リソースおよびデバイス依存リソースの詳細については、リソースの概要を参照してください。

例

次の例では、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);
    }
}

パスジオメトリに図形やセグメントを追加するために使用するジオメトリシンクを取得します。

型: HRESULT

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

パスジオメトリはイミュータブル(変更不可)であり、内容を一度しか追加できないため、同じパスジオメトリに対して Open を複数回呼び出すとエラーになります。

塗りつぶしモードは既定で D2D1_FILL_MODE_ALTERNATE になる点に注意してください。塗りつぶしモードを設定するには、最初の BeginFigure 呼び出しの前に SetFillMode を呼び出します。これを怠ると、ジオメトリシンクはエラー状態になります。

例

次の例では、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);
    }
}

パスジオメトリの内容を、指定した ID2D1GeometrySink にコピーします。

型: HRESULT

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

パスジオメトリ内のセグメントの数を取得します。

型: HRESULT

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

パスジオメトリ内の図形(フィギュア)の数を取得します。

型: HRESULT

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