Método IUIImageFromBitmap::CreateImage (uiribbon.h)
Cria um objeto IUIImage a partir de uma imagem de bitmap.
Sintaxe
HRESULT CreateImage(
[in] HBITMAP bitmap,
[in] UI_OWNERSHIP options,
[out] IUIImage **image
);
Parâmetros
[in] bitmap
Tipo: HBITMAP
Um identificador para o bitmap que contém a imagem.
[in] options
Tipo: UI_OWNERSHIP
As condições de propriedade sob as quais uma imagem é criada.
| Valor | Significado |
|---|---|
| UI_OWNERSHIP_TRANSFER | Se UI_OWNERSHIP_TRANSFER for especificado como o valor das opções, a estrutura da Faixa de Opções possuirá o identificador para o bitmap (HBITMAP) por meio do objeto IUIImage e o liberará quando a estrutura não exigir mais.
Nota Essa opção impede que o aplicativo host da Faixa de Opções referencia com segurança o mesmo HBITMAP em outro lugar na interface do usuário do aplicativo.
|
| UI_OWNERSHIP_COPY | Se UI_OWNERSHIP_COPY for especificado como o valor das opções, o aplicativo host será proprietário do HBITMAP e poderá referenciar o mesmo HBITMAP para uso em outro lugar da interface do usuário.
Nota Essa opção coloca a responsabilidade de liberar o HBITMAP no aplicativo host.
|
[out] image
Tipo: IUIImage**
Quando esse método retorna, contém o endereço de uma variável de ponteiro que recebe o objeto IUIImage .
Valor retornado
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Esse método de fábrica é útil quando um aplicativo gera dinamicamente um recurso de imagem e deseja passar o novo HBITMAP para a Faixa de Opções, por exemplo, carregando um PNG (Portable Network Graphics) por meio do WIC (Componente de Imagem do Windows) ou usando CreateDIBSection para criar uma imagem para um novo estilo em uma galeria de estilos.
Esse método também é útil para aplicativos que exigem uma imagem de bitmap pré-existente que não foi renderizada obsoleta pela Faixa de Opções, por exemplo, uma faixa de imagem da barra de ferramentas herdada.
Especifique UI_OWNERSHIP_COPY como o valor das opções se a Faixa de Opções estiver sendo implementada em um aplicativo existente e forem necessárias alterações mínimas de código. Esse método usa memória extra para a imagem adicional.
Especifique UI_OWNERSHIP_TRANSFER como o valor das opções para minimizar o uso de memória.
Requisitos
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | uiribbon.h |
| DLL | Mshtml.dll |