WM_PRINTCLIENT Nachricht

  • Artikel

Die WM_PRINTCLIENT Nachricht wird an ein Fenster gesendet, um anzufordern, den Clientbereich im angegebenen Gerätekontext zu zeichnen, am häufigsten in einem Druckergerätekontext.

Im Gegensatz zu WM_PRINT wird WM_PRINTCLIENT nicht von DefWindowProc verarbeitet. Ein Fenster sollte die WM_PRINTCLIENT Nachricht über eine anwendungsdefinierte WindowProc-Funktion verarbeiten, damit sie ordnungsgemäß verwendet werden kann.

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

Parameter

wParam

Ein Handle für den zu zeichnenden Gerätekontext.

lParam

Die Zeichnungsoptionen. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert Bedeutung
PRF_CHECKVISIBLE
 Zeichnet das Fenster nur, wenn es sichtbar ist.
PRF_CHILDREN
 Zeichnet alle sichtbaren untergeordneten Fenster.
PRF_CLIENT
 Zeichnet den Clientbereich des Fensters.
PRF_ERASEBKGND
 Löscht den Hintergrund vor dem Zeichnen des Fensters.
PRF_NONCLIENT
 Zeichnet den Nichtclientbereich des Fensters.
PRF_OWNED
 Zeichnet alle eigenen Fenster.

 

Bemerkungen

Ein Fenster kann diese Nachricht auf die gleiche Weise wie WM_PAINT verarbeiten, mit der Ausnahme, dass BeginPaint und EndPaint nicht aufgerufen werden müssen (ein Gerätekontext wird angegeben), und das Fenster sollte den gesamten Clientbereich und nicht nur die ungültige Region zeichnen.

Windows, die überall im System verwendet werden können, z. B. Steuerelemente, sollten diese Nachricht verarbeiten. Es lohnt sich wahrscheinlich auch für andere Fenster, diese Nachricht zu verarbeiten, da sie relativ einfach zu implementieren ist.

Die AnimateWindow-Funktion erfordert, dass das animierte Fenster die WM_PRINTCLIENT Nachricht implementiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows 2000 Server [nur Desktop-Apps]
Header
Winuser.h (einschließlich Windows.h)

Siehe auch

Übersicht über Malerei und Zeichnung

Malen und Zeichnen von Nachrichten

AnimateWindow

BeginPaint

EndPaint

WM_PAINT