ID2D1DCRenderTarget::BindDC-Methode (d2d1.h)

Bindet das Renderziel an den Gerätekontext, an den Zeichnungsbefehle ausgibt.

Syntax

HRESULT BindDC(
       const HDC  hDC,
  [in] const RECT *pSubRect
);

Parameter

hDC

Typ: const HDC

Der Gerätekontext, für den das Renderziel Zeichnungsbefehle ausgibt.

[in] pSubRect

Typ: const RECT*

Die Dimensionen des Handles an einen Gerätekontext (HDC), an den das Renderziel gebunden ist.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Bevor Sie mit dem DC-Renderziel rendern können, müssen Sie dessen BindDC-Methode verwenden, um es einem GDI-DC zuzuordnen. Dies geschieht jedes Mal, wenn Sie einen anderen DC verwenden oder die Größe des Bereichs, den Sie auf Änderungen zeichnen möchten, verwenden.

Beispiele

Im vorherigen Code ist m_pD2DFactory ein Zeiger auf eine ID2D1Factory, und m_pDCRT ist ein Zeiger auf ein ID2D1DCRenderTarget.

Im nächsten Codebeispiel wird ein DC an id2D1DCRenderTarget gebunden.

HRESULT DemoApp::OnRender(const PAINTSTRUCT &ps)
{

// Get the dimensions of the client drawing area.
GetClientRect(m_hwnd, &rc);

// Bind the DC to the DC render target.
hr = m_pDCRT->BindDC(ps.hdc, &rc);

Anforderungen

   
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]
Zielplattform Windows
Kopfzeile d2d1.h
Bibliothek D2d1.lib
DLL D2d1.dll

Weitere Informationen

Übersicht über die Direct2D- und GDI-Interoperation

ID2D1DCRenderTarget