GetDC 函数

GetDC 函数

GetDC函数为一个指定窗口的客户端区域或者整个屏幕从一个设备上下文(DC)中提取一个句柄。你可以使用这个返回的句柄，在随后的GDI函数中用于在DC中画图。设备上下文是一个不透明的数据结构，它的值通常在GDI内部使用。

GetDCEx函数是对GetDC函数的扩展，它在如何以及是否在客户端区域发生的剪切为应用程序提供更多的控制。

语法

HDC GetDC(
  HWND hWnd
);

参数

hwnd

对应要被提取DC的窗口的句柄。如果这个值为NULL，GetDC提取整个屏幕的DC。

返回值

如果函数成功，返回值表示为指定窗口客户端区域的DC的句柄。

如果函数失败，返回值是NULL。

备注

GetDC函数根据指定窗口的类样式检索公共DC、类DC或私有DC。对于类和私有DCs, GetDC保持先前分配的属性不变。然而，对于公共DCs，GetDC在每次被提取的时候给DC赋值默认属性。例如，默认字体是系统字体，它是一个位图字体。因为这样，通过GetDC返回的公共DC的句柄将不会告诉你窗口绘制所使用的字体，颜色，或笔刷。想要定制字体，调用GetTextFace.

注意，DC的句柄在任一时刻只能被单一的线程使用。

当使用公共DC绘制后，必须调用ReleaseDC函数来释放DC。类DCs和私有DCs不需要释放。ReleaseDC必须和GetDC同属于同一个线程。DC的数量仅局限于可用的内存大小。

要求

最低支持客户端：Windows 2000 Professional(仅桌面应用)

最低支持服务端：Windows 2000 Server(仅桌面应用)

目标平台：Windows

头文件：winuser.h(包括Windows.h)

库文件：User32.lib

Dll：User32.lib