ID2D1PathGeometry：：Open 方法 (d2d1.h)

检索用于用图形和段填充路径几何的几何接收器。

语法

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

参数

[out] geometrySink

类型： ID2D1GeometrySink**

此方法返回时， geometrySink 包含指向用于用图形和段填充路径几何图形的 geometry 接收器的指针的地址。 此参数未经初始化即被传递。

返回值

类型： 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 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台	Windows
标头	d2d1.h
Library	D2d1.lib
DLL	D2d1.dll

另请参阅

ID2D1PathGeometry