структура D2D1_HWND_RENDER_TARGET_PROPERTIES (d2d1.h)

  • Статья

Содержит параметры HWND, размера пикселей и представления для ID2D1HwndRenderTarget.

Синтаксис

typedef struct D2D1_HWND_RENDER_TARGET_PROPERTIES {
  HWND                 hwnd;
  D2D1_SIZE_U          pixelSize;
  D2D1_PRESENT_OPTIONS presentOptions;
} D2D1_HWND_RENDER_TARGET_PROPERTIES;

Члены

hwnd

Тип: HWND

HWND, для которого целевой объект отрисовки выдает выходные данные из своих команд рисования.

pixelSize

Тип: D2D1_SIZE_U

Размер целевого объекта отрисовки в пикселях.

presentOptions

Тип: D2D1_PRESENT_OPTIONS

Значение типа , указывающее, сохраняет ли целевой объект отрисовки кадр после его отображения и ожидает ли целевой объект отрисовки обновления устройства перед представлением.

Комментарии

Используйте эту структуру при вызове метода CreateHwndRenderTarget для создания нового объекта ID2D1HwndRenderTarget.

Для удобства Direct2D предоставляет функцию D2D1::HwndRenderTargetProperties для создания новых структур D2D1_HWND_RENDER_TARGET_PROPERTIES .

Примеры

В следующем примере используется метод CreateHwndRenderTarget для создания ID2D1HwndRenderTarget. Она использует вспомогающую функцию D2D1::HwndRenderTargetProperties для создания структуры D2D1_HWND_RENDER_TARGET_PROPERTIES , содержащей дескриптор окна и размер области рисования. Так как значение D2D1_PRESENT_OPTIONS не указано, функция использует значение по умолчанию , D2D1_PRESENT_OPTIONS_NONE.

RECT rc;
GetClientRect(m_hwnd, &rc);

D2D1_SIZE_U size = D2D1::SizeU(
    rc.right - rc.left,
    rc.bottom - rc.top
    );

// Create a Direct2D render target.
hr = m_pD2DFactory->CreateHwndRenderTarget(
    D2D1::RenderTargetProperties(),
    D2D1::HwndRenderTargetProperties(m_hwnd, size),
    &m_pRenderTarget
    );

Код в этом примере опущен.

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Верхняя часть d2d1.h

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

ID2D1HwndRenderTarget