GdipCreateBitmapFromGraphics

Aus API-Wiki
Version vom 1. Oktober 2008, 22:20 Uhr von Nils Thomsen (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springenZur Suche springen

Die API-Funktion GdipCreateBitmapFromGraphics erstellt ein GDI+ Bitmap-Objekt von einem GDI+ Graphics-Objekt.

Declare Function GdipCreateBitmapFromGraphics Lib "GdiPlus.dll" ( _
                 ByVal Width As Long, _
                 ByVal Height As Long, _
                 ByVal target As Long, _
                 ByRef bitmap As Long) As Status

Parameter:

Width

Breite des zuerstellenden GDI+ Bitmap-Objektes

Height

Höhe des zuerstellenden GDI+ Bitmap-Objektes

target

Zeiger auf ein GDI+ Graphics-Objekt, vom dem das GDI+ Bitmap-Objekt erstellt werden soll

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

If GdipCreateBitmapFromGraphics(100, 100, lngGraphics, _
    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 GdipCreateBitmapFromGraphics ist unter folgenden Betriebssystemen funktionsfähig:

  • Windows 98 und später
  • Windows NT 4.0 SP6 und später