_WinAPI_CopyImage
Beschreibung anzeigen in
Erzeugt ein neues Bild (Symbol, Cursor oder Bitmap) und kopiert die Attribute des angegebenen Bildes in das neue Bild
#include <WinAPIGdi.au3>
_WinAPI_CopyImage ( $hImage [, $iType = 0 [, $iXDesiredPixels = 0 [, $iYDesiredPixels = 0 [, $iFlags = $LR_DEFAULTCOLOR]]]] )
Parameter
| $hImage | Handle zu dem zu kopierenden Bild. |
| $iType | [optional] Gibt den Typ des zu kopierenden Bildes an. Dieser Parameter kann einen der folgenden Werte sein: $IMAGE_BITMAP 'Default) $IMAGE_CURSOR $IMAGE_ICON |
| $iXDesiredPixels | [optional] Gibt die gewünschte Breite des Bildes in Pixeln an. Ist dieser Wert gleich Null (Standard), hat das zurückgegebene Bild die gleiche Breite wie das Originalbild $hImage. |
| $iYDesiredPixels | [optional] Gibt die gewünschte Höhe des Bildes in Pixeln an. Ist dieser Wert gleich Null (Standard), hat das zurückgegebene Bild die gleiche Höhe wie das Originalbild $hImage. |
| $iFlags | [optional] Dieser Parameter kann einen oder mehrere der folgenden Werte sein. $LR_DEFAULTCOLOR (Default) $LR_COPYDELETEORG $LR_COPYFROMRESOURCE $LR_COPYRETURNORG $LR_CREATEDIBSECTION $LR_DEFAULTSIZE $LR_MONOCHROME |
Rückgabewert
| Erfolg: | Handle zum neu erstellten Bild. |
| Fehler: | 0. Es ist _WinAPI_GetLastError() aufzurufen, um erweiterte Fehlerinformationen zu erhalten. |
Bemerkungen
Wenn man die Ressource nicht mehr verwendet, kann man den zugehörigen Speicher freigeben, indem man die _WinAPI_DeleteObject() Funktion für Bitmaps, Cursor oder Icons aufruft.
Das System löscht die Ressource automatisch, wenn der Prozess beendet wird. Der Aufruf der entsprechenden Funktion spart jedoch Speicher und verringert die Größe der Arbeitsmenge des Prozesses.
Siehe auch
Suche nach CopyImage in der MSDN Bibliothek.