GdipCreateBitmapFromHBITMAP: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
K ()
K
Zeile 1: Zeile 1:
 
__NOTOC__
 
__NOTOC__
===== =====
+
== ==
 
Die API-Funktion '''GdipCreateBitmapFromHBITMAP''' erstellt ein GDI+ Bitmap-Objekt von einem Handle auf ein GDI Bitmap-Objekt und einem Handle auf eine GDI Palette.
 
Die API-Funktion '''GdipCreateBitmapFromHBITMAP''' erstellt ein GDI+ Bitmap-Objekt von einem Handle auf ein GDI Bitmap-Objekt und einem Handle auf eine GDI Palette.
  
Zeile 10: Zeile 10:
 
</pre>
 
</pre>
  
=====Parameter:=====
+
==Parameter:==
 
''hbm''
 
''hbm''
 
:Handle auf ein GDI Bitmap-Objekt
 
:Handle auf ein GDI Bitmap-Objekt
Zeile 19: Zeile 19:
 
: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:=====
+
==Beispiel:==
 
<PRE>
 
<PRE>
 
Dim lngImage As Long
 
Dim lngImage As Long
Zeile 32: Zeile 32:
 
</PRE>
 
</PRE>
  
=====Rückgabe(n):=====
+
==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:=====
+
==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 43: Zeile 43:
 
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:=====
+
==Betriebssystem:==
 
Die API-Funktion '''GdipCreateBitmapFromHBITMAP''' ist unter folgenden Betriebssystemen funktionsfähig:
 
Die API-Funktion '''GdipCreateBitmapFromHBITMAP''' ist unter folgenden Betriebssystemen funktionsfähig:
  

Version vom 25. März 2007, 20:55 Uhr

Die API-Funktion GdipCreateBitmapFromHBITMAP erstellt ein GDI+ Bitmap-Objekt von einem Handle auf ein GDI Bitmap-Objekt und einem Handle auf eine GDI Palette.

Declare Function GdipCreateBitmapFromHBITMAP Lib "GdiPlus.dll" ( _
                 ByVal hbm As Long, _
                 ByVal hpal As Long, _
                 ByRef bitmap As Long) As Status

Parameter:

hbm

Handle auf ein GDI Bitmap-Objekt

hpal

Handle auf eine GDI Palette, das die Farbinformationen für das in hbm angegebene GDI Bitmap-Objekt enthält, falls es sich nicht um eine DIB-Bitmap handelt. Handet es sich um eine DIB-Bitmap, kann hier 0& übergeben werden.

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 GdipCreateBitmapFromHBITMAP(Picture1.Picture.Handle, _
    0&, 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 GdipCreateBitmapFromHBITMAP 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