Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

WM_PRINT message

The WM_PRINT message is sent to a window to request that it draw itself in the specified device context, most commonly in a printer device context.

A window receives this message through its WindowProc function.


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

Parameters

wParam

A handle to the device context to draw in.

lParam

The drawing options. This parameter can be one or more of the following values.

ValueMeaning
PRF_CHECKVISIBLE

Draws the window only if it is visible.

PRF_CHILDREN

Draws all visible children windows.

PRF_CLIENT

Draws the client area of the window.

PRF_ERASEBKGND

Erases the background before drawing the window.

PRF_NONCLIENT

Draws the nonclient area of the window.

PRF_OWNED

Draws all owned windows.

 

Remarks

The DefWindowProc function processes this message based on which drawing option is specified: if PRF_CHECKVISIBLE is specified and the window is not visible, do nothing, if PRF_NONCLIENT is specified, draw the nonclient area in the specified device context, if PRF_ERASEBKGND is specified, send the window a WM_ERASEBKGND message, if PRF_CLIENT is specified, send the window a WM_PRINTCLIENT message, if PRF_CHILDREN is set, send each visible child window a WM_PRINT message, if PRF_OWNED is set, send each visible owned window a WM_PRINT message.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

See also

Painting and Drawing Overview
Painting and Drawing Messages
DefWindowProc
WM_ERASEBKGND
WM_PRINTCLIENT

 

 

Show:
© 2017 Microsoft