GdipCreateBitmapFromGdiDib
Die API-Funktion GdipCreateBitmapFromGdiDib erstellt ein GDI+ Bitmap-Objekt aus den Daten zu einer geräteunabängigen Bitmap (DIB).
Declare Function GdipCreateBitmapFromGdiDib Lib "GdiPlus.dll" ( _ ByRef GdiBitmapInfo As BITMAPINFO, _ ByVal GdiBitmapData As Long, _ ByRef bitmap As Long) As Status
Parameter:
GdiBitmapInfo
- Zeiger auf eine BITMAPINFO-Struktur.
GdiBitmapData
- Zeiger auf ein Bytefeld, das die Pixeldaten der geräteunabängigen Bitmap enthält. Die Übergabe des Bytefeldes muss mit VarPtr() erfolgen.
bitmap
- Zeiger auf eine Variable vom Typ Long, welche den Zeiger auf das GDI+ Bitmap-Objekt aufnehmen kann
- Das GDI+ Bitmap-Objekt muss, wenn es nicht mehr verwendet wird, mit dem zurückgegebenen Zeiger mittels GdipDisposeImage wieder gelöscht werden.
Beispiel:
Dim lngImage As Long Dim tBITMAPINFO As BITMAPINFO Dim bytPixelData() As Byte ' BITMAPINFO-Struktur füllen ' bytPixelData dimesionieren und mit den Pixeldaten füllen If GdipCreateBitmapFromGdiDib(tBITMAPINFO, VarPtr(bytPixelData(0)), _ lngImage) <> OK Then MsgBox "Fehler beim erstellen des GDI+ Bitmap-Objektes!", _ <syntaxhighlight lang="vb">Critical, "Fehler!" End If
Rückgabe(n):
War der Aufruf der Funktion erfolgreich wird "OK" aus der Enumeration Status zurückgegeben. Im Fehlerfall wird Ihnen ein anderer Wert aus der Enumeration Status zurückgegeben.
Hinweise:
Bevor Sie GDI+ Objekte erstellen können, müssen Sie GdiplusStartup ausführen und bevor Sie GdiplusShutdown ausführen müssen alle GDI+ Objekte gelöscht werden.
Ab Windows XP ist GDI+ standardmäßig installiert. Für alle anderen unterstützten Betriebssysteme kann das "GDI+ Platform SDK Redistributable Paket" unter folgender Adresse kostenlos herruntergeladen werden. GDI+ Platform SDK Redistributable Paket
Beachten Sie unbedingt die Hinweise zur Installation der GdiPlus.dll in der redist.txt, die im "GDI+ Platform SDK Redistributable Paket" enthalten ist.
Betriebssystem:
Die API-Funktion GdipCreateBitmapFromGdiDib ist unter folgenden Betriebssystemen funktionsfähig:
- Windows 98 und später
- Windows NT 4.0 SP6 und später