Metodo IUIImageFromBitmap::CreateImage (uiribbon.h)
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.
|
[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 |