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


AutoItSetOption

Изменяет поведение множества функций/параметров AutoIt.

AutoItSetOption ( "option" [, param ] )

Параметры

option Опция для изменения. См. примечания.
param [необязательный] Новое значение опции. Тип и значения зависят от устанавливаемой опции. См. примечания. Если параметр не указан, функция просто возвращает текущее значение опции. Ключевое слово Default может быть использовано в качестве параметра, чтобы изменить значение опции на значение по умолчанию.

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

Успех:Возвращает предыдущее значение опции.
Ошибка:Устанавливает значение @error не равным нулю. Ошибка происходит, если переданы неправильные параметры (например, опция с указанным именем не существует).

Примечания

Вы можете использовать Opt() вместо AutoItSetOption().

Доступны следующие опции:

Option Param
CaretCoordMode Устанавливает кареточный способ координат используемый в функциях, абсолютные координаты или координаты относительно текущего активного окна:
0 = относительно координат активного окна
1 = (по умолчанию) абсолютных координатах экрана
2 = относительно координат клиентской области активного окна
ExpandEnvStrings Изменяет интерпретацию литеральных (буквальных) строк и символов %. По умолчанию строки рассматриваются литерально (буквально), эта опция позволяет вам использовать %environment% переменные в строках, например, "Временный каталог: %temp%".
0 = (по умолчанию) использовать как текст
1 = использовать как переменную (как в AutoIt v2)
Без этой опции обычный способ выглядит так: "Временный каталог: " & EnvGet("temp")
ExpandVarStrings Изменяет интерпретацию литеральных (буквальных) строк и символов variable/macro ($ и @). По умолчанию строки рассматриваются литерально (буквально), эта опция позволяет использовать переменные и макросы внутри строк, например, "Значение var1=$var1$".
0 = (по умолчанию) использовать как текст
1 = использовать как переменную / макрос (если вы хотите использовать $ и @ в этом режиме как текст, дублируйте эти символы: "Значение var1=$$var1$".
GUICloseOnESC При нажатии ESC в окно высылается сообщение $GUI_EVENT_CLOSE для закрытия окна. Эта опция разрешает или запрещает это действие.
0 = не отправляет $GUI_EVENT_CLOSE при нажатии ESC.
1 = (по умолчанию) отправляет $GUI_EVENT_CLOSE при нажатии ESC.
GUICoordMode Изменяет способ установки позиции элемента определяемый функциями GUICtrlSetPos и GUICtrlCreate....
0 = относительно позиции начала последнего элемента (верхний левый угол).
1 = (по умолчанию) абсолютные координаты, но всё же относительно клиентской области окна.
2 = ячейка позиционируется относительно текущей ячейки. Значение -1 для левого или верхнего параметра означает использование координаты предыдущей ячейки.
Таким образом следующая ячейка вниз (-1, смещение); следующая ячейка вправо (смещение, -1); текущая ячейка (-1, -1).
Понятно, что "смещение" не может быть равным -1, так как обозначает отсутствие сдвига. Но если вы используете кратную ширину, то выбирайте пропуск или возврат назад.
GUIDataSeparatorChar Устанавливает символ, который будет разделителем пунктов в GUICtrlSetData (и ListView).
По умолчанию символ '|'.
GUIOnEventMode Включает / отключает режим уведомления OnEvent.
0 = (по умолчанию) отключает.
1 = включает.
GUIResizeMode Установить стандартное поведение элементов управления при изменении размера окна. Только для элементов, которым не указано индивидуальное поведение.
0 = (по умолчанию) использовать стандартный способ, указанный в документации к элементу.
Иная комбинация флагов (или число, в сумме не более 1024) определяющая поведение, смотрите в таблице GUICtrlSetResizing.
Изменить поведение для окна этой опцией можно только перед созданием этого окна.
GUIEventOptions Изменяет системные события или значения возвращаемые функциями GUI.
0 = (по умолчанию) окно реагирует на кнопки Свернуть, Восстановить, Развернуть, Изменить размер.
1 = запретить окну реагировать на кнопки Свернуть, Восстановить, Развернуть, Изменить размер. Просто посылает уведомления.
MouseClickDelay Изменяет продолжительность паузы между кликами мыши.
Время паузы в миллисекундах (по умолчанию=10).
MouseClickDownDelay Изменяет продолжительность нажатой кнопки мыши, прежде чем отпустить.
Время в миллисекундах (по умолчанию=10).
MouseClickDragDelay Изменяет продолжительность паузы в начале и в конце операции перетаскивания мышкой.
Время в миллисекундах (по умолчанию=250).
MouseCoordMode Устанавливает способ отсчёта координат используемый в функциях мыши, или абсолютные координаты или координаты относительно текущего активного окна:
0 = относительно координат активного окна
1 = (по умолчанию) абсолютное экранные координаты
2 = относительно координат клиентской области активного окна
MustDeclareVars Если используется эта опция, то все переменные должны быть предварительно объявлены с Dim, Local или Global прежде чем они будут использованы - это избавляет от ошибок переменных, вызывающих сбой.
0 = (по умолчанию) Переменные не обязательно объявлять
1 = Переменные должны быть объявлены
PixelCoordMode Устанавливает способ отсчёта координат используемый в Pixel-функциях. Абсолютные координаты или координаты относительно окна указанного в параметре HWND соответствующих функций (по умолчанию активное окно):
0 = относительно координат указанного окна
1 = (по умолчанию) абсолютное экранные координаты
2 = относительно координат клиентской области указанного окна
SendAttachMode Specifies if AutoIt attaches input threads when using Send() function. When not attaching (по умолчанию mode=0) detecting the state of capslock/scrolllock and numlock can be unreliable under NT4. However, when you specify attach mode=1 the Send("{... down/up}") syntax will not work and there may be problems with sending keys to "hung" windows. ControlSend() ALWAYS attaches and is not affected by this mode.
0 = (по умолчанию) don't attach
1 = attach
SendCapslockMode Указывает на то, что AutoIt должен помнить состояние CapsLock перед выполнением функции Send и восстановить предыдущее состояние впоследствии.
0 = не запоминает и не восстанавливает
1 = (по умолчанию) запоминает и восстанавливает
SendKeyDelay Изменяет продолжительность паузы между эмулированными (имитированными) нажатиями клавиш. Значение - 0 полностью устраняет задержки.
Время в миллисекундах (по умолчанию=5).
SendKeyDownDelay Изменяет продолжительность нажатого состояния клавиши, перед тем как отпустить. Для программ принимающих это при регистрации нажатых клавиш (и многих игр) вам возможно понадобится повысить это значения выше чем по умолчанию. Значение - 0 полностью устраняет задержки.
Время в миллисекундах (по умолчанию=5).
TCPTimeout Указывает время после которого функции TCP завершаются, если отсутствует связь.
Время в миллисекундах (по умолчанию=100).
TrayAutoPause Пауза скрипта при клике на иконке в трее.
0 = нет паузы
1 = (по умолчанию) пауза. Пауза не появляется, если меню нестандартное.
TrayIconDebug Если включен, то показывает текущую строку скрипта во всплывающей подсказке возле иконки трея для помощи в отладке.
0 = (по умолчанию) не показывать информацию отладки
1 = показать отладку
TrayIconHide Скрывает иконку скрипта в трее. Примечание: Иконка всё же первоначально появится ~750 миллисекунд.
0 = (по умолчанию) показать иконку
1 = скрыть иконку
TrayMenuMode Расширить поведение меню для иконки в трее. Это может быть комбинацией (сумма) следующих значений.
0 = (по умолчанию) стандартные пункты меню (Script Paused/Exit) в виде придатка к пользовательскому меню; галочки пользовательского меню автоматически снимаются; если вы дважды кликните на иконке в трее, тогда возвращается идентификатор, который имеет "стиль по умолчанию".
1 = отсутствует стандартное меню
2 = галочки пользовательского меню не снимаются автоматически, если кликнуть на них
4 = Не возвращается menuitemID который имеет "стиль по умолчанию" в главном контекстном меню, если вы дважды кликните на иконке в трее
8 = отключить авто-переключение радио-пунктов группы
TrayOnEventMode Включить / выключить функции уведомления OnEvent для трея.
0 = (по умолчанию) отключить
1 = включить
WinDetectHiddenText Указывает, что скрытый текст окна может быть "виден" соответствующими оконными функциями.
0 = (по умолчанию) Не определять скрытый текст
1 = Определять скрытый текст
WinSearchChildren Позволяет поиск дочерних окон также как и окон верхнего уровня (корневых-родительских).
0 = (по умолчанию) Только поиск окон верхнего уровня
1 = Поиск окон верхнего уровня и дочерних
WinTextMatchMode Изменяет метод сопоставления текстов окон при операции поиска.
1 = (по умолчанию) Полный / медленный режим
2 = Быстрый режим
В быстром режиме AutoIt обычно "видит" тексты диалогов, кнопок и заголовков некоторых элементов управления. В режиме по умолчанию AutoIt может увидеть гораздо больше текста (например, содержимое окна "Блокнот").
Если у вас возникли проблемы с производительностью при выполнении поиска в окне, то может помочь переход на "быстрый" режим.
WinTitleMatchMode Изменяет метод сопоставления заголовков окон при операции поиска.
1 = (по умолчанию) Начальное соответствие заголовка
2 = Соответствие любой подстроке в заголовке
3 = Точное соответствие заголовка
4 = Расширенный режим, смотрите заголовки и текст окон (расширенные) От -1 до -4 = принудительное сопоставление в нижнем регистре для соответствующих типов сопоставления.
WinWaitDelay Изменяет продолжительность паузы после успешных оконных функций.
Время в миллисекундах (по умолчанию=250).

Пример

; можно скопировать отсюда :)   ;значения по умолчанию указаны первыми

Opt("CaretCoordMode", 1)           ;1=абсолютные, 0=относительные, 2=клиентские
Opt("ExpandEnvStrings", 0)         ;0= % как текст, 1= % как переменная
Opt("ExpandVarStrings", 0)         ;0=$ и @ в тексте как текст, 1= как переменные
Opt("GUICloseOnESC", 1)          ;1=ESC  закрывает, 0=ESC не закрывает
Opt("GUICoordMode", 1)             ;1=абсолютные, 0=относительные, 2=как ячейка
Opt("GUIDataSeparatorChar","|") ;"|" по умолчанию
Opt("GUIOnEventMode", 0)         ;0=отключено, 1=включен  режим OnEvent
Opt("GUIResizeMode", 0)            ;0=стандартно, спец-условия при менее 1024
Opt("GUIEventOptions",0);0=по умолчанию, 1=только уведомления, 2=GuiCtrlRead tab index
Opt("MouseClickDelay", 10)         ;10 миллисекунд
Opt("MouseClickDownDelay", 10) ;10 миллисекунд
Opt("MouseClickDragDelay", 250);250 миллисекунд
Opt("MouseCoordMode", 1)          ;1=абсолютные, 0=относительные, 2=клиентские
Opt("MustDeclareVars", 0)           ;0=без объявления, 1=обязательно объявить
Opt("PixelCoordMode", 1)            ;1=абсолютные, 0=относительные, 2=клиентские
Opt("SendAttachMode", 0)          ;0=don't attach, 1=do attach
Opt("SendCapslockMode", 1)      ;1=запоминает и восстанавливает, 0=не зап. и не восст.
Opt("SendKeyDelay", 5)             ;5 миллисекунд
Opt("SendKeyDownDelay", 1)     ;1 миллисекунда
Opt("TCPTimeout",100)              ;100 миллисекунд
Opt("TrayAutoPause",1)             ;0=без паузы, 1=с паузой
Opt("TrayIconDebug", 0)            ;0=не показать отладку, 1=показать отладку
Opt("TrayIconHide", 0)               ;0=показать иконку, 1=скрыть иконку
Opt("TrayMenuMode",0) ;0=стандарт, 1=без стандарт. меню, 2=без автоуст. галочек, 4=не возращ. menuitemID, 8 откл. перекл. радио.
Opt("TrayOnEventMode",0)       ;0=откл., 1=вкл.
Opt("WinDetectHiddenText", 0) ;0=не опред. скрытый, 1=опред. скрытый
Opt("WinSearchChildren", 1)    ;0=поиск без дочерних, 1=поиск включая дочерние
Opt("WinTextMatchMode", 1)   ;1=Полный, 2=Быстрый
Opt("WinTitleMatchMode", 1)   ;1=с началом, 2=частично, 3=точно, 4=расширено, -1 to -4=Nocase
Opt("WinWaitDelay", 250)       ;250 миллисекунд