GdipCreateBitmapFromGdiDib

Aus API-Wiki
Zur Navigation springenZur Suche springen
Die druckbare Version wird nicht mehr unterstützt und kann Darstellungsfehler aufweisen. Bitte aktualisiere deine Browser-Lesezeichen und verwende stattdessen die Standard-Druckfunktion des Browsers.

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!", _
        vbCritical, "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