CreateBitmap

Deklaration  

Declare Function CreateBitmap Lib "gdi32" ( _
                 ByVal nWidth As Long, _
                 ByVal nHeight As Long, _
                 ByVal nPlanes As Long, _
                 ByVal nBitCount As Long, _
                 lpBits As Any) As Long

Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel CreateBitmap des API-Wikis.

CreateBitmap erzeugt eine Bitmap, basierend auf einem Array mit Farbbitwerten und in der angegebenen Breite und Höhe sowie dem gewünschten Farbformat (Farbebenen und Bits pro Pixel).

Parameter
nWidth	Breite der Bitmap, angegeben in Pixeln.
nHeight	Höhe der Bitmap, angegeben in Pixeln.
nPlanes	Die Anzahl der Farbebenen der Bitmap.
nBitCount	Die Anzahl der Bits, die für die Beschreibung der Farbe eines einzelnen Pixels benötigt wird.
lpBits	Ein Zeiger auf ein Array mit Bytewerten, die die Pixeldaten enthalten. Jede Scan-Zeie im Rechteck muß an einer Wortgrenze ausgerichtet sein (Scan-Zeilen, die nicht an Wortgrenzen ausgerichtet sind, müssen mit Nullen aufgefüllt werden). Wird Dieser Parameter auf Null gesetzt, ist die Bitmap undefiniert.

Tabelle 1

Rückgabewerte
Long	Das Handle der neuen Bitmap.
0	Für den Fehlerfall.

Tabelle 2

Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
CreateBitmapIndirect, BitBlt, SelectObject, DeleteObject

Zugehörige Tipps

• Masken für transparente Bitmaps erstellen [Tipp 0112]
• Bitmap transparent in eine andere Grafik einbinden [Tipp 0114]

Zugehörige Microsoft Knowledge Base Artikel

• HOWTO: Create a Transparent Picture For Office CommandBar Buttons