PrintWindow-Funktion (winuser.h)

Die PrintWindow-Funktion kopiert ein visuelles Fenster in den angegebenen Gerätekontext (DC), in der Regel ein Drucker-DC.

Syntax

BOOL PrintWindow(
  HWND hwnd,
  HDC  hdcBlt,
  UINT nFlags
);

Parameter

hwnd

Ein Handle für das Fenster, das kopiert wird.

hdcBlt

Ein Handle für den Gerätekontext.

nFlags

Die Zeichnungsoptionen. Dieses Argument einen der folgenden Werte annehmen.

Wert	Bedeutung
PW_CLIENTONLY	Nur der Clientbereich des Fensters wird in hdcBlt kopiert. Standardmäßig wird das gesamte Fenster kopiert.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie einen Wert ohne Zero zurück.

Wenn die Funktion fehlschlägt, gibt sie null zurück.

Hinweise

Hinweis Dies ist eine blockierende oder synchrone Funktion und wird möglicherweise nicht sofort zurückgegeben. Wie schnell diese Funktion zurückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckserverkonfiguration und Druckertreiberimplementierung ab – Faktoren, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Wenn Sie diese Funktion über einen Thread aufrufen, der die Interaktion mit der Benutzeroberfläche verwaltet, kann die Anwendung nicht reagieren.

 

Die Anwendung, die das Fenster besitzt, auf das von hWnd verwiesen wird, verarbeitet den PrintWindow-Aufruf und rendert das Bild im Gerätekontext, auf den von hdcBlt verwiesen wird. Die Anwendung empfängt eine WM_PRINT Nachricht oder, wenn das PW_PRINTCLIENT-Flag angegeben ist, eine WM_PRINTCLIENT Nachricht. Weitere Informationen finden Sie unter WM_PRINT und WM_PRINTCLIENT.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-draw-l1-1-2 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

Malen und Zeichnen von Nachrichten

Übersicht über Malerei und Zeichnung

WM_PRINT

WM_PRINTCLIENT