GdipGetImageGraphicsContext

Aus API-Wiki
Version vom 7. März 2007, 21: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)
Zur Navigation springenZur Suche springen

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


Diese Deklaration wurde von Frank Schüler erstellt. Sollten Sie Fragen zur Verwendung der entsprechenden Funktion haben, so verwenden Sie hierfür bitte das Visual Basic Forum, die Artikeldiskussionsseite oder die Nutzerdiskussionsseite.