IPicture 接口 (ocidl.h)
管理图片对象及其属性。 图片对象为位图、图标和图元文件提供与语言无关的抽象。 与标准字体对象一样,系统提供图片对象的标准实现。 其主要接口是 IPicture 和 IPictureDisp,后者派生自 IDispatch ,通过自动化提供对图片属性的访问。 使用 OleCreatePictureIndirect 创建图片对象。
picture 对象还支持传出接口 IPropertyNotifySink,因此客户端可以确定图片属性何时更改。 由于 picture 对象支持至少一个传出接口,因此它还实现 IConnectionPointContainer 及其关联的接口以实现此目的。
picture 对象还支持 IPersistStream ,以便它可以保存和加载来自 IStream 实例的自身。 在内部使用图片对象的对象通常会保存并加载图片,作为对象自身持久性处理的一部分。 函数 OleLoadPicture 简化了基于流内容的图片对象的创建。
继承
IPicture 接口继承自 IUnknown 接口。 IPicture 还具有以下类型的成员:
方法
IPicture 接口具有这些方法。
IPicture::get_Attributes 检索图片的位属性的当前集。 |
IPicture::get_CurDC 检索当前设备上下文的句柄。 此属性仅适用于位图图片。 |
IPicture::get_Handle 检索在此图片对象中管理的图片到指定位置的句柄。 |
IPicture::get_Height 检索图片对象中图片的当前高度。 |
IPicture::get_hPal 检索图片对象当前使用的调色板的副本。 |
IPicture::get_KeepOriginalFormat 检索图片的 KeepOriginalFormat 属性的当前值。 |
IPicture::get_Type 检索图片对象中包含的图片的当前类型。 |
IPicture::get_Width 检索图片对象中图片的当前宽度。 |
IPicture::P ictureChanged 通知图片对象其图片资源已更改。 此方法仅对任何连接的接收器使用 DISPID_PICT_HANDLE调用 IPropertyNotifySink::OnChanged。 |
IPicture::p ut_KeepOriginalFormat 设置图片的 KeepOriginalFormat 属性的值。 |
IPicture::Render 呈现 (绘制) 由源图片的偏移量 (xSrc、ySrc) 定义的图片的指定部分,以及要复制 (cxSrc、xySrc) 的尺寸。 |
IPicture::SaveAsFile 将图片的数据保存到流中,格式与将自身保存到文件中的格式相同。 位图使用 BMP 文件格式,对 WMF 格式进行图元化,并图标 ICO 格式。 |
IPicture::SelectPicture 选择给定设备上下文中的位图图片,并返回以前选择图片的设备上下文以及图片的 GDI 句柄。 此方法与 IPicture::get_CurDC 结合使用。 |
IPicture::set_hPal 将 GDI 调色板分配给图片对象中包含的图片。 |
注解
IPicture 接口中的每个属性都包含一个 get_PropertyName 方法(如果属性支持读取访问)和一个 put_PropertyName 方法(如果该属性支持写入访问)。
属性 | 类型 | 访问 | 说明 |
---|---|---|---|
Handle | OLE_HANDLE (int) | R | 图片的 Windows GDI 句柄 |
hPal | OLE_HANDLE (int) | RW | 图片使用的调色板的 Windows 句柄。 |
类型 | short | R | 图片的类型 (请参阅 PICTYPE) 。 |
宽度 | OLE_XSIZE_HIMETRIC (长) | R | 图片的宽度。 |
高度 | OLE_YSIZE_HIMETRIC (长) | R | 图片的高度。 |
CurDC | HDC | R | 当前设备上下文。 |
KeepOriginalFormat | BOOL | RW | 如果 为 TRUE,则图片对象在内存中保留图片的整个原始状态。 如果 为 FALSE,则放弃任何不适用于用户计算机的状态。 |
属性 | DWORD | R | 图片的其他位属性。 |
OLE 实现
图片对象为位图、图标和图元文件提供与语言无关的抽象。 与标准字体对象一样,系统提供图片对象的标准实现。 其主要接口是 IPicture 和 IPictureDisp。 图片对象是使用 OleCreatePictureIndirect 创建的,支持 IPicture 和 IPictureDisp 接口。OLE 提供的图片对象实现 IPicture 和 IPictureDisp 接口的完整语义。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ocidl.h |