Freigeben über

IUIImageFromBitmap::CreateImage-Methode (uiribbon.h)

  • Artikel

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

Weitere Informationen

IUIImageFromBitmap

Windows-Menübandframeworkbeispiele