勇芳软件工作室.汉化:  Device Contexts > Device Contexts Functions >

CreateCompatibleDC

Previous pageReturn to chapter overviewNext page

描述

 

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

 

C++ 语法

 

HDC CreateCompatibleDC(

__in HDC hdc

);

 

PowerBASIC 语法

 

FUNCTION CreateCompatibleDC ( _

BYVAL hdc AS DWORD _

) AS DWORD

 

参数

 

hdc

 

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

 

返回值

 

如果函数成功,则返回值标识一个逻辑画笔。

 

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

 

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

 

备注

 

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

 

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

 

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

 

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

 

Windows 2000及更高版本:如果hdc为NULL,调用CreateCompatibleDC的线程拥有创建的HDC。当线程被破坏时,HDC不再有效。因此,如果您创建HDC并将其通过另一个线程,则退出第一个线程,第二个线程将无法使用HDC。

 

ICM:如果传递给此函数的DC对图像颜色管理(ICM)启用,则由该函数创建的DC将启用ICM。源和目标颜色空间在DC中指定。

 

引用文件 #INCLUDE Once

 

WinUser.inc(包括Windows.inc)