Bitmap::FromHBITMAP-Methode (gdiplusheaders.h)

Artikel
08/24/2023

Die Bitmap::FromHBITMAP-Methode erstellt ein Bitmap-Objekt basierend auf einem Handle für eine GDI-Bitmap (Windows Graphics Device Interface) und einem Handle für eine GDI-Palette.

Syntax

Bitmap * FromHBITMAP(
  [in] HBITMAP  hbm,
  [in] HPALETTE hpal
);

Parameter

[in] hbm

Typ: HBITMAP

Handle to GDI bitmap.

[in] hpal

Typ: HPALETTE

Handle für eine GDI-Palette, die zum Definieren der Bitmapfarben verwendet wird, wenn hbm keine geräteunabhängige Bitmap (DEVICE-Independent Bitmap, DIB) ist.

Rückgabewert

Typ: Bitmap*

Diese Methode gibt einen Zeiger auf das neue Bitmap-Objekt zurück.

Hinweise

Sie sind für das Löschen der GDI-Bitmap und der GDI-Palette verantwortlich. Sie sollten die GDI-Bitmap oder die GDI-Palette jedoch erst löschen, nachdem das GDI+ -Bitmapobjekt gelöscht wurde oder den Gültigkeitsbereich überschreitet.

Übergeben Sie nicht an die Bitmap::FromHBITMAP-Methode eine GDI-Bitmap oder eine GDI-Palette, die derzeit (oder zuvor) in einem Gerätekontext ausgewählt wurde.

Diese Methode behält den Alphakanal der GDI-Quellbitbitte nicht bei.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll