ID2D1PathGeometry：：Open 方法 (d2d1.h)

擷取用來以圖形和區段填入路徑幾何的幾何接收。

語法

HRESULT Open(
  [out] ID2D1GeometrySink **geometrySink
);

參數

[out] geometrySink

類型： ID2D1GeometrySink**

當這個方法傳回時， geometrySink 會包含用來填入圖形和區段之路徑幾何接收指標的位址。 這個參數會以未初始化的狀態傳遞。

傳回值

類型： 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);
    }
}

規格需求

最低支援的用戶端	適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	d2d1.h
程式庫	D2d1.lib
Dll	D2d1.dll

另請參閱

ID2D1PathGeometry