Яндекс.Метрика

Hotkey -Autohotkey

Создание, изменение, включение или отключение горячих клавиш в запущенном скрипте.

Создание, изменение, включение или отключение горячих клавиш в запущенном скрипте.

Hotkey, KeyName [, Label, Options] Hotkey, IfWinActive/Exist [, WinTitle, WinText]

Параметры

KeyName Имя горячей клавиши, включая модификаторы. Например, комбинацию Win+C записываем как #c.

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

KeyName также может быть именем метки или комбинации горячих клавиш. Таким образом, при выполнении требований, изложенных ниже, мы можем изменять их параметры точно также, как и у одиночной горячей клавиши.

При указании имени горячей клавиши должен соблюдаться точно такой порядок указания модификаторов, как и в самой горячей клавише, например ^!c не то же самое, что !^c.

Текущие установки опций IfWin определяют вариант исполнения горячей клавиши, вызываемой с помощью команды Hotkey. Если никаких вариантов пока не существует, они будут созданы.

Как только горячая клавиша была впервые создана - неважно как, с помощью команды Hotkey или записи в скрипте (ограниченной двойным двоеточием) - её имя, включая сопряженные с ней модификаторы, становится постоянным именем горячей клавиши и может быть получено с помощью команды A_ThisHotkey. Больше это имя не изменяется, даже если с помощью дальнейшего использования команды Hotkey клавише будут назначены другие символы.
Label Имя метки, подлежащей исполнению. Запускается как новый поток при нажатии искомой (изменяемой) горячей клавиши. Здесь равнозначно используются как метки, так и горячие клавиши, и строки автозамены. Сопровождающие метку двоеточия не пишутся. Если метка динамическая (например %VarContainingLabelName%), для предварительной проверки наличия данной метки можно использовать функцию IsLabel(VarContainingLabelName).

Также этот параметр может быть опущен (оставлен пустым). В таком случае, если KeyName уже существует как горячая клавиша, такая метка не будет изменена. Используется такой метод для изменения опций (Options) горячей клавиши, при сохранении имени метки без изменений.

Если указанная метка определена, но данная горячая клавиша отключена предыдущим использованием данной команды, такая горячая клавиша будет продолжать оставаться отключенной и дальше. Для включения её, добавьте в опции параметр ON.

Данный параметр также может иметь одно из следующих значений:

On: Включение горячей клавиши. Если горячая клавиша уже включена, никаких изменений не произойдет.

Off: Отключение горячей клавиши. Точно также, если горячая клавиша уже отключена, никаких изменений не произойдет.

Toggle: Горячая клавиша переходит в противоположное состояние (включение или отключение).

AltTab (или другое): Это специальные действия, закрученные вокруг комбинации Alt-Tab, подробное описание их смотрите ниже.

Примечание: текущие установки опций IfWin определяют дальнейший вариант работы с горячей клавишей с помощью опций On/Off/Toggle.
Options Options представляют собой запись из нуля или более следующих друг за другом букв с возможными пробелами между ними. Например: UseErrorLevel On B0 T5.

UseErrorLevel: Если команда имеет проблемы с исполнением, эта опция пропускает диалог ошибки, устанавливает значение ErrorLevel в сооответствии с одним из кодов, представленых в таблице ниже и продолжает дальнейшее исполнение потока.

On: Параметр On включает горячую клавишу если она была отключена.

Off: Параметр Off выключает горячую клавишу если она была включена. Также эту опцию можно использовать для создания горячей клавиши, имеющей по дефолту выключенное состояние (Off).

B или B0: Параметр В указывает буферизовать горячую клавишу как предписано в директиве #MaxThreadsBuffer. Указание параметра В0 (B с цифрой 0) служит для отключения данной буферизации.

Pn: Параметр Р указывает на приоритет потока, запускаемого данной горячей клавишей. Если при создании горячей клавиши параметр Р опущен, в данном значении будет использоваться 0 (обычный приоритет).

Tn: Параметр Т указывает на количество потоков, разрешенное для данной горячей клавиши, как предписано в директиве #MaxThreadsPerHotkey. Например: T5.

Если в уже существующей горячей клавише оба или один из двух параметров В и Т были опущены, то опции такой горячей клавиши не изменятся. Если же с помощью рассматриваемой команды создается новая горячая клавиша, то данные опции принимают значение, использовавшееся в непосредственной близости до этого момента. Так например значение #MaxThreadsBuffer будет считано с самой нижней содержащей данную директиву строчки в скрипте. Если же директивы #MaxThreadsBuffer в скрипте нет вообще, то будет принято дефолтное значение для данного параметра, в данном случае это OFF. Точно также обстоит дело и с директивами серии #IfWin: на все вновь созданные горячие клавиши влияние оказывает самая нижняя запись директивы, кроме тех случаев, когда команда вида "Hotkey IfWin" была запущена непосредственно при старте скрипта.

Примечание: текущие установки IfWin определяют дальнейший вариант работы с горячей клавишей с помощью команды Hotkey. Если такого варианта ещё нет - он будет создан.
IfWinActive
IfWinExist
[v1.0.42+]
(Также поддерживаются IfWinNotActive и IfWinNotExist). Эти субкомманды делают все в дальнейшем созданные горячие клавиши контекстнозависимыми. Подробнее об этом см. ниже.
WinTitle
WinText
В пределах этих параметров любая ссылка на переменную типа %var% становится перманентной до самого момента завершения команды. Иными словами, последующие изменения содержимого переменной будут невидимы для уже существующих контекстнозависимых (заданных с оциями IfWin) горячих клавиш.

Также как и директива #IfWinActive/Exist, WinTitle и WinText используют дефолтные настройки для параметров SetTitleMatchMode и DetectHiddenWindows, если они не указаны специально в автоисполняемой части скрипта. Подробнее - смотрите #IfWinActive/Exist.

ErrorLevel

ErrorLevel изменяется только в случаях, когда: 1) первым параметром является IfWin[Not]Active/Exist, в таком случае она принимает значение 1, если проблема существует, и 0, если все ОК; 2) если в параметре Options указано слово UseErrorLevel.


ОшибкаОписание
1В параметре Label указано несуществующее имя метки.
2Параметр KeyName указывает на одну или более горячую клавишу, которые либо не могут распознаться программой, либо не поддерживаются текущей раскладкой клавиатуры или языком.
3Неподдерживаемый модификатор горячей клавиши. Например, использование колеса мыши как модификатора для горячих клавиш, типа WheelDown & Enter - не поддерживается.
4Указанный KeyName-параметр не пригоден для эмуляции комбинаций AltTab или ShiftAltTab. Здесь необходима комбинация двух клавиш, например RControl & RShift::AltTab.
5Команда пытается изменить несуществующую горячую клавишу.
6Команда пытается изменить несуществующий вариант существующей горячей клавиши. Для обхода этой проблемы, используйте "Hotkey IfWin" для задания критериев, по которым будут изменяться горячие клавиши.
98Создание данной горячей клавиши превысило лимит в 700 горячих клавиш для каждого скрипта (Однако при этом каждая горячая клавиша имеет бесконечное количество вариантов. Строки автозамены также неограниченны по количеству).
99Недостаточно памяти. Это очень редкая ошибка, и как правило она возникает только на нестабильной системе.

Совет: использование опции UseErrorLevel может помочь в проверке существования искомого варианта горячей клавиши. Например:

Hotkey, ^!p, MyLabel, UseErrorLevel if ErrorLevel in 5,6 MsgBox, ( Целевой комбинации горячих клавиш или метки не существует, либо в наличии нет варианта, подходящего хотя бы под один из критериев, заданных опциями IfWin. )

Описание: данной командой мы создаем новую горячую клавишу ^!p или, если она уже есть, изменяем её, программируя на выполнение команд, назначенных метке MyLabel. Если такой метки в скрипте нет, мы увидим MsgBox с описанием ошибки.

Примечания

Если нашей целью является автоматическое отключение определённых горячих клавиш или строк автозамены, базируясь на типе окна, которое активно в данный момент, обычно более подходящим вариантом является использование директивы #IfWinActive/Exist (или её динамического аналога "Hotkey IfWinActive/Exist". Подробности см. ниже).

Создание горячих клавиш по принципу метки, ограниченной двоеточиями, более предпочтительно, нежели использование для этой цели данной команды, потому что в таком случае при запуске скрипта горячие клавиши подгружаются комплексно, все сразу, в отличие от построчного метода, используемого данной командой. Таким образом, наилучшим способом применения данной команды являются ситуации, когда имя будущей горячей клавиши до старта скрипта ещё не известно. Например, в случае, когда горячие клавиши скрипта конфигурируются с помощью INI-файла.

Искомая метка может являться целью более чем одной горячей клавиши. Чтобы достоверно убедиться, какой именно горячей клавишей была вызвана данная метка, вы можете использовать встроенную переменную A_ThisHotkey.

Если скрипт приостановлен (suspended), процесс добавления/включения горячих клавиш тоже приостанавливается до тех пор, пока скрипт не будет активирован вновь (за исключением случаев, когда целевые горячие клавиши были намеренно освобождены от "заморозки", см. описание команды "Suspend").

Обработчики клавиатурных прерываний и/или обработчики прерываний мыши (keyboard/mouse hooks) могут быть проинсталлированы или наоборот, удалены, если такие необходимые изменения продиктованы использованием данной команды.

Несмотря на то, что команда Hotkey не может напрямую включать или выключать горячие клавиши из других скриптов (а может это делать только в своём собственном), в большинстве случаев эту проблему удается обойти созданием/включением одноименных горячих клавиш в нашем скрипте, "подавляя" таким образом одноименные горячие клавиши другого скрипта. Здесь срабатывает такой механизм клавиатурного перехватчика, когда наиболее "свежая" горячая клавиша подавляет более "старый" вариант той же клавиши.

Если наш скрипт содержит хотя бы одну горячую клавишу, то он становится постоянно загруженным (persistent), а это означает, что для его выключения команды Exit недостаточно, вместо этого используйте команду ExitApp. Также по дефолту такие скрипты работают в режиме #SingleInstance до тех пор, пока не будет назначена директива #SingleInstance Off.

Примечания к Hotkey, IfWinXX [, WinTitle, WinText]

В версиях 1.0.42 и более поздних команда "Hotkey IfWin" позволяет создавать или изменять контекстнозависимые горячие клавиши в то время, когда скрипт уже запущен (в отличие от директивы #IfWinActive/Exist, которая используется для задания условий горячим клавишам непосредственно при запуске скрипта). Например:

Hotkey, IfWinActive, ahk_class Notepad Hotkey, ^!e, MyLabel ; Создаем горячую клавишу, которая будет работать, ; только если у нас есть в наличии активное окно Блокнота.

Использование команды типа "Hotkey IfWin" распространяет эффект контекст-зависимости на все впоследствии созданные или изменяемые горячие клавиши. В дополнение ко всему скажем, что каждая последующая IfWin субкомманда является взаимно исключающей. Это означает, что эффект будет иметь только одна, самая последняя из вызванных комманд.

Для того чтобы отключить контекст-зависимость горячих клавиш, задайте любую из IfWin субкомманд с опущенными WinTitle/Text параметрами. Например: Hotkey, IfWinActive.

Если команды типа "Hotkey IfWin" в скрипте не используются, то на горячие клавиши будут влиять только директивы типа #IfWin, если таковые в скрипте представлены.

Если клавиша или кнопка мыши отключены с помощью команды IfWin, такие клавиши начинают выполнять свою обычную функцию, то есть посылают в рабочее окно свои стандартные значения. За исключением кнопок джойстика, которые, несмотря на то, что команда IfWin с ними работает корректно, не распознаются большинством программ.

Вариативные (дублированные) горячие клавиши

Одна и та же горячая клавиша может иметь множество вариантов, каждый из которых задается отдельно использованием комманд класса IfWin. Например:

Hotkey, IfWinActive, ahk_class Notepad Hotkey, ^!c, MyLabelForNotepad Hotkey, IfWinActive, ahk_class WordPadClass Hotkey, ^!c, MyLabelForWordPad Hotkey, IfWinActive Hotkey, ^!c, MyLabelForAllOtherWindows

Если при активации горячей клавиши вызывается несколько вариантов одновременно, то запущен будет только один из них, первый из всех запрашиваемых. Но тут есть одно исключение: если из всех представленных вариантов какой-либо носит "глобальный" характер, то запущен будет именно он, так как команды серии IfWin имеют по отношению к глобальным более низкий приоритет, и запускаются только тогда, когда в наличии нет более "могущественных" вариантов.

Порядок записи таких модификаторов, как ^!+# не имеет значения. Например, ^!c то же самое, что и !^c. Однако, любая горячая клавиша с префиксным групповым символом (*) радикально отличается от обычной горячей клавиши (без префиксного группового символа). Например, *F1 и F1 могут иметь каждый свои варианты.

Для более подробной информации о горячих клавишах серии IfWin смотрите статью "#IfWinActive / #IfWinExist".

Примеры

; F3 создает (или изменяет, если в скрипте такая уже есть) комбинацию горячих клавиш Ctrl+Alt+z, ; запрограммированнную на запуск метки MyLabel: ^!z::MsgBox, Вы нажали ^!z, а F3 пока никто не нажимал.`nОдобрямс? F3:: Hotkey, ^!z, MyLabel MsgBox, ( Вы нажали F3 и этим перепрограммировали горячую клавишу ^!z на запуск метки MyLabel: При следующем нажатии ^!z метка MyLabel должна сработать. ) Return MyLabel: MsgBox, Метка MyLabel успешно запущена.`nAutoHotkey - лучшая программа в мире! :) Return ; ---------------- Hotkey, RCtrl & RShift, AltTab ; превращает горячую клавишу "RCtrl & Rshift" в Alt-Tab. Hotkey, #c, On ; включение горячей клавиши "Win+c". Hotkey, $F3, Off ; отключение горячей клавиши F3, записанной в скрипте с посылом самой себя - c префиксом $. Hotkey, ^!a, , T5 ; включение через опции на комбинацию клавиш “Ctrl+Alt+a” разрешения на 5 потоков. ; Если в наличие есть активное окно Блокнота, ; горячей клавише ^!c – запустить метку MyLabelForNotepad. Hotkey, IfWinActive, ahk_class Notepad Hotkey, ^!c, MyLabelForNotepad
Теги страницы: