Функция _ScreenCapture_CaptureWnd

 ↑  ←  Описание функции


_ScreenCapture_CaptureWnd

Захватывает область экрана указанного окна или элемента

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

Параметры

$sFileName Полный путь файла с расширением
$hWnd Дескриптор окна для захвата
$iLeft [необязательный] X координата верхнего левого угла прямоугольника относительно окна.
$iTop [необязательный] Y координата верхнего левого угла прямоугольника относительно окна.
$iRight [необязательный] X координата правого нижнего угла прямоугольника относительно окна.
$iBottom [необязательный] Y координата правого нижнего угла прямоугольника относительно окна.
$fCursor [необязательный] Если True, то курсор тоже захватывается.

Возвращаемое значение

Если параметр $sFileName - пустая строка, то функция захватывает окно/элемент и возвращает дескриптор HBITMAP. Этот дескриптор должен быть освобожден с помощью _WinAPI_DeleteObject. Если в параметре $sFileName указан путь, то изображение сохраняется в файл и ничего не возвращает.

Примечания

Все координаты указываются относительно окна.

Требования GDI+: GDI+ необходимо распространять для приложений, которые запускаются в операционных системах Microsoft Windows 2000.

См. также

_WinAPI_DeleteObject

Пример

#include <ScreenCapture.au3>

_Main()

Func _Main()
    Local $hGUI

    ; Создаёт GUI
    $hGUI = GUICreate("Screen Capture", 400, 300)
    GUISetState()

    ; Захватывает окно
    _ScreenCapture_CaptureWnd (@MyDocumentsDir & "\GDIPlus_Image.jpg", $hGUI)

EndFunc   ;==>_Main