ID2D1PathGeometry 接口 (d2d1.h)

项目
08/22/2023

表示可能由弧线、曲线和线条组成的复杂形状。

继承

ID2D1PathGeometry 接口继承自 ID2D1Geometry。 ID2D1PathGeometry 还具有以下类型的成员：

方法

方法

ID2D1PathGeometry 接口具有这些方法。


ID2D1PathGeometry：：GetFigureCount 检索路径几何图形中的图形数。
ID2D1PathGeometry：：GetSegmentCount 检索路径几何中的段数。
ID2D1PathGeometry：：Open 检索用于用图形和段填充路径几何的几何接收器。
ID2D1PathGeometry：：Stream 将路径几何的内容复制到指定的 ID2D1GeometrySink。

注解

使用 ID2D1PathGeometry 对象可以描述几何路径。若要描述 ID2D1PathGeometry 对象的路径，请使用对象的 Open 方法检索 ID2D1GeometrySink。使用接收器使用图形和段填充路径几何图形。

创建 ID2D1PathGeometry 对象

若要创建路径几何图形，请使用 ID2D1Factory：：CreatePathGeometry 方法。

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

要求

要求	值
最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	d2d1.h