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

Weitere Informationen

ID2D1HwndRenderTarget