D2D1_HWND_RENDER_TARGET_PROPERTIES-Struktur (d2d1.h)
Enthält die Optionen HWND, Pixelgröße und Präsentation für ein ID2D1HwndRenderTarget.
Syntax
typedef struct D2D1_HWND_RENDER_TARGET_PROPERTIES {
HWND hwnd;
D2D1_SIZE_U pixelSize;
D2D1_PRESENT_OPTIONS presentOptions;
} D2D1_HWND_RENDER_TARGET_PROPERTIES;
Member
hwnd
Typ: HWND
Der HWND, für den das Renderziel die Ausgabe seiner Zeichnungsbefehle ausgibt.
pixelSize
Typ: D2D1_SIZE_U
Die Größe des Renderziels in Pixel.
presentOptions
Typ: D2D1_PRESENT_OPTIONS
Ein -Wert, der angibt, ob das Renderziel den Frame nach der Präsentation beibehält und ob das Renderziel vor der Präsentation auf die Aktualisierung des Geräts wartet.
Hinweise
Verwenden Sie diese Struktur, wenn Sie die CreateHwndRenderTarget-Methode aufrufen, um ein neues ID2D1HwndRenderTarget-Objekt zu erstellen.
Der Einfachheit halber stellt Direct2D die D2D1::HwndRenderTargetProperties-Funktion zum Erstellen neuer D2D1_HWND_RENDER_TARGET_PROPERTIES-Strukturen bereit.
Beispiele
Im folgenden Beispiel wird die CreateHwndRenderTarget-Methode verwendet, um eine ID2D1HwndRenderTarget-Methode zu erstellen. Es verwendet die Hilfsfunktion D2D1::HwndRenderTargetProperties , um eine D2D1_HWND_RENDER_TARGET_PROPERTIES-Struktur zu erstellen, die ein Handle für ein Fenster und die Größe des Zeichenbereichs enthält. Da kein D2D1_PRESENT_OPTIONS Wert angegeben wird, verwendet die Funktion den Standardwert , 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
);
Code wurde aus diesem Beispiel weggelassen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Kopfzeile | d2d1.h |