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

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

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

ControlSetText

Изменяет текст контрола (элемента управления в окне).

ControlSetText [, Control, NewText, WinTitle, WinText, ExcludeTitle, ExcludeText]

Параметры

Control	Может задаваться как ClassNN (имя класса и номер данного экземпляра) или как имя/текст контрола. Все эти значения можно определить, используя программу Window Spy. При использовании имени/текста метод их поиска можно задавать командой SetTitleMatchMode. Если параметр пустой, используется верхний контрол окна. Чтобы указать контрол через его HWND (window handle, идентификатор окна), оставьте параметр Control пустым и задайте ahk_id %ControlHwnd% как значение параметра WinTitle - это работает также и для скрытых контролов, даже если обнаружение скрытых окон (команда DetectHiddenWindows) не включено. HWND, как правило, узнаётся через команды ControlGet Hwnd, MouseGetPos или DllCall.
NewText	Новый текст. Если опущен или пустой, контрол станет пустым.
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.

Примечания

Большинство контролов отмечает концы строк возвратом каретки и переводом строки (`r`n), а не одним только переводом строки (`n). Чтобы преобразовать текст, использующий `n к тексту, использующему `r`n, следуйте примеру ниже:

StringReplace, MyVar, MyVar, `n, `r`n, All

Для повышения надёжности после каждого выполнения этой команды автоматически делается пауза. Длина этой паузы может быть изменена командой SetControlDelay.

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

Пример

ControlSetText, Edit1, Здесь новый текст, Безымянный -

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