Funktionreferenz


_ScreenCapture_CaptureWnd

Beschreibung anzeigen in

Erstellt von einem bestimmten Fenster oder einer Control-ID einen Screenshot

#include <ScreenCapture.au3>
_ScreenCapture_CaptureWnd ( $sFileName, $hWnd [, $iLeft = 0 [, $iTop = 0 [, $iRight = -1 [, $iBottom = -1 [, $bCursor = True]]]]] )

Parameter

$sFileName Kompletter Pfad, Dateiname und Erweiterung der Bilddatei
$hWnd Handle des Fensters
$iLeft [optional] X Koordinate des linken oberen Ecks des Rechtecks des Fensters
$iTop [optional] Y Koordinate des linken oberen Ecks des Rechtecks des Fensters
$iRight [optional] X Koordinate des rechten unteren Ecks des Rechtecks
$iBottom [optional] Y Koordinate des rechten unteren Ecks des Rechtecks
$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

Alle Koordinaten beziehen sich auf den Anwendungsbereich des Fensters.
Dieses Handle muss durch _WinAPI_DeleteObject() wieder gelöscht werden.

Verwandte Funktionen

_WinAPI_DeleteObject

Beispiel

#include <ScreenCapture.au3>

Example()

Func Example()
    Local $hGui

    ; Erstellt eine GUI
    $hGui = GUICreate("Bildschirmaufnahme", 400, 300)
    GUISetState(@SW_SHOW)
    Sleep(250)

    ; Erstellt einen Screenshot von einem Fenster
    _ScreenCapture_CaptureWnd(@MyDocumentsDir & "\GDIPlus_Image.jpg", $hGui)

    ShellExecute(@MyDocumentsDir & "\GDIPlus_Image.jpg")
EndFunc   ;==>Example