struttura D2D1_HWND_RENDER_TARGET_PROPERTIES (d2d1.h)

Articolo
02/28/2024

Contiene le opzioni HWND, dimensioni pixel e presentazione per un OGGETTO ID2D1HwndRenderTarget.

Sintassi

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

Members

hwnd

Tipo: HWND

HWND a cui la destinazione di rendering rilascia l'output dai comandi di disegno.

pixelSize

Tipo: D2D1_SIZE_U

Dimensioni della destinazione di rendering, in pixel.

presentOptions

Tipo: D2D1_PRESENT_OPTIONS

Valore che specifica se la destinazione di rendering mantiene il frame dopo la presentazione e se la destinazione di rendering attende l'aggiornamento del dispositivo prima della presentazione.

Commenti

Usare questa struttura quando si chiama il metodo CreateHwndRenderTarget per creare un nuovo ID2D1HwndRenderTarget.

Per praticità, Direct2D fornisce la funzione D2D1::HwndRenderTargetProperties per la creazione di nuove strutture D2D1_HWND_RENDER_TARGET_PROPERTIES .

Esempio

Nell'esempio seguente viene utilizzato il metodo CreateHwndRenderTarget per creare un oggetto ID2D1HwndRenderTarget. Usa la funzione helper D2D1::HwndRenderTargetProperties per creare una struttura D2D1_HWND_RENDER_TARGET_PROPERTIES che contiene un handle per una finestra e le dimensioni dell'area di disegno. Poiché non viene specificato un valore D2D1_PRESENT_OPTIONS , la funzione usa il valore predefinito 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
    );

Il codice è stato omesso da questo esempio.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Intestazione	d2d1.h

Vedi anche

ID2D1HwndRenderTarget

Condividi tramite