_ScreenCapture_Capture
Beschreibung anzeigen in
Erstellt von einem Bereich des Bildschirms einen Screenshot
#include <ScreenCapture.au3>
_ScreenCapture_Capture ( [$sFileName = "" [, $iLeft = 0 [, $iTop = 0 [, $iRight = -1 [, $iBottom = -1 [, $bCursor = True]]]]]] )
Parameter
| $sFileName | [optional] Kompletter Pfad, Dateiname und Erweiterung der Bilddatei |
| $iLeft | [optional] X Koordinate des linken oberen Ecks des Rechtecks |
| $iTop | [optional] Y Koordinate des linken oberen Ecks des Rechtecks |
| $iRight | [optional] X Koordinate des rechten unteren Ecks des Rechtecks. Falls dies auf -1 gesetzt wird, wird die komplette Breite des Bildschirms genutzt. |
| $iBottom | [optional] Y Koordinate des rechten unteren Ecks des Rechtecks. Falls dies auf -1 gesetzt wird, wird die komplette Höhe des Bildschirms genutzt. |
| $bCursor | [optional] Falls "True", erscheint der Cursor auch auf dem erstellten Bild |
Rückgabewert
| Erfolg: | ein Handle zu einem HBITMAP, falls $sFileName leer ist oder True falls der Aufruf mit $sFileName erfolgte und das Bild erfolgreich gespeichert wurde. |
| Fehler: | Setzt das @error Flag auf ungleich null. |
Bemerkungen
Falls $sFileName nicht leer ist, wird ein Screenshot vom Bildschirm erstellt und in eine Datei gespeichert. Falls $sFileName leer ist, wird ein Screenshot vom Bildschirm erstellt und ein HBITMAP-Handle zu einem Bitmap-Bild zurückgegeben. In diesem Fall muss nach dem Ende der Verwendung der Bitmap durch Aufruf der Funktion _WinAPI_DeleteObject() das Bitmap-Handle freigegeben werden.
Verwandte Funktionen
_ScreenCapture_SaveImage, _WinAPI_DeleteObject
Beispiel
#include <ScreenCapture.au3>
Example()
Func Example()
; Erstellt einen Screenshot vom kompletten Bildschirm
_ScreenCapture_Capture(@MyDocumentsDir & "\GDIPlus_Image1.jpg")
ShellExecute(@MyDocumentsDir & "\GDIPlus_Image1.jpg")
; Erstellt einen Screenshot von einem Bereich
_ScreenCapture_Capture(@MyDocumentsDir & "\GDIPlus_Image2.jpg", 0, 0, 796, 596)
ShellExecute(@MyDocumentsDir & "\GDIPlus_Image2.jpg")
EndFunc ;==>Example