Método IUIImageFromBitmap::CreateImage (uiribbon.h)
Crea un objeto IUIImage a partir de una imagen de mapa de bits.
Sintaxis
HRESULT CreateImage(
[in] HBITMAP bitmap,
[in] UI_OWNERSHIP options,
[out] IUIImage **image
);
Parámetros
[in] bitmap
Tipo: HBITMAP
Identificador del mapa de bits que contiene la imagen.
[in] options
Tipo: UI_OWNERSHIP
Condiciones de propiedad en las que se crea una imagen.
| Value | Significado |
|---|---|
| UI_OWNERSHIP_TRANSFER | Si UI_OWNERSHIP_TRANSFER se especifica como el valor de las opciones, el marco de la cinta posee el identificador del mapa de bits (HBITMAP) a través del objeto IUIImage y lo libera cuando el marco ya no lo requiera.
Nota Esta opción impide que la aplicación host de la cinta haga referencia de forma segura al mismo HBITMAP en otra parte de la interfaz de usuario de la aplicación.
|
| UI_OWNERSHIP_COPY | Si UI_OWNERSHIP_COPY se especifica como el valor de las opciones, la aplicación host posee el HBITMAP y puede hacer referencia al mismo HBITMAP para su uso en otra parte de la interfaz de usuario.
Nota Esta opción asigna la responsabilidad de liberar HBITMAP en la aplicación host.
|
[out] image
Tipo: IUIImage**
Cuando este método devuelve, contiene la dirección de una variable de puntero que recibe el objeto IUIImage .
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Este método de fábrica es útil cuando una aplicación genera dinámicamente un recurso de imagen y quiere pasar el nuevo HBITMAP a la cinta de opciones, por ejemplo, cargar un gráfico de red portátil (PNG) a través del componente de imágenes de Windows (WIC) o usar CreateDIBSection para crear una imagen para un nuevo estilo en una galería de estilos.
Este método también es útil para las aplicaciones que requieren una imagen de mapa de bits existente que no se ha representado obsoleta por la cinta de opciones, por ejemplo, una franja de imágenes de barra de herramientas heredada.
Especifique UI_OWNERSHIP_COPY como valor para las opciones si la cinta de opciones se está implementando en una aplicación existente y se requieren cambios mínimos en el código. Este método usa memoria adicional para la imagen adicional.
Especifique UI_OWNERSHIP_TRANSFER como valor de las opciones para minimizar el uso de memoria.
Requisitos
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | uiribbon.h |
| Archivo DLL | Mshtml.dll |