共用方式為

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 Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
標頭 d2d1.h

另請參閱

ID2D1HwndRenderTarget