WM_PRINTCLIENT message

  • Article

Le message WM_PRINTCLIENT est envoyé à une fenêtre pour demander qu’elle dessine sa zone cliente dans le contexte d’appareil spécifié, le plus souvent dans un contexte d’appareil d’imprimante.

Contrairement à WM_PRINT, WM_PRINTCLIENT n’est pas traité par DefWindowProc. Une fenêtre doit traiter le message WM_PRINTCLIENT via une fonction WindowProc définie par l’application pour qu’il soit utilisé correctement.

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

Paramètres

wParam

Handle du contexte de l’appareil à dessiner.

lParam

Options de dessin. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur Signification
PRF_CHECKVISIBLE
 Dessine la fenêtre uniquement si elle est visible.
PRF_CHILDREN
 Dessine toutes les fenêtres enfants visibles.
PRF_CLIENT
 Dessine la zone cliente de la fenêtre.
PRF_ERASEBKGND
 Efface l’arrière-plan avant de dessiner la fenêtre.
PRF_NONCLIENT
 Dessine la zone non cliente de la fenêtre.
PRF_OWNED
 Dessine toutes les fenêtres possédées.

 

Remarques

Une fenêtre peut traiter ce message de la même manière que WM_PAINT, à ceci près que BeginPaint et EndPaint n’ont pas besoin d’être appelés (un contexte d’appareil est fourni), et la fenêtre doit dessiner l’ensemble de sa zone cliente plutôt que simplement la région non valide.

Les fenêtres qui peuvent être utilisées n’importe où dans le système, comme les contrôles, doivent traiter ce message. Il est probablement utile pour d’autres fenêtres de traiter ce message, car il est relativement facile à implémenter.

La fonction AnimateWindow nécessite que la fenêtre animée implémente le message WM_PRINTCLIENT .

Configuration requise

Condition requise Valeur
Client minimal pris en charge
 Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows 2000 Server [applications de bureau uniquement]
En-tête
Winuser.h (include Windows.h)

Voir aussi

Vue d’ensemble de la peinture et du dessin

Peinture et dessin de messages

AnimateWindow

BeginPaint

EndPaint

WM_PAINT