winuser.h

Mensaje WM_PRINTCLIENT

Definición

WM_PRINTCLIENT
    hDC=(WPARAM)(HDC)wParam
    dwOpcions=(LPARAM)(DWORD)lParam

El mensaje WM_PRINTCLIENT es enviado a una ventana para solicitar que pinte su área de cliente en el contexto de dispositivo especificado, comúnmente en un contexto de dispositivo de impresora.

Al contrario que WM_PRINT, WM_PRINTCLIENT no es procesado por DefWindowProc. Una aplicación debe procesar el mensaje WM_PRINTCLIENT a través de una función WindowProc definida por la aplicación para que se utilice correctamente.

LRESULT CALLBACK WindowProc(
  HWND hwnd, 
  UINT  uMsg, 
  WPARAM wParam, 
  LPARAM lParam     
);

Descripción

hDC

Un manipuladr de contexto de dispositivo en el que se ha de dibujar.

dwOptions

Las opciones de dibujado. Este parámetro puede ser uno o más de los siguientes valores:

Valor	Significado
PRF_CHECKVISIBLE	Dibuja la ventana sólo si es visible.
PRF_CHILDREN	Dibuja todas las ventanas hijas visibles.
PRF_CLIENT	Dibuja el área de cliente del la ventana.
PRF_ERASEBKGND	Borra el fondo antes de dibujar la ventana.
PRF_NONCLIENT	Dibuja el área de no cliente de la ventana.
PRF_OWNED	Dibuja todas las ventanas hijas.

Observaciones

Una ventana puede procesar este mensaje de forma muy similar a WM_PAINT, excepto que no será necesario invocar a BeginPaint y EndPaint (ya que se proporciona un contexto de dispositivo), y que la ventana deberá dibujas su área de cliente entera en lugar de sólo la región inválida.

Las ventanas que puedan ser usadas en cualquier parte del sistema, como los controles, deberían procesar este mensaje. Probablemente también valga la pena que otras ventanas también lo procesen, porque es relativamente fácil de implementar.

la función The AnimateWindow requiere que la ventana que está siendo animada implemente el mensaje WM_PRINTCLIENT.