Интерфейс 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, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	d2d1.h