Описание макросов | |
Макросы.
Ниже предоставлен список макросов, доступных в AutoIt.
Макросы можно подключить через команду exect
Список макросов, связанных с AutoIt.
Макрос | Описание |
---|---|
@error | Состояние флага ошибки. |
@extended | Дополнительное значение, возвращаемое некоторыми функциями. Например, StringReplace(). |
Дополнение к макросам @error и @extended. В команде exect невозможно получить данные этих макросов при выполнении встроенных команд Autoit. Вы можете создать свою функцию AU3 и получить информацию с помощью _InScript() Пример в скрипте ...\Files\Scripts\Func.au3 в функции Replace() | |
@NumParams | Число параметров, использованное при вызове функции пользователя. |
@ScriptName | Имя файла запущенного скрипта (с расширением). |
@ScriptDir | Путь к каталогу, содержащему выполняемый скрипт (Результат не содержит конечного обратного слеша) |
@ScriptFullPath | Эквивалентно @ScriptDir&'\'&@ScriptName |
@WorkingDir | Текущий активный/рабочий каталог (Результат не содержит конечного обратного слеша). См. функцию FileChangeDir() |
@AutoItExe | Полный путь к исполняемому файлу AutoIt, выполняющему запущенный скрипт. Для скомпилированных скриптов это полный путь к файлу скомпилированного скрипта. Для TCIMG - это полный путь к TCIMG.exe |
@AutoItPID | PID процесса, выполняющего запущенный скрипт. |
@AutoItVersion | Версия AutoIt, выполняющего скрипт. Например, '3.3.8.1' |
@AutoItX64 | Возвращает 1, если скрипт выполняется x64 версией AutoIt. Для TCIMG - это не актуально, т.к. версия x32 |
Для использования в функциях WinSetState(), Run(), RunWait() | |
@SW_DISABLE | Запретить доступ к окну. |
@SW_ENABLE | Разрешить доступ к окну. |
@SW_HIDE | Скрыть окно и активировать другое окно. |
@SW_LOCK | Заблокировать окно, чтобы избежать его перерисовки. |
@SW_MAXIMIZE | Развернуть окно на весь экран. |
@SW_MINIMIZE | Свернуть окно и активировать следующее окно верхнего уровня в Z-порядке |
@SW_RESTORE | Активировать и отобразить окно. Если окно свёрнуто или развёрнуто, система восстановит его оригинальный размер и позицию. |
@SW_SHOW | Активировать и отобразить окно с его текущим размером и позицией. |
@SW_SHOWDEFAULT | Установить состояние окна на основании флага SW_, установленного при запуске программы. |
@SW_SHOWMAXIMIZED | Активировать, развернуть и отобразить окно. |
@SW_SHOWMINIMIZED | Активировать, свернуть и отобразить окно. |
@SW_SHOWMINNOACTIVE | Свернуть и отобразить окно. |
@SW_SHOWNA | Отобразить окно с его текущим размером и позицией. |
@SW_SHOWNOACTIVATE | Отобразить окно с его последними размерами и позицией. |
@SW_SHOWNORMAL | Активировать и отобразить окно. Если окно свёрнуто или развёрнуто, система восстановит его оригинальный размер и позицию. |
@SW_UNLOCK | Разблокировать окно. |
@TrayIconFlashing | Возвращает 1, если иконка в трее мигает, иначе возвращает 0. |
@TrayIconVisible | Возвращает 1, если иконка в трее видима; иначе возвращает 0. |
@CR | Символ возврата каретки, Chr(13) |
@LF | Символ перевода строки, Chr(10) |
@CRLF | =@CR&@LF |
@TAB | Символ Tab, Chr(9) |
Список макросов различных каталогов. Обратите внимание, что возвращаемые пути к каталогам НЕ содержат конечного обратного слеша.
Макрос | Описание |
---|---|
Макросы к различным каталогам всех пользователей (All Users). Большинство значений берётся из HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion | |
@AppDataCommonDir | Путь к каталогу Application Data |
@DesktopCommonDir | Путь к каталогу Рабочий стол |
@DocumentsCommonDir | Путь к каталогу Документы |
@FavoritesCommonDir | Путь к каталогу Избранное |
@ProgramsCommonDir | Путь к каталогу Программы в главном меню |
@StartMenuCommonDir | Путь к каталогу Главное меню |
@StartupCommonDir | Путь к каталогу Автозагрузка |
Макросы к каталогам текущего пользователя (Current User). Большинство значений берётся из HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion | |
@AppDataDir | Путь к каталогу текущего пользователя Application Data |
@DesktopDir | Путь к каталогу текущего пользователя Рабочий стол |
@MyDocumentsDir | Путь к каталогу текущего пользователя Мои документы |
@FavoritesDir | Путь к каталогу текущего пользователя Избранное |
@ProgramsDir | Путь к каталогу текущего пользователя Программы в главном меню |
@StartMenuDir | Путь к каталогу текущего пользователя Главное меню |
@StartupDir | Путь к каталогу текущего пользователя Автозагрузка |
@UserProfileDir | Путь к каталогу, содержащему профиль текущего пользователя |
Макросы других каталогов: | |
@HomeDrive | Буква диска, содержащего каталог с профилем текущего пользователя (обычно 'C:') |
@HomePath | Часть пути к каталогу, содержащему профиль пользователя (Например, '\Documents and Settings\User') |
@HomeShare | Сетевое имя сервера, содержащего каталог с профилем текущего пользователя |
@LogonDNSDomain | Logon DNS Domain. |
@LogonDomain | Logon Domain. |
@LogonServer | Logon server. |
@ProgramFilesDir | Путь к каталогу Program Files |
@CommonFilesDir | Путь к каталогу Common Files |
@WindowsDir | Путь к каталогу Windows |
@SystemDir | Путь к каталогу Windows System (или System32) |
@TempDir | Путь к каталогу, содержащему временные файлы |
@ComSpec | Значение переменной среды %comspec% (SPECified secondary COMmand interpreter); для использования с командной строкой, к примеру Run(@ComSpec&' /k help | more') |
Список макросов системной информации.
Макрос | Описание |
---|---|
@CPUArch | Возвращает 'X86' если ЦП является 32-разрядным, и 'X64', если ЦП является 64-разрядным |
@KBLayout | Возвращает код текущей раскладки клавиатуры для окна AutoIt3; значение изменяется клавишами Alt+Shift в активном окне. См. приложение для просмотра возможных значений |
@MUILang | Возвращает код Multi Language (если доступно, в Vista доступно по умолчанию), иначе возвращает '0000'. См. приложение для просмотра возможных значений |
@OSArch | Возвращает одно из следующих значений: 'X86', 'IA64', 'X64' - это тип архитектуры запущенной операционной системы |
@OSLang | Возвращает код языка ОС. См. приложение для просмотра возможных значений |
@OSType | Возвращает 'WIN32_NT' в 2000/XP/2003/Vista/2008/Win7/2008R2 |
@OSVersion | Возвращает одно из следующих значений: 'WIN_11', 'WIN_10', 'WIN_2008R2', 'WIN_7', 'WIN_8', 'WIN_2008', 'WIN_VISTA', 'WIN_2003', 'WIN_XP', 'WIN_XPe', 'WIN_2000' |
@OSBuild | Возвращает номер сборки ОС. К примеру, на Windows 2003 Server макрос возвращает '3790' |
@OSServicePack | Возвращает информацию о установленном пакете обновления в виде 'Service Pack 3' |
@ComputerName | Возвращает сетевое имя компьютера |
@UserName | Возвращает ID пользователя (имя учётной записи), от чьего имени работает процесс, выполняющий скрипт. Внимание: это необязательно имя пользователя, выполнившего вход в систему |
@IPAddress1 | Возвращает IP-адрес первого сетевого адаптера. Может вернуть '127.0.0.1' на некоторых компьютерах |
@IPAddress2 | Возвращает IP-адрес второго сетевого адаптера. Возвращает '0.0.0.0', если неприменимо |
@IPAddress3 | Возвращает IP-адрес третьего сетевого адаптера. Возвращает '0.0.0.0', если неприменимо |
@IPAddress4 | Возвращает IP-адрес четвёртого сетевого адаптера. Возвращает '0.0.0.0', если неприменимо |
@DesktopHeight | Возвращает высоту рабочего стола в пикселях (вертикальное разрешение экрана) |
@DesktopWidth | Возвращает ширину рабочего стола в пикселях (горизонтальное разрешение экрана) |
@DesktopDepth | Возвращает глубину рабочего стола (качество цветопередачи экрана) в битах на пиксель (обычно 32 или 16) |
@DesktopRefresh | Возвращает частоту обновления экрана в герцах. |
Список макросов даты и времени. Длина большинства возвращаемых значений - два символа.