Описание макросов

Ниже предоставлен полный список макросов, доступных в AutoIt.

Макрос Описание

@AppDataCommonDir Путь к каталогу Application Data

@AppDataDir Путь к каталогу текущего пользователя Application Data

@AutoItExe Полный путь к исполняемому файлу AutoIt, выполняющему запущенный скрипт. Для скомпилированных скриптов это полный путь к файлу скомпилированного скрипта.

@AutoItPID PID процесса, выполняющего запущенный скрипт.

@AutoItVersion Версия AutoIt, выполняющего скрипт. Например, "3.3.8.1"

@AutoItX64 Возвращает 1, если скрипт выполняется x64 версией AutoIt.

@COM_EventObj Ссылка на объект COM, инициировавший событие. Применимо только к функциям обрабатывающим события COM.

@CommonFilesDir Путь к каталогу Common Files

@Compiled Возвращает 1, если выполняемый скрипт скомпилирован, иначе возвращает 0.

@ComputerName Возвращает сетевое имя компьютера

@ComSpec Значение переменной среды %comspec% (SPECified secondary COMmand interpreter);
для использования с командной строкой, к примеру Run(@ComSpec & " /k help | more")

@CPUArch Возвращает "X86" если ЦП является 32-разрядным, и "X64", если ЦП является 64-разрядным

@CR Символ возврата каретки, Chr(13)

@CRLF = @CR & @LF

@DesktopCommonDir Путь к каталогу Рабочий стол

@DesktopDepth Возвращает глубину рабочего стола (качество цветопередачи экрана) в битах на пиксель (обычно 32 или 16)

@DesktopDir Путь к каталогу текущего пользователя Рабочий стол

@DesktopHeight Возвращает высоту рабочего стола в пикселях (вертикальное разрешение экрана)

@DesktopRefresh Возвращает частоту обновления экрана в герцах.

@DesktopWidth Возвращает ширину рабочего стола в пикселях (горизонтальное разрешение экрана)

@DocumentsCommonDir Путь к каталогу Документы

@error Состояние флага ошибки. См. функцию SetError().

@exitCode Код выхода, установленный функцией Exit.

@exitMethod См. функцию OnAutoItExitRegister().

@extended Дополнительное значение, возвращаемое некоторыми функциями. Например, StringReplace().

@FavoritesCommonDir Путь к каталогу Избранное

@FavoritesDir Путь к каталогу текущего пользователя Избранное

@GUI_CtrlHandle Дескриптор последнего нажатого управляющего элемента GUI. Применимо только к функциям, обрабатывающим события GUI. См. функцию GUICtrlSetOnEvent().

@GUI_CtrlId Идентификатор последнего нажатого управляющего элемента GUI. Применимо только к функциям, обрабатывающим события GUI. См. функцию GUICtrlSetOnEvent().

@GUI_DragFile Путь файла перетаскиваемого на элемент. Применяется только для события перетаскивания $GUI_EVENT_DROPPED. См. функцию GUIGetMsg(), GUISetOnEvent().

@GUI_DragId Идентификатор захваченного элемента GUI для операции перетащить и бросить. Применяется только для события перетаскивания $GUI_EVENT_DROPPED. См. функцию GUIGetMsg(), GUISetOnEvent().

@GUI_DropId Идентификатор элемента, на который брошен объект (файл или элемент). Применяется только для события перетаскивания $GUI_EVENT_DROPPED. См. функцию GUIGetMsg(), GUISetOnEvent().

@GUI_WinHandle Дескриптор последнего нажатого окна GUI. Применимо только к функциям, обрабатывающим события GUI. См. функцию GUICtrlSetOnEvent().

@HomeDrive Буква диска, содержащего каталог с профилем текущего пользователя (обычно "C:")

@HomePath Часть пути к каталогу, содержащему профиль пользователя (Например, "\Documents and Settings\User")

@HomeShare Сетевое имя сервера, содержащего каталог с профилем текущего пользователя

@HotKeyPressed Последняя нажатая горячая клавиша. См. функцию HotKeySet()

@HOUR Возвращает значение часов на часах в 24-часовом формате. Диапазон значений от 00 до 23

@IPAddress1 Возвращает IP-адрес первого сетевого адаптера. Может вернуть "127.0.0.1" на некоторых компьютерах

@IPAddress2 Возвращает IP-адрес второго сетевого адаптера. Возвращает "0.0.0.0", если неприменимо

@IPAddress3 Возвращает IP-адрес третьего сетевого адаптера. Возвращает "0.0.0.0", если неприменимо

@IPAddress4 Возвращает IP-адрес четвёртого сетевого адаптера. Возвращает "0.0.0.0", если неприменимо

@KBLayout Возвращает код текущей раскладки клавиатуры для окна AutoIt3; значение изменяется клавишами Alt+Shift в активном окне. См. приложение для просмотра возможных значений

@LF Символ перевода строки, Chr(10)

@LogonDNSDomain Logon DNS Domain.

@LogonDomain Logon Domain.

@LogonServer Logon server.

@MDAY Возвращает номер текущего дня месяца. Диапазон значений от 01 до 31

@MIN Возвращает значение минут на часах. Диапазон значений от 00 до 59

@MON Возвращает номер текущего месяца. Диапазон значений от 01 до 12

@MSEC Возвращает значение миллисекунд на часах. Диапазон значений от 000 до 999

@MUILang Возвращает код Multi Language (если доступно, в Vista доступно по умолчанию), иначе возвращает "0000". См. приложение для просмотра возможных значений

@MyDocumentsDir Путь к каталогу текущего пользователя Мои документы

@NumParams Число параметров, использованное при вызове функции пользователя.

@OSArch Возвращает одно из следующих значений: "X86", "IA64", "X64" - это тип архитектуры запущенной операционной системы

@OSBuild Возвращает номер сборки ОС. К примеру, на Windows 2003 Server макрос возвращает "3790"

@OSLang Возвращает код языка ОС. См. приложение для просмотра возможных значений

@OSServicePack Возвращает информацию о установленном пакете обновления в виде "Service Pack 3"

@OSType Возвращает "WIN32_NT" в 2000/XP/2003/Vista/2008/Win7/2008R2

@OSVersion Возвращает одно из следующих значений: "WIN_2008R2", "WIN_7", "WIN_8", "WIN_2008", "WIN_VISTA", "WIN_2003", "WIN_XP", "WIN_XPe", "WIN_2000"

@ProgramFilesDir Путь к каталогу Program Files

@ProgramsCommonDir Путь к каталогу Программы в главном меню

@ProgramsDir Путь к каталогу текущего пользователя Программы в главном меню

@ScriptDir Путь к каталогу, содержащему выполняемый скрипт (Результат не содержит конечного обратного слеша)

@ScriptFullPath Эквивалентно @ScriptDir & "\" & @ScriptName

@ScriptLineNumber Номер строки скрипта, выполняемой в данный момент. Не имеет смысла для скомпилированных скриптов.

@ScriptName Имя файла запущенного скрипта (с расширением).

@SEC Возвращает значение секунд на часах. Диапазон значений от 00 до 59

@StartMenuCommonDir Путь к каталогу Главное меню

@StartMenuDir Путь к каталогу текущего пользователя Главное меню

@StartupCommonDir Путь к каталогу Автозагрузка

@StartupDir Путь к каталогу текущего пользователя Автозагрузка

@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 Разблокировать окно.

@SystemDir Путь к каталогу Windows System (или System32)

@TAB Символ Tab, Chr(9)

@TempDir Путь к каталогу, содержащему временные файлы

@TRAY_ID Идентификатор последнего кликнутого элемента в событии TraySetOnEvent(), TrayItemSetOnEvent().

@TrayIconFlashing Возвращает 1, если иконка в трее мигает, иначе возвращает 0.

@TrayIconVisible Возвращает 1, если иконка в трее видима; иначе возвращает 0.

@UserName Возвращает ID пользователя (имя учётной записи), от чьего имени работает процесс, выполняющий скрипт. Внимание: это необязательно имя пользователя, выполнившего вход в систему

@UserProfileDir Путь к каталогу, содержащему профиль текущего пользователя

@WDAY Возвращает числовое значение дня недели. Диапазон значений от 1 до 7, что соответствует дням недели начиная с воскресенья и заканчивая субботой.

@WindowsDir Путь к каталогу Windows

@WorkingDir Текущий активный/рабочий каталог (Результат не содержит конечного обратного слеша). См. функцию FileChangeDir()

@YDAY Возвращает номер текущего дня года. Диапазон значений от 001 до 366

@YEAR Возвращает номер текущего года. Например: 2010

Макрос	Описание
@AppDataCommonDir	Путь к каталогу Application Data
@AppDataDir	Путь к каталогу текущего пользователя Application Data
@AutoItExe	Полный путь к исполняемому файлу AutoIt, выполняющему запущенный скрипт. Для скомпилированных скриптов это полный путь к файлу скомпилированного скрипта.
@AutoItPID	PID процесса, выполняющего запущенный скрипт.
@AutoItVersion	Версия AutoIt, выполняющего скрипт. Например, "3.3.8.1"
@AutoItX64	Возвращает 1, если скрипт выполняется x64 версией AutoIt.
@COM_EventObj	Ссылка на объект COM, инициировавший событие. Применимо только к функциям обрабатывающим события COM.
@CommonFilesDir	Путь к каталогу Common Files
@Compiled	Возвращает 1, если выполняемый скрипт скомпилирован, иначе возвращает 0.
@ComputerName	Возвращает сетевое имя компьютера
@ComSpec	Значение переменной среды %comspec% (SPECified secondary COMmand interpreter); для использования с командной строкой, к примеру Run(@ComSpec & " /k help \| more")
@CPUArch	Возвращает "X86" если ЦП является 32-разрядным, и "X64", если ЦП является 64-разрядным
@CR	Символ возврата каретки, Chr(13)
@CRLF	= @CR & @LF
@DesktopCommonDir	Путь к каталогу Рабочий стол
@DesktopDepth	Возвращает глубину рабочего стола (качество цветопередачи экрана) в битах на пиксель (обычно 32 или 16)
@DesktopDir	Путь к каталогу текущего пользователя Рабочий стол
@DesktopHeight	Возвращает высоту рабочего стола в пикселях (вертикальное разрешение экрана)
@DesktopRefresh	Возвращает частоту обновления экрана в герцах.
@DesktopWidth	Возвращает ширину рабочего стола в пикселях (горизонтальное разрешение экрана)
@DocumentsCommonDir	Путь к каталогу Документы
@error	Состояние флага ошибки. См. функцию SetError().
@exitCode	Код выхода, установленный функцией Exit.
@exitMethod	См. функцию OnAutoItExitRegister().
@extended	Дополнительное значение, возвращаемое некоторыми функциями. Например, StringReplace().
@FavoritesCommonDir	Путь к каталогу Избранное
@FavoritesDir	Путь к каталогу текущего пользователя Избранное
@GUI_CtrlHandle	Дескриптор последнего нажатого управляющего элемента GUI. Применимо только к функциям, обрабатывающим события GUI. См. функцию GUICtrlSetOnEvent().
@GUI_CtrlId	Идентификатор последнего нажатого управляющего элемента GUI. Применимо только к функциям, обрабатывающим события GUI. См. функцию GUICtrlSetOnEvent().
@GUI_DragFile	Путь файла перетаскиваемого на элемент. Применяется только для события перетаскивания $GUI_EVENT_DROPPED. См. функцию GUIGetMsg(), GUISetOnEvent().
@GUI_DragId	Идентификатор захваченного элемента GUI для операции перетащить и бросить. Применяется только для события перетаскивания $GUI_EVENT_DROPPED. См. функцию GUIGetMsg(), GUISetOnEvent().
@GUI_DropId	Идентификатор элемента, на который брошен объект (файл или элемент). Применяется только для события перетаскивания $GUI_EVENT_DROPPED. См. функцию GUIGetMsg(), GUISetOnEvent().
@GUI_WinHandle	Дескриптор последнего нажатого окна GUI. Применимо только к функциям, обрабатывающим события GUI. См. функцию GUICtrlSetOnEvent().
@HomeDrive	Буква диска, содержащего каталог с профилем текущего пользователя (обычно "C:")
@HomePath	Часть пути к каталогу, содержащему профиль пользователя (Например, "\Documents and Settings\User")
@HomeShare	Сетевое имя сервера, содержащего каталог с профилем текущего пользователя
@HotKeyPressed	Последняя нажатая горячая клавиша. См. функцию HotKeySet()
@HOUR	Возвращает значение часов на часах в 24-часовом формате. Диапазон значений от 00 до 23
@IPAddress1	Возвращает IP-адрес первого сетевого адаптера. Может вернуть "127.0.0.1" на некоторых компьютерах
@IPAddress2	Возвращает IP-адрес второго сетевого адаптера. Возвращает "0.0.0.0", если неприменимо
@IPAddress3	Возвращает IP-адрес третьего сетевого адаптера. Возвращает "0.0.0.0", если неприменимо
@IPAddress4	Возвращает IP-адрес четвёртого сетевого адаптера. Возвращает "0.0.0.0", если неприменимо
@KBLayout	Возвращает код текущей раскладки клавиатуры для окна AutoIt3; значение изменяется клавишами Alt+Shift в активном окне. См. приложение для просмотра возможных значений
@LF	Символ перевода строки, Chr(10)
@LogonDNSDomain	Logon DNS Domain.
@LogonDomain	Logon Domain.
@LogonServer	Logon server.
@MDAY	Возвращает номер текущего дня месяца. Диапазон значений от 01 до 31
@MIN	Возвращает значение минут на часах. Диапазон значений от 00 до 59
@MON	Возвращает номер текущего месяца. Диапазон значений от 01 до 12
@MSEC	Возвращает значение миллисекунд на часах. Диапазон значений от 000 до 999
@MUILang	Возвращает код Multi Language (если доступно, в Vista доступно по умолчанию), иначе возвращает "0000". См. приложение для просмотра возможных значений
@MyDocumentsDir	Путь к каталогу текущего пользователя Мои документы
@NumParams	Число параметров, использованное при вызове функции пользователя.
@OSArch	Возвращает одно из следующих значений: "X86", "IA64", "X64" - это тип архитектуры запущенной операционной системы
@OSBuild	Возвращает номер сборки ОС. К примеру, на Windows 2003 Server макрос возвращает "3790"
@OSLang	Возвращает код языка ОС. См. приложение для просмотра возможных значений
@OSServicePack	Возвращает информацию о установленном пакете обновления в виде "Service Pack 3"
@OSType	Возвращает "WIN32_NT" в 2000/XP/2003/Vista/2008/Win7/2008R2
@OSVersion	Возвращает одно из следующих значений: "WIN_2008R2", "WIN_7", "WIN_8", "WIN_2008", "WIN_VISTA", "WIN_2003", "WIN_XP", "WIN_XPe", "WIN_2000"
@ProgramFilesDir	Путь к каталогу Program Files
@ProgramsCommonDir	Путь к каталогу Программы в главном меню
@ProgramsDir	Путь к каталогу текущего пользователя Программы в главном меню
@ScriptDir	Путь к каталогу, содержащему выполняемый скрипт (Результат не содержит конечного обратного слеша)
@ScriptFullPath	Эквивалентно @ScriptDir & "\" & @ScriptName
@ScriptLineNumber	Номер строки скрипта, выполняемой в данный момент. Не имеет смысла для скомпилированных скриптов.
@ScriptName	Имя файла запущенного скрипта (с расширением).
@SEC	Возвращает значение секунд на часах. Диапазон значений от 00 до 59
@StartMenuCommonDir	Путь к каталогу Главное меню
@StartMenuDir	Путь к каталогу текущего пользователя Главное меню
@StartupCommonDir	Путь к каталогу Автозагрузка
@StartupDir	Путь к каталогу текущего пользователя Автозагрузка
@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	Разблокировать окно.
@SystemDir	Путь к каталогу Windows System (или System32)
@TAB	Символ Tab, Chr(9)
@TempDir	Путь к каталогу, содержащему временные файлы
@TRAY_ID	Идентификатор последнего кликнутого элемента в событии TraySetOnEvent(), TrayItemSetOnEvent().
@TrayIconFlashing	Возвращает 1, если иконка в трее мигает, иначе возвращает 0.
@TrayIconVisible	Возвращает 1, если иконка в трее видима; иначе возвращает 0.
@UserName	Возвращает ID пользователя (имя учётной записи), от чьего имени работает процесс, выполняющий скрипт. Внимание: это необязательно имя пользователя, выполнившего вход в систему
@UserProfileDir	Путь к каталогу, содержащему профиль текущего пользователя
@WDAY	Возвращает числовое значение дня недели. Диапазон значений от 1 до 7, что соответствует дням недели начиная с воскресенья и заканчивая субботой.
@WindowsDir	Путь к каталогу Windows
@WorkingDir	Текущий активный/рабочий каталог (Результат не содержит конечного обратного слеша). См. функцию FileChangeDir()
@YDAY	Возвращает номер текущего дня года. Диапазон значений от 001 до 366
@YEAR	Возвращает номер текущего года. Например: 2010