Compartir a través de

Método IUIImageFromBitmap::CreateImage (uiribbon.h)

  • Artículo

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

Consulte también

IUIImageFromBitmap

Ejemplos de Windows Ribbon Framework