D2D1_HWND_RENDER_TARGET_PROPERTIES 结构 (d2d1.h)

  • 项目

包含 ID2D1HwndRenderTarget 的 HWND、像素大小和演示选项。

语法

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

另请参阅

ID2D1HwndRenderTarget