IUIImageFromBitmap::CreateImage-Methode (uiribbon.h)
Erstellt ein IUIImage-Objekt aus einem Bitmapbild.
Syntax
HRESULT CreateImage(
[in] HBITMAP bitmap,
[in] UI_OWNERSHIP options,
[out] IUIImage **image
);
Parameter
[in] bitmap
Typ: HBITMAP
Ein Handle für die Bitmap, die das Bild enthält.
[in] options
Typ: UI_OWNERSHIP
Die Eigentumsbedingungen , unter denen ein Image erstellt wird.
| Wert | Bedeutung |
|---|---|
| UI_OWNERSHIP_TRANSFER | Wenn UI_OWNERSHIP_TRANSFER als Wert von Optionen angegeben wird, besitzt das Menübandframework das Handle für die Bitmap (HBITMAP) über das IUIImage-Objekt und gibt es frei, wenn es vom Framework nicht mehr benötigt wird.
Hinweis Diese Option verhindert, dass die Menübandhostanwendung sicher auf dieselbe HBITMAP an anderer Stelle auf der Anwendungsbenutzeroberfläche verweist.
|
| UI_OWNERSHIP_COPY | Wenn UI_OWNERSHIP_COPY als Wert von Optionen angegeben wird, besitzt die Hostanwendung die HBITMAP und kann zur Verwendung an anderer Stelle auf der Benutzeroberfläche auf dieselbe HBITMAP verweisen.
Hinweis Diese Option übernimmt die Verantwortung für die Freigabe der HBITMAP für die Hostanwendung.
|
[out] image
Typ: IUIImage**
Wenn diese Methode zurückgibt, enthält die Adresse einer Zeigervariable, die das IUIImage-Objekt empfängt.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Factorymethode ist nützlich, wenn eine Anwendung dynamisch eine Bildressource generiert und die neue HBITMAP an das Menüband übergeben möchte, z. B. beim Laden einer portablen Netzwerkgrafik (PNG) über die Windows Imaging Component (WIC) oder mithilfe von CreateDIBSection ein Bild für eine neue Formatvorlage in einem Formatvorlagenkatalog erstellen möchte.
Diese Methode ist auch für Anwendungen nützlich, die ein bereits vorhandenes Bitmapbild erfordern, das nicht vom Menüband veraltet wurde, z. B. einen Legacysymbolleisten-Bildstreifen.
Geben Sie UI_OWNERSHIP_COPY als Wert für Optionen an, wenn das Menüband in einer vorhandenen Anwendung implementiert wird und minimale Codeänderungen erforderlich sind. Diese Methode verwendet zusätzlichen Arbeitsspeicher für das zusätzliche Image.
Geben Sie UI_OWNERSHIP_TRANSFER als Wert für Optionen an, um die Arbeitsspeicherauslastung zu minimieren.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | uiribbon.h |
| DLL | Mshtml.dll |