getDC 函数 (winuser.h)

GetDC 函数检索指定窗口的工作区或整个屏幕的设备上下文 (DC) 的句柄。 可以在后续 GDI 函数中使用返回的句柄在 DC 中绘制。 设备上下文是一种不透明的数据结构,其值由 GDI 在内部使用。

GetDCEx 函数是 GetDC 的扩展,它使应用程序能够更好地控制在工作区中发生剪裁的方式和是否发生。

语法

HDC GetDC(
  [in] HWND hWnd
);

参数

[in] hWnd

要检索其 DC 的窗口的句柄。 如果此值为 NULL则 GetDC 将检索整个屏幕的 DC。

返回值

如果函数成功,则返回值是指定窗口工作区的 DC 的句柄。

如果函数失败,则返回值为 NULL。

注解

GetDC 函数根据指定窗口的类样式检索公共、类或专用 DC。 对于类和专用 DC,GetDC 保留以前分配的属性不变。 但是,对于常见的 DC,GetDC 在每次检索 DC 时都会将默认属性分配给 DC。 例如,默认字体为 System,即位图字体。 因此, GetDC 返回的通用 DC 的句柄不会告诉你在绘制窗口时使用了哪种字体、颜色或画笔。 若要确定字体,请调用 GetTextFace

请注意,DC 的句柄一次只能由单个线程使用。

使用通用 DC 进行绘制后,必须调用 ReleaseDC 函数来释放 DC。 类和专用 DC 不必释放。 ReleaseDC 必须从调用 GetDC 的同一线程调用。 DC 的数量仅受可用内存的限制。

示例

有关示例,请参阅 使用鼠标绘图

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll

另请参阅

设备上下文函数

设备上下文概述

GetDCEx

GetTextFace

GetWindowDC

ReleaseDC

WindowFromDC