struktur D2D1_HWND_RENDER_TARGET_PROPERTIES (d2d1.h)

Artikel
08/22/2023

Berisi opsi HWND, ukuran piksel, dan presentasi untuk ID2D1HwndRenderTarget.

Sintaks

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

Anggota

hwnd

Jenis: HWND

HWND tempat target render mengeluarkan output dari perintah gambarnya.

pixelSize

Jenis: D2D1_SIZE_U

Ukuran target render, dalam piksel.

presentOptions

Jenis: D2D1_PRESENT_OPTIONS

Nilai yang menentukan apakah target render mempertahankan bingkai setelah disajikan dan apakah target render menunggu perangkat di-refresh sebelum menyajikan.

Keterangan

Gunakan struktur ini saat Anda memanggil metode CreateHwndRenderTarget untuk membuat ID2D1HwndRenderTarget baru.

Untuk kenyamanan, Direct2D menyediakan fungsi D2D1::HwndRenderTargetProperties untuk membuat struktur D2D1_HWND_RENDER_TARGET_PROPERTIES baru.

Contoh

Contoh berikut menggunakan metode CreateHwndRenderTarget untuk membuat ID2D1HwndRenderTarget. Ini menggunakan fungsi pembantu D2D1::HwndRenderTargetProperties untuk membuat struktur D2D1_HWND_RENDER_TARGET_PROPERTIES yang berisi handel ke jendela dan ukuran area gambar. Karena nilai D2D1_PRESENT_OPTIONS tidak ditentukan, fungsi menggunakan nilai default, 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
    );

Kode telah dihilangkan dari contoh ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Header	d2d1.h

Lihat juga

ID2D1HwndRenderTarget