getWindowDC 函数 (winuser.h)

GetWindowDC 函数检索整个窗口的设备上下文 (DC) ,包括标题栏、菜单和滚动条。 窗口设备上下文允许在窗口中的任意位置进行绘制,因为设备上下文的原点是窗口的左上角,而不是工作区。

每次检索设备上下文时,GetWindowDC 都会将默认属性分配给窗口设备上下文。 以前的属性会丢失。

语法

HDC GetWindowDC(
  [in] HWND hWnd
);

参数

[in] hWnd

具有要检索的设备上下文的窗口的句柄。 如果此值为 NULL则 GetWindowDC 将检索整个屏幕的设备上下文。

如果此参数为 NULL则 GetWindowDC 将检索主显示器的设备上下文。 若要获取其他显示监视器的设备上下文,请使用 EnumDisplayMonitorsCreateDC 函数。

返回值

如果函数成功,则返回值是指定窗口的设备上下文的句柄。

如果函数失败,则返回值为 NULL,指示错误或 hWnd 参数无效。

注解

GetWindowDC 适用于窗口非工作区内的特殊绘制效果。 不建议在任何窗口的非工作区中绘制。

GetSystemMetrics 函数可用于检索非工作区的各个部分(如标题栏、菜单和滚动条)的尺寸。

GetDC 函数可用于检索整个屏幕的设备上下文。

绘制完成后,必须调用 ReleaseDC 函数来释放设备上下文。 不释放窗口设备上下文会对应用程序请求的绘制产生严重影响。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 在 Windows 8) 中引入的 ext-ms-win-ntuser-draw-l1-1-0 (

另请参阅

BeginPaint

GetDC

GetSystemMetrics

绘制和绘制函数

绘画和绘图概述

ReleaseDC