平台 SDK: Windows GDI

CreateCompatibleDC

CreateCompatibleDC函数创建与指定设备兼容的内存设备上下文(DC)。

HDC CreateCompatibleDC(
  HDC hdc   // 设备上下文句柄
);

参数

  • hdc

  • [in] 处理现有DC。 如果此句柄为NULL,则该函数将创建与应用程序当前屏幕兼容的内存DC。

返回值


如果函数成功,则返回值是存储器DC的句柄。

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

Windows NT/2000/XP: 要获取扩展错误信息,请调用GetLastError。

备注


存储器DC仅存在于存储器中。 当创建存储器DC时,其显示表面正好是一个单色像素宽,一个单色像素高。 在应用程序可以使用内存DC进行绘图操作之前,必须在DC中选择正确的宽度和高度的位图。 要将位图选择到DC中,请使用CreateCompatibleBitmap函数,指定所需的高度,宽度和颜色组织。

创建内存DC时,所有属性都将设置为正常默认值。 存储器DC可以用作正常的DC。 您可以设置属性; 获取其属性的当前设置; 并选择笔,画笔和区域。

CreateCompatibleDC函数只能用于支持栅格操作的设备。 应用程序可以通过调用GetDeviceCaps函数来确定设备是否支持这些操作。

当您不再需要内存DC时,请调用DeleteDC功能。

ICM: 如果传递给此功能的DC为独立颜色管理(ICM)启用,则由该功能创建的DC将启用ICM。 源和目标颜色空间在DC中指定。

Example Code

有关示例,请参阅 捕获图像。

要求

   Windows NT / 2000 / XP:包含在Windows NT 3.1及更高版本中。

   Windows 95/98 / Me:包含在Windows 95及更高版本中。

   头文件:声明于Wingdi.h; 包含于Windows.h。

   库:使用Gdi32.lib。