GdipGetImageBounds

Aus API-Wiki
Version vom 1. Oktober 2008, 23:24 Uhr von Nils Thomsen (Diskussion | Beiträge)

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

Über die API-Funktion GdipGetImageBounds erhalten Sie die Höhe und die Breite in Pixel von einem GDI+ Bitmap- oder Image-Objekt.

Declare Function GdipGetImageBounds Lib "GdiPlus.dll" ( _
                 ByVal image As Long, _
                 ByRef srcRect As RECTF, _
                 ByRef srcUnit As Unit) As Status

Parameter:

image

Zeiger auf ein GDI+ Bitmap- oder Image-Objekt.

srcRect

Zeiger auf eine RECTF-Struktur, in der die Abmaße des GDI+ Bitmap- oder Image-Objektes gespeichert werden.

srcUnit

Zeiger auf die Unit-Enumeration. Hier wird der Wert zurückgegeben, in welchem GDI+ ScaleMode die Werte in der RECTF-Struktur vorliegen.

Beispiel:

Dim tRECTF as RECTF
Dim eUnit as Unit

If GdipGetImageBounds(lngImage, tRECTF, eUnit) <> OK Then

    MsgBox "Fehler beim ermitteln der Abmaße vom GDI+ Bitmap-Objekt!", _
        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 die GDI+ Funktion GdipGetImageBounds verwenden können, müssen Sie GdiplusStartup ausführen.

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 GdipGetImageBounds ist unter folgenden Betriebssystemen funktionsfähig:

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