IPicture::get_CurDC 方法 (ocidl.h)

检索当前设备上下文的句柄。 此属性仅适用于位图图片。

语法

HRESULT get_CurDC(
  [out] HDC *phDC
);

参数

[out] phDC

一个指针,一个接收设备上下文的变量。

返回值

此方法支持E_FAIL的标准返回值以及以下值。

返回代码 说明
S_OK
已成功返回属性位。
E_POINTER
phDC 的值无效。 例如,它可能为 NULL

注解

CurDC 属性和 IPicture::SelectPicture 方法存在以规避 Windows 中的限制;具体而言,一次只能将对象选择到一个设备上下文中。 在某些情况下,图片对象可能会永久选择到特定的设备上下文中, (例如,控件可能会使用特定图片作为背景) 。 若要在其他位置使用此图片属性,必须暂时从其旧设备上下文中取消选择该属性,将其选择到操作的新设备上下文中,然后重新选择回旧设备上下文。 IPicture::get_CurDC 方法返回当前选择图片的设备上下文句柄。 IPicture::SelectPicture 方法将图片选择到新的设备上下文中,返回旧设备上下文和图片的 GDI 句柄。 调用方应在调用方完成操作时将图片选回旧设备上下文中,这与 Windows 代码的正常情况一样。

给调用方的说明

调用方始终拥有在它与图片对象之间传递的任何设备上下文。 由于图片对象维护 HDC 的副本,因此调用方应使用使用 CreateCompatibleDC 函数创建的内存设备上下文 () ,而不是从 GetDCCreateDCBeginPaint) (屏幕设备上下文,因为屏幕设备上下文是有限的系统资源。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ocidl.h

另请参阅

IPicture

IPicture::SelectPicture