Share via

PrintWindow 函数 (winuser.h)

  • 项目

PrintWindow 函数将可视窗口复制到指定的设备上下文 (DC) （通常是打印机 DC）。

语法

BOOL PrintWindow(
  HWND hwnd,
  HDC  hdcBlt,
  UINT nFlags
);

参数

hwnd

要复制的窗口的句柄。

hdcBlt

设备上下文的句柄。

nFlags

绘图选项。 可以是下列值之一。

值 含义
PW_CLIENTONLY
 仅将窗口的工作区复制到 hdcBlt。 默认情况下，将复制整个窗口。

返回值

如果函数成功，则返回非零值。

如果函数失败，则返回零。

注解

注意 这是一个阻塞或同步函数，可能不会立即返回。 此函数返回的速度取决于运行时因素（例如网络状态、打印服务器配置和打印机驱动程序实现），这些因素在编写应用程序时难以预测。 从管理与用户界面交互的线程调用此函数可能会使应用程序看起来无响应。
 
拥有 hWnd 引用的窗口的应用程序处理 PrintWindow 调用，并在 hdcBlt 引用的设备上下文中呈现图像。 应用程序接收 WM_PRINT 消息，或者，如果指定 了PW_PRINTCLIENT 标志， 则接收WM_PRINTCLIENT 消息。 有关详细信息，请参阅 WM_PRINT 和 WM_PRINTCLIENT。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 Windows 10版本 10.0.10240 中引入的 ext-ms-win-ntuser-draw-l1-1-2 ()

另请参阅

绘制和绘制消息

绘图和绘图概述

WM_PRINT

WM_PRINTCLIENT