Interfaz IPicture (ocidl.h)
Administra un objeto de imagen y sus propiedades. Los objetos de imagen proporcionan una abstracción neutral del lenguaje para mapas de bits, iconos y metarchivos. Al igual que con el objeto de fuente estándar, el sistema proporciona una implementación estándar del objeto de imagen. Sus interfaces principales son IPicture e IPictureDisp, que se derivan de IDispatch para proporcionar acceso a las propiedades de la imagen a través de Automation. Se crea un objeto de imagen con OleCreatePictureIndirect.
El objeto picture también admite la interfaz saliente IPropertyNotifySink, por lo que un cliente puede determinar cuándo cambian las propiedades de imagen. Dado que el objeto de imagen admite al menos una interfaz saliente, también implementa IConnectionPointContainer y sus interfaces asociadas para este propósito.
El objeto picture también admite IPersistStream para que pueda guardarse y cargarse desde una instancia de IStream. Un objeto que usa un objeto de imagen internamente normalmente guardaría y cargaría la imagen como parte del propio control de persistencia del objeto. La función OleLoadPicture simplifica la creación de un objeto de imagen basado en el contenido de la secuencia.
Herencia
La interfaz IPicture hereda de la interfaz IUnknown . IPicture también tiene estos tipos de miembros:
Métodos
La interfaz IPicture tiene estos métodos.
| IPicture::get_Attributes Recupera el conjunto actual de atributos de bits de la imagen. |
| IPicture::get_CurDC Recupera el identificador del contexto del dispositivo actual. Esta propiedad solo es válida para imágenes de mapa de bits. |
| IPicture::get_Handle Recupera el identificador de la imagen administrada dentro de este objeto de imagen en una ubicación especificada. |
| IPicture::get_Height Recupera el alto actual de la imagen en el objeto picture. |
| IPicture::get_hPal Recupera una copia de la paleta usada actualmente por el objeto picture. |
| IPicture::get_KeepOriginalFormat Recupera el valor actual de la propiedad KeepOriginalFormat de la imagen. |
| IPicture::get_Type Recupera el tipo actual de la imagen contenida en el objeto picture. |
| IPicture::get_Width Recupera el ancho actual de la imagen en el objeto de imagen. |
| IPicture::P ictureChanged Notifica al objeto de imagen que ha cambiado su recurso de imagen. Este método solo llama a IPropertyNotifySink::OnChanged con DISPID_PICT_HANDLE para los receptores conectados. |
| IPicture::p ut_KeepOriginalFormat Establece el valor de la propiedad KeepOriginalFormat de la imagen. |
| IPicture::Render Representa (dibuja) una parte especificada de la imagen definida por el desplazamiento (xSrc,ySrc) de la imagen de origen y las dimensiones que se van a copiar (cxSrc,xySrc). |
| IPicture::SaveAsFile Guarda los datos de la imagen en una secuencia con el mismo formato que se guardaría en un archivo. Los mapas de bits usan el formato de archivo BMP, metarchivos el formato WMF e iconos el formato ICO. |
| IPicture::SelectPicture Selecciona una imagen de mapa de bits en un contexto de dispositivo determinado y devuelve el contexto del dispositivo en el que se seleccionó previamente la imagen, así como el identificador GDI de la imagen. Este método funciona junto con IPicture::get_CurDC. |
| IPicture::set_hPal Asigna una paleta GDI a la imagen contenida en el objeto picture. |
Comentarios
Cada propiedad de la interfaz IPicture incluye un método get_PropertyName si la propiedad admite acceso de lectura y un método put_PropertyName si la propiedad admite el acceso de escritura.
| Propiedad | Tipo | Acceso | Descripción |
|---|---|---|---|
| Handle | OLE_HANDLE (int) | R | Identificador GDI de Windows de la imagen |
| hPal | OLE_HANDLE (int) | RW | Identificador de Windows de la paleta usada por la imagen. |
| Tipo | short | R | Tipo de imagen (vea PICTYPE). |
| Ancho | OLE_XSIZE_HIMETRIC (long) | R | Ancho de la imagen. |
| Alto | OLE_YSIZE_HIMETRIC (long) | R | Alto de la imagen. |
| CurDC | HDC | R | Contexto del dispositivo actual. |
| KeepOriginalFormat | BOOL | RW | Si es TRUE, el objeto picture mantiene todo el estado original de la imagen en memoria. Si es FALSE, se descarta cualquier estado no aplicable al equipo del usuario. |
| Atributos | DWORD | R | Atributos de bits varios de la imagen. |
Implementación ole
Los objetos de imagen proporcionan una abstracción neutral del lenguaje para mapas de bits, iconos y metarchivos. Al igual que con el objeto de fuente estándar, el sistema proporciona una implementación estándar del objeto de imagen. Sus interfaces principales son IPicture e IPictureDisp. Se crea un objeto de imagen con OleCreatePictureIndirect y admite las interfaces IPicture y IPictureDisp .El objeto de imagen proporcionado por OLE implementa la semántica completa de las interfaces IPicture e IPictureDisp .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | ocidl.h |