IPicture::get_CurDC 方法 (ocidl.h)
检索当前设备上下文的句柄。 此属性仅适用于位图图片。
语法
HRESULT get_CurDC(
[out] HDC *phDC
);
参数
[out] phDC
一个指针,一个接收设备上下文的变量。
返回值
此方法支持E_FAIL的标准返回值以及以下值。
返回代码 | 说明 |
---|---|
|
已成功返回属性位。 |
|
phDC 的值无效。 例如,它可能为 NULL。 |
注解
CurDC 属性和 IPicture::SelectPicture 方法存在以规避 Windows 中的限制;具体而言,一次只能将对象选择到一个设备上下文中。 在某些情况下,图片对象可能会永久选择到特定的设备上下文中, (例如,控件可能会使用特定图片作为背景) 。 若要在其他位置使用此图片属性,必须暂时从其旧设备上下文中取消选择该属性,将其选择到操作的新设备上下文中,然后重新选择回旧设备上下文。 IPicture::get_CurDC 方法返回当前选择图片的设备上下文句柄。 IPicture::SelectPicture 方法将图片选择到新的设备上下文中,返回旧设备上下文和图片的 GDI 句柄。 调用方应在调用方完成操作时将图片选回旧设备上下文中,这与 Windows 代码的正常情况一样。
给调用方的说明
调用方始终拥有在它与图片对象之间传递的任何设备上下文。 由于图片对象维护 HDC 的副本,因此调用方应使用使用 CreateCompatibleDC 函数创建的内存设备上下文 () ,而不是从 GetDC、 CreateDC 或 BeginPaint) (屏幕设备上下文,因为屏幕设备上下文是有限的系统资源。要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ocidl.h |