Función PrintWindow (winuser.h)

La función PrintWindow copia una ventana visual en el contexto de dispositivo (DC) especificado, normalmente un controlador de dominio de impresora.

Sintaxis

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

Parámetros

hwnd

Identificador de la ventana que se va a copiar.

hdcBlt

Identificador del contexto del dispositivo.

nFlags

Opciones de dibujo. Puede ser uno de los siguientes valores.

Value	Significado
PW_CLIENTONLY	Solo el área cliente de la ventana se copia en hdcBlt. De forma predeterminada, se copia toda la ventana.

Valor devuelto

Si la función se ejecuta correctamente, devuelve un valor distinto de cero.

Si se produce un error en la función, devuelve cero.

Comentarios

Nota Se trata de una función de bloqueo o sincrónica que podría no devolverse inmediatamente. La rapidez con la que esta función devuelve depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y la implementación del controlador de impresora, factores que son difíciles de predecir al escribir una aplicación. Llamar a esta función desde un subproceso que administra la interacción con la interfaz de usuario podría hacer que la aplicación parezca que no responde.

 

La aplicación propietaria de la ventana a la que hace referencia hWnd procesa la llamada a PrintWindow y representa la imagen en el contexto del dispositivo al que hace referencia hdcBlt. La aplicación recibe un mensaje WM_PRINT o, si se especifica la marca PW_PRINTCLIENT , un mensaje WM_PRINTCLIENT . Para obtener más información, consulte WM_PRINT y WM_PRINTCLIENT.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-draw-l1-1-2 (introducido en Windows 10, versión 10.0.10240)

Consulte también

Pintar y dibujar mensajes

Información general sobre la pintura y el dibujo

WM_PRINT

WM_PRINTCLIENT