Функция WinWait

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


WinWait

Приостановить выполнение скрипта до появления указанного окна.

WinWait ( "title" [, "text" [, timeout = 0 ]] )

Параметры

title Заголовок/дескриптор/класс окна. См. заголовки и текст окон (расширенные).
text [необязательный] Текст окна.
timeout [необязательный] Тайм-аут в секундах. По умолчанию 0 - бесконечное ожидание.

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

Успех:Возвращает дескриптор указанного окна.
Ошибка:Возвращает 0, если выход по тайм-ауту.

См. также

WinActive, WinExists, WinWaitActive, WinWaitClose, WinWaitNotActive, WinWaitDelay (Опция), ProcessWait

Пример

; Запуск блокнота
Run('notepad.exe')

; Ожидание максимум 5 секунд до момента, когда оно станет существующим
$hWnd = WinWait("[CLASS:Notepad]", "", 5) ; без таймаута (5) ожидание бесконечно
If Not $hWnd Then
    MsgBox(4096, 'Сообщение', 'Окно не найдено, завершаем работу скрипта')
    Exit
EndIf

; Ожидание 1 секунды чтобы показать окно, перед тем как закрыть его.
Sleep(1000)

; Закрывает блокнот.
WinClose($hWnd)