UDF > ScreenCapture >


_ScreenCapture_Capture

Capture une région de l'écran

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

Paramètres

$sFileName [optionnel] Chemin complet avec nom et extension du fichier image
$iLeft [optionnel] Coordonnée X du coin supérieur gauche du rectangle
$iTop [optionnel] Coordonnée Y du coin supérieur gauche du rectangle
$iRight [optionnel] Coordonnée X du coin inférieur droit du rectangle. Si c'est -1, la largeur actuelle de l'écran sera utilisée.
$iBottom [optionnel] Coordonnée Y du coin inférieur droit du rectangle. Si c'est -1, la hauteur actuelle de l'écran sera utilisée.
$bCursor [optionnel] Si True, le curseur sera capturé avec l'image

Valeur de retour

Succès: Retourne le handle du HBITMAP si $sFileName est vide,
ou True si la fonction est appelée avec $sFileName et si l'image est enregistrée avec succès.
Échec: Définit @error <> 0.

Remarque

Si un handle est retourné, il doit être libéré à l'aide de _WinAPI_DeleteObject().

En relation

_ScreenCapture_SaveImage, _WinAPI_DeleteObject

Exemple

#include <ScreenCapture.au3>

Example()

Func Example()
    ; Capture un écran complet
    _ScreenCapture_Capture(@MyDocumentsDir & "\GDIPlus_Image1.jpg")

    ShellExecute(@MyDocumentsDir & "\GDIPlus_Image1.jpg")

    ; Capture une région
    _ScreenCapture_Capture(@MyDocumentsDir & "\GDIPlus_Image2.jpg", 0, 0, 796, 596)

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