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

WinActivate

Активирует указанное окно (передаёт ему фокус).

WinActivate ( "title" [, "text" ] )

Параметры

title Заголовок/дескриптор/класс окна. См. заголовки и текст окон (расширенные).
text [необязательный] Текст окна.

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

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

Примечания

Можно использовать функцию WinActive(), чтобы узнать об успехе (или неудаче) функции WinActivate(). Если несколько окон соответствуют критерию, будет активировано самое недавнее активное окно. WinActivate() может работать со свёрнутыми окнами. Обратите внимание, что окна с атрибутом "Всегда поверх всех окон" по-прежнему будут отображаться поверх активированного окна.

@extended содержит дополнительную информацию о выполнении процесса активации (0 - окно не найдено, 1 - окно было активно, 2 - окно было неактивно).

См. также

WinClose, WinSetState, WinTitleMatchMode (Опция), WinKill, WinMove

Пример

; Запуск блокнота свёрнутым
Run('notepad.exe', '', @SW_MINIMIZE)

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

; Делает блокнот активным окном.
WinActivate($hWnd)

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