GdipGetImageGraphicsContext

Aus API-Wiki
Version vom 7. März 2007, 22:44 Uhr von Frank Schüler (Diskussion | Beiträge) (Die Seite wurde neu angelegt: __NOTOC__ ===== ===== Die API-Funktion '''GdipGetImageGraphicsContext''' erstellt ein GDI+ Graphics-Objekt von einem GDI+ Bitmap- oder Image-Objekt. Auf einem Graphics-...)

(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu: Navigation, Suche

Die API-Funktion GdipGetImageGraphicsContext erstellt ein GDI+ Graphics-Objekt von einem GDI+ Bitmap- oder Image-Objekt. Auf einem Graphics-Objekt können Sie mit diversen GdipDraw-Funktionen zeichnen.

Declare Function GdipGetImageGraphicsContext Lib "GdiPlus.dll" ( _
                 ByVal image As Long, _
                 ByRef graphics As Long) As Status
Parameter:

image

Zeiger auf ein GDI+ Bitmap- oder Image-Objekt

graphics

Zeiger auf eine Variable vom Typ Long, welche den Zeiger auf das GDI+ Graphics-Objekt aufnehmen kann.
Das GDI+ Graphics-Objekt muss, wenn es nicht mehr verwendet wird, mit dem zurückgegebenen Zeiger mittels GdipDeleteGraphics wieder gelöscht werden.
Beispiel:
Dim lngGraphics As Long

If GdipGetImageGraphicsContext(lngImage, lngGraphics) <> OK Then

    MsgBox "Fehler beim erstellen des GDI+ Graphics-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 GdipGetImageGraphicsContext ist unter folgenden Betriebssystemen funktionsfähig:

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

Benutzer:Bernhard Döbler/Vorlage:Zuständig