PrintWindow, fonction (winuser.h)

  • Article

La fonction PrintWindow copie une fenêtre visuelle dans le contexte d’appareil (DC) spécifié, généralement un contrôleur de domaine d’imprimante.

Syntaxe

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

Paramètres

hwnd

Handle de la fenêtre qui sera copiée.

hdcBlt

Handle pour le contexte de l’appareil.

nFlags

Options de dessin. Il peut avoir l’une des valeurs suivantes.

Valeur Signification
PW_CLIENTONLY
 Seule la zone cliente de la fenêtre est copiée dans hdcBlt. Par défaut, la fenêtre entière est copiée.

Valeur retournée

Si la fonction réussit, elle retourne une valeur différente de zéro.

Si la fonction échoue, elle retourne zéro.

Remarques

Note Il s’agit d’une fonction bloquante ou synchrone qui peut ne pas être retournée immédiatement. La rapidité avec laquelle cette fonction retourne dépend de facteurs d’exécution tels que l’status réseau, la configuration du serveur d’impression et l’implémentation du pilote d’imprimante, facteurs difficiles à prédire lors de l’écriture d’une application. L’appel de cette fonction à partir d’un thread qui gère l’interaction avec l’interface utilisateur peut donner l’impression que l’application ne répond pas.
 
L’application propriétaire de la fenêtre référencée par hWnd traite l’appel PrintWindow et restitue l’image dans le contexte de l’appareil référencé par hdcBlt. L’application reçoit un message WM_PRINT ou, si l’indicateur PW_PRINTCLIENT est spécifié, un message WM_PRINTCLIENT . Pour plus d’informations, consultez WM_PRINT et WM_PRINTCLIENT.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-draw-l1-1-2 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

Peindre et dessiner des messages

Vue d’ensemble de la peinture et du dessin

WM_PRINT

WM_PRINTCLIENT