WM_PRINTCLIENT 消息

小甲鱼

注：本文档由 Diu 翻译，小甲鱼校对。

原文链接 -> 传送门

消息含义：

WM_PRINTCLIENT 消息被发送到窗口，以请求它在指定的设备上下文中绘制其客户区，最常见于打印机设备上下文中。

与 WM_PRINT 消息不同，WM_PRINTCLIENT 不由 DefWindowProc 函数处理。窗口应该通过应用程序定义的 WindowProc 函数处理 WM_PRINTCLIENT 消息，以便正确使用它。


消息定义：

#define WM_PRINTCLIENT                  0x0318

参数解析：

wParam：指定要绘制的设备上下文的句柄。

lParam：指定绘图选项。

此参数可以是下列值中的一个或多个：

值	含义
PRF_CHECKVISIBLE	只有当窗口可见时才绘制窗口
PRF_CHILDREN	绘制所有可见的子窗口
PRF_CLIENT	绘制窗口的客户区
PRF_ERASEBKGND	在绘制窗口之前删除背景
PRF_NONCLIENT	绘制窗口的非客户区域
PRF_OWNED	绘制所有附属窗口

备注：

1. 窗口可以用与 WM_PAINT 大致相同的方式处理该消息，除了 BeginPaint 和 EndPaint 函数不需要被调用（提供了设备上下文），并且窗口应当绘制其整个客户区域而不仅仅是无效区域。

2. 能在系统中的任何位置使用的窗口，如控件，都应该处理此消息。也可能同样值得其他窗口处理此消息，因为它相对容易实现。

3. AnimateWindow 函数要求动画窗口实现 WM_PRINTCLIENT 消息。


需求：

Minimum supported client	Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [仅桌面应用程序]
Header	Winuser.h (包含于 Windows.h)

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。