GdipCreateBitmapFromFile: Unterschied zwischen den Versionen
Aus API-Wiki
(Die Seite wurde neu angelegt: __NOTOC__ ===== ===== Die API-Funktion '''GdipCreateBitmapFromFile''' lädt eine Bilddatei und erstellt ein GDI+ Bitmap-Objekt. Folgende Bildformate können über GdipC...) |
|||
| (5 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
__NOTOC__ | __NOTOC__ | ||
| − | + | == == | |
Die API-Funktion '''GdipCreateBitmapFromFile''' lädt eine Bilddatei und erstellt ein GDI+ Bitmap-Objekt. Folgende Bildformate können über GdipCreateBitmapFromFile geladen werden: BMP, DIB, RLE, JPG, JPEG, JPE, JFIF, GIF, EMF, WMF, TIF, TIFF, PNG, ICO | Die API-Funktion '''GdipCreateBitmapFromFile''' lädt eine Bilddatei und erstellt ein GDI+ Bitmap-Objekt. Folgende Bildformate können über GdipCreateBitmapFromFile geladen werden: BMP, DIB, RLE, JPG, JPEG, JPE, JFIF, GIF, EMF, WMF, TIF, TIFF, PNG, ICO | ||
| − | < | + | <syntaxhighlight lang="vb">Declare Function GdipCreateBitmapFromFile Lib "GdiPlus.dll" ( _ |
| − | Declare Function GdipCreateBitmapFromFile Lib "GdiPlus.dll" ( _ | ||
ByVal FileName As Long, _ | ByVal FileName As Long, _ | ||
| − | ByRef bitmap As Long) As Status | + | ByRef bitmap As Long) As Status</syntaxhighlight> |
| − | </ | ||
| − | + | ==Parameter:== | |
''FileName'' | ''FileName'' | ||
:Zeiger auf einen Unicodestring, der den Pfad zu einer Bilddatei enthält. Die Übergabe des Strings muss mit StrPtr() erfolgen | :Zeiger auf einen Unicodestring, der den Pfad zu einer Bilddatei enthält. Die Übergabe des Strings muss mit StrPtr() erfolgen | ||
| + | |||
''bitmap'' | ''bitmap'' | ||
:Zeiger auf eine Variable vom Typ Long, welche den Zeiger auf das GDI+ Bitmap-Objekt aufnehmen kann | :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. | :Das GDI+ Bitmap-Objekt muss, wenn es nicht mehr verwendet wird, mit dem zurückgegebenen Zeiger mittels [[GdipDisposeImage]] wieder gelöscht werden. | ||
| − | + | ==Beispiel:== | |
| − | < | + | <syntaxhighlight lang="vb">Dim strFileName As String |
| − | Dim strFileName As String | ||
Dim lngImage As Long | Dim lngImage As Long | ||
| Zeile 28: | Zeile 26: | ||
vbCritical, "Fehler!" | vbCritical, "Fehler!" | ||
| − | End If | + | End If</syntaxhighlight> |
| − | </ | ||
| − | + | ==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. | 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. | 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. | ||
| Zeile 42: | Zeile 39: | ||
Beachten Sie unbedingt die Hinweise zur Installation der GdiPlus.dll in der redist.txt, die im "GDI+ Platform SDK Redistributable Paket" enthalten ist. | 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 '''GdipCreateBitmapFromFile''' ist unter folgenden Betriebssystemen funktionsfähig: | Die API-Funktion '''GdipCreateBitmapFromFile''' ist unter folgenden Betriebssystemen funktionsfähig: | ||
| Zeile 48: | Zeile 45: | ||
*Windows NT 4.0 SP6 und später | *Windows NT 4.0 SP6 und später | ||
| − | + | [[Kategorie:GDIPlus]] | |
| − | |||
| − | [[Kategorie: | ||
Aktuelle Version vom 5. November 2016, 23:47 Uhr
Die API-Funktion GdipCreateBitmapFromFile lädt eine Bilddatei und erstellt ein GDI+ Bitmap-Objekt. Folgende Bildformate können über GdipCreateBitmapFromFile geladen werden: BMP, DIB, RLE, JPG, JPEG, JPE, JFIF, GIF, EMF, WMF, TIF, TIFF, PNG, ICO
Declare Function GdipCreateBitmapFromFile Lib "GdiPlus.dll" ( _
ByVal FileName As Long, _
ByRef bitmap As Long) As Status
Parameter:
FileName
- Zeiger auf einen Unicodestring, der den Pfad zu einer Bilddatei enthält. Die Übergabe des Strings muss mit StrPtr() 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 strFileName As String
Dim lngImage As Long
strFileName = "C:\Image.bmp"
If GdipCreateBitmapFromFile(StrPtr(strFileName), 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 GdipCreateBitmapFromFile ist unter folgenden Betriebssystemen funktionsfähig:
- Windows 98 und später
- Windows NT 4.0 SP6 und später
