Metodo IUIImageFromBitmap::CreateImage (uiribbon.h)

Articolo
03/08/2023

Crea un oggetto IUIImage da un'immagine bitmap.

Sintassi

HRESULT CreateImage(
  [in]  HBITMAP      bitmap,
  [in]  UI_OWNERSHIP options,
  [out] IUIImage     **image
);

Parametri

[in] bitmap

Tipo: HBITMAP

Handle alla bitmap contenente l'immagine.

[in] options

Tipo: UI_OWNERSHIP

Condizioni di proprietà in cui viene creata un'immagine.

Valore	Significato
UI_OWNERSHIP_TRANSFER	Se UI_OWNERSHIP_TRANSFER viene specificato come valore delle opzioni, il framework della barra multifunzione possiede l'handle alla bitmap (HBITMAP) tramite l'oggetto IUIImage e lo rilascia quando il framework non lo richiede più. Nota Questa opzione impedisce all'applicazione host della barra multifunzione di fare riferimento in modo sicuro allo stesso HBITMAP altrove nell'interfaccia utente dell'applicazione.
UI_OWNERSHIP_COPY	Se UI_OWNERSHIP_COPY viene specificato come valore delle opzioni, l'applicazione host possiede HBITMAP ed è in grado di fare riferimento alla stessa HBITMAP per l'uso altrove nell'interfaccia utente. Nota Questa opzione consente di rilasciare HBITMAP nell'applicazione host.

Valore

Significato

UI_OWNERSHIP_TRANSFER

Se UI_OWNERSHIP_TRANSFER viene specificato come valore delle opzioni, il framework della barra multifunzione possiede l'handle alla bitmap (HBITMAP) tramite l'oggetto IUIImage e lo rilascia quando il framework non lo richiede più.

Nota Questa opzione impedisce all'applicazione host della barra multifunzione di fare riferimento in modo sicuro allo stesso HBITMAP altrove nell'interfaccia utente dell'applicazione.

UI_OWNERSHIP_COPY

Se UI_OWNERSHIP_COPY viene specificato come valore delle opzioni, l'applicazione host possiede HBITMAP ed è in grado di fare riferimento alla stessa HBITMAP per l'uso altrove nell'interfaccia utente.

Nota Questa opzione consente di rilasciare HBITMAP nell'applicazione host.

[out] image

Tipo: IUIImage**

Quando questo metodo restituisce, contiene l'indirizzo di una variabile puntatore che riceve l'oggetto IUIImage .

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo factory è utile quando un'applicazione genera dinamicamente una risorsa immagine e vuole passare il nuovo HBITMAP alla barra multifunzione, ad esempio caricando una grafica di rete portabile (PNG) tramite Windows Imaging Component (WIC) o usando CreateDIBSection per creare un'immagine per un nuovo stile in una raccolta stili.

Questo metodo è utile anche per le applicazioni che richiedono un'immagine bitmap preesistente che non è stata eseguita il rendering obsoleto dalla barra multifunzione, ad esempio una barra degli strumenti legacy.

Specificare UI_OWNERSHIP_COPY come valore per le opzioni se la barra multifunzione viene implementata in un'applicazione esistente e sono necessarie modifiche minime al codice. Questo metodo usa memoria aggiuntiva per l'immagine aggiuntiva.

Specificare UI_OWNERSHIP_TRANSFER come valore per le opzioni per ridurre al minimo l'utilizzo della memoria.

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiribbon.h
DLL	Mshtml.dll

Vedi anche

IUIImageFromBitmap

Esempi di Framework della barra multifunzione di Windows

Condividi tramite