Метод ID2D1SimplifiedGeometrySink::Close (d2d1.h)

Статья
02/24/2024

Закрывает приемник геометрии, указывает, находится ли он в состоянии ошибки, и сбрасывает состояние ошибки приемника.

Синтаксис

HRESULT Close();

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Не закрывайте приемник геометрии, пока рисунок еще выполняется; При этом приемник геометрии переводится в состояние ошибки. Для успешного завершения операции должен быть один вызов EndFigure для каждого вызова BeginFigure.

После вызова этого метода приемник геометрии может оказаться недоступным для использования. Реализации Direct2D этого интерфейса не позволяют изменять приемник геометрии после его закрытия, но другие реализации могут не налагать это ограничение.

Примеры

В следующем примере создается объект 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
Библиотека	D2d1.lib
DLL	D2d1.dll

См. также раздел

ID2D1SimplifiedGeometrySink

Поделиться через