CreateBitmapIndirect-Funktion (wingdi.h)
Die CreateBitmapIndirect-Funktion erstellt eine Bitmap mit der angegebenen Breite, Höhe und dem angegebenen Farbformat (Farbebenen und Bits pro Pixel).
Syntax
HBITMAP CreateBitmapIndirect(
[in] const BITMAP *pbm
);
Parameter
[in] pbm
Ein Zeiger auf eine BITMAP-Struktur , die Informationen zur Bitmap enthält. Wenn eine Anwendung die Elemente bmWidth oder bmHeight auf null festlegt, gibt CreateBitmapIndirect das Handle auf eine monochrome Bitmap mit 1 x 1 Pixel zurück.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die Bitmap.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.
Diese Funktion kann die folgenden Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Mindestens ein Eingabeparameter ist ungültig. |
|
Die Bitmap ist zu groß, damit Arbeitsspeicher zugewiesen werden kann. |
Hinweise
Die CreateBitmapIndirect-Funktion erstellt eine geräteabhängige Bitmap.
Nachdem eine Bitmap erstellt wurde, kann sie in einem Gerätekontext ausgewählt werden, indem die SelectObject-Funktion aufgerufen wird. Die Bitmap kann jedoch nur in einem Gerätekontext ausgewählt werden, wenn die Bitmap und der DC das gleiche Format haben.
Während die CreateBitmapIndirect-Funktion zum Erstellen von Farb bitmaps verwendet werden kann, sollten Anwendungen aus Leistungsgründen CreateBitmapIndirect verwenden, um monochrome Bitmaps und CreateCompatibleBitmap zum Erstellen von Farbbitbitmaps zu erstellen. Wenn eine FarbbitmapIndirect in einem Gerätekontext ausgewählt wird, muss das System sicherstellen, dass die Bitmap dem Format des ausgewählten Gerätekontexts entspricht. Da CreateCompatibleBitmap einen Gerätekontext verwendet, wird eine Bitmap zurückgegeben, die das gleiche Format wie der angegebene Gerätekontext aufweist. Daher sind nachfolgende Aufrufe von SelectObject mit einer Farbbitbitmap aus CreateCompatibleBitmap schneller als mit einer Farbbitmap, die von CreateBitmapIndirect zurückgegeben wird.
Wenn die Bitmap monochrom ist, stellen Nullen die Vordergrundfarbe und die Hintergrundfarbe für den Zielgerätekontext dar.
Wenn Sie die Bitmap nicht mehr benötigen, rufen Sie die DeleteObject-Funktion auf, um sie zu löschen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h (einschließlich Windows.h) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |