Перейти на главную страничку сайта (список статей, файлы для скачивания)

ФОРУМ (здесь можно обсудить эту статью, а также саму программу AutoHotkey и проблемы её использования)

Проект перевода документации AutoHotkey: перечень переведённых статей и статей в работе.

Оригинал статьи в AutoHotkey.chm: "StatusBarGetText", в содержании - "Window Management" - "StatusBarGetText", v1.0.46.07.

Ник переводчика: YMP.

Настоящее имя переводчика: Юрий Попов.

StatusBarGetText

Считывает текст из стандартной строки состояния окна.

StatusBarGetText, OutputVar [, Part#, WinTitle, WinText, ExcludeTitle, ExcludeText]

Параметры

OutputVar Имя переменной, куда будет помещён считанный текст.
Part# Номер части строки состояния, из которой будет считан текст (может быть выражением). Значение по умолчанию 1; обычно именно эта часть содержит текст, представляющий интерес.
WinTitle Заголовок или часть заголовка окна (метод поиска можно задавать командой SetTitleMatchMode). Если этот и следующие 3 параметра опущены, будет использовано последнее найденное окно. Если параметр задан буквой А и следующие 3 параметра опущены, будет использовано активное окно. Чтобы задать окно через его класс, используйте конструкцию ahk_class ТочноеИмяКласса (можно посмотреть программой Window Spy). Чтобы использовать идентификатор процесса (PID), задайте параметр как ahk_pid %ПеременнаяСодержащаяPID%. Чтобы использовать группу окон, задайте параметр как ahk_group ИмяГруппы. Чтобы использовать идентификатор окна, задайте параметр как ahk_id %ПеременнаяСодержащаяID%. Сектор поиска можно сузить, задав несколько критериев, например, My File.txt ahk_class Notepad.
WinText Подстрока из одиночного текстового элемента окна (можно посмотреть программой Window Spy). Скрытые текстовые элементы определяются, если включено определение скрытого текста (команда DetectHiddenText).
ExcludeTitle Окна, чей заголовок включает значение этого параметра, исключаются.
ExcludeText Окна, чей текст включает значение этого параметра, исключаются.

ErrorLevel

Ноль, если команда выполнена успешно; иначе 1. В случае неудачи выходная переменная будет пустой.

Примечания

Эта команда пытается прочитать первую стандартную строку состояния окна (Microsoft common control: msctls_statusbar32). Некоторые программы используют свои собственные строки состояния или специальные версии Microsoft common control; в этих случаях их текст не может быть считан.

Вместо того, чтобы использовать эту команду в цикле, обычно лучше воспользоваться командой StatusBarWait, которая содержит улучшения, позволяющие избежать последствий большого количества повторных вызовов StatusBarGetText.

Заголовки и текст окон чувствительны к регистру. Скрытые окна не определяются, если только это не задано командой DetectHiddenWindows.

Пример

StatusBarGetText, RetrievedText, 1, Результаты поиска
IfInString, RetrievedText, Найдено, MsgBox, Поиск завершён.

Перейти на главную страничку сайта (список статей, файлы для скачивания)

© 2007 http://www.script-coding.com При любом использовании материалов сайта обязательна ссылка на него как на источник информации, а также сохранение целостности и авторства материалов.