getWindowDC 函数 (winuser.h)

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

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

语法

HDC GetWindowDC(
  [in] HWND hWnd
);

参数

[in] hWnd

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

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

返回值

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

如果函数失败,则返回值为 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