Именованные константы
Параметр встроенной функции с фиксированным набором вариантов принимает Integer из одного из этих
пространств имён. Имена заменяются числами при компиляции скрипта, поэтому ничего не стоят во время
выполнения, а редактор дополняет их, когда вы вводите пространство имён и точку, показывая значение и смысл каждого. Они чувствительны
к регистру, и имя с опечаткой — ошибка компиляции. Само число тоже работает (VirtualKey.A — это
65, то есть 0x41), но имя говорит, что оно означает. Поле Шагов, принимающее целое число,
принимает те же имена.
| Пространство имён | Члены = значение | Где используется |
|---|---|---|
MouseButton | Left=0 Right=1 Middle=2 X1=3 X2=4 Primary=5 Secondary=6 | MouseClick, MouseButtonDown/Up, MouseDoubleClick, MouseIsButtonDown; также это возвращает ContextGetStrokeButton (-1, если контекста кнопки нет). Primary — кнопка, которую Windows считает щелчком левой кнопкой, а Secondary — та, которую она считает щелчком правой кнопкой, согласно параметру Windows «Основная кнопка мыши», поэтому используйте их для обычного щелчка или щелчка правой кнопкой. Left и Right — физические кнопки: если в параметрах мыши Windows основная и дополнительная кнопки поменяны местами, щелчок MouseButton.Left — это физическая левая кнопка, которую Windows считает щелчком правой кнопкой. ContextGetStrokeButton сообщает кнопку уже после перестановки как Primary или Secondary, поэтому жест правой кнопкой сообщает Secondary, какой бы физической кнопкой он ни был нарисован, а передача этого значения в MouseClick нажимает ту же кнопку. Записанные макросы используют Primary и Secondary. |
FileNotify | FileName=0x1 DirName=0x2 Attributes=0x4 Size=0x8 LastWrite=0x10 LastAccess=0x20 Creation=0x40 Security=0x100 | filterMask функции FolderWatchCreate. Это битовые флаги, поэтому объединяйте их через |. |
AudioEndpoint | Playback=0 Capture=1 Communications=2 | встроенные функции громкости и отключения звука Multimedia* |
WindowStyle | Normal=0 Minimized=1 Maximized=2 Hidden=3 | ShellRunProgram |
ShellVerb | Open=0 Edit=1 Print=2 RunAs=3 Properties=4 Explore=5 Find=6 | verb функции ShellRunProgram, который также принимает любой другой глагол в виде Text |
Location | TopLeft=0 TopCenter=1 TopRight=2 MiddleLeft=3 MiddleCenter=4 MiddleRight=5 BottomLeft=6 BottomCenter=7 BottomRight=8 | location функции UIShowDisplayMessage, который также принимает точку экрана в виде Text "x,y" |
TextAlign | Left=0 Center=1 Right=2 | UIShowDisplayMessage/UIUpdateDisplayMessage |
LockResult | Acquired=0 TimedOut=1 Pinned=2 | возвращается UtilityLockAcquire/UtilityLockAcquirePinned |
LockState | Free=0 HeldByMe=1 HeldByOther=2 Pinned=3 | возвращается UtilityLockGetState |
SerialParity | None=0 Odd=1 Even=2 Mark=3 Space=4 | SerialOpenPort, SerialMonitorCreate |
SerialStopBits | One=0 OnePointFive=1 Two=2 | SerialOpenPort, SerialMonitorCreate |
DateTimeStyle | ShortDate=0 LongDate=1 ShortTime=2 LongTime=3 ShortDateTime=4 LongDateTime=5 FileStamp=6 | DateTimeFormat. Все, кроме FileStamp, следуют региональным параметрам Windows пользователя, в календаре этого региона; FileStamp всегда имеет вид 20261001-140509, сортируется по времени и безопасен в имени файла. |
DateTimePart | Year=0 Month=1 Day=2 Hour=3 Minute=4 Second=5 Weekday=6 | DateTimeGetPart. Григорианский календарь, местное время. Weekday по ISO: 1 — понедельник, 7 — воскресенье. |
VirtualKey | коды виртуальных клавиш Win32, названные по перечислению .NET Keys (список ниже) | все встроенные функции Keyboard*, принимающие Integer key |
Члены VirtualKey
Клавиши Oem* названы по символу, который они вводят на клавиатуре США. Физическая клавиша зависит
от раскладки.
LButton RButton Cancel MButton XButton1 XButton2 Back Tab Clear Enter ShiftKey ControlKey Menu Pause CapsLock Escape Space PageUp PageDown End Home Left Up Right Down Select Print Execute PrintScreen Insert Delete Help D0 D1 D2 D3 D4 D5 D6 D7 D8 D9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z LWin RWin Apps Sleep NumPad0 NumPad1 NumPad2 NumPad3 NumPad4 NumPad5 NumPad6 NumPad7 NumPad8 NumPad9 Multiply Add Separator Subtract Decimal Divide F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16 F17 F18 F19 F20 F21 F22 F23 F24 NumLock Scroll LShiftKey RShiftKey LControlKey RControlKey LMenu RMenu BrowserBack BrowserForward BrowserRefresh BrowserStop BrowserSearch BrowserFavorites BrowserHome VolumeMute VolumeDown VolumeUp MediaNextTrack MediaPreviousTrack MediaStop MediaPlayPause LaunchMail SelectMedia LaunchApplication1 LaunchApplication2 OemSemicolon Oemplus Oemcomma OemMinus OemPeriod OemQuestion Oemtilde OemOpenBrackets OemPipe OemCloseBrackets OemQuotes Oem8 Oem102
Текст сочетания клавиш (KeyboardPressKeyCombo)
KeyboardPressKeyCombo принимает Text, а не константу: любое число префиксов-модификаторов, затем
ровно одна клавиша. Одно сочетание на вызов, без счётчиков повтора. После клавиши ничего не может
следовать: "^cx" или "Control+V" — ошибка, а не нажатие первой клавиши.
| Префикс | ^ | + | % | @ |
|---|---|---|---|---|
| Модификатор | Ctrl | Shift | Alt | Win |
Клавиша — одна буква или цифра (в любом регистре) или одно из этих имён в фигурных скобках, в любом
регистре: {ENTER} {ESC} {TAB} {DEL} {BS} {SPACE} {HOME} {END} {PGUP} {PGDN} {LEFT}
{RIGHT} {UP} {DOWN} {INSERT} {F1}…{F24} {PRTSC} {CAPSLOCK} {NUMLOCK}
{SCROLLLOCK} {BREAK} {HELP} {CLEAR} {NUMPAD0}…{NUMPAD9} {MULTIPLY} {ADD}
{SEPARATOR} {SUBTRACT} {DECIMAL} {DIVIDE}. {ESCAPE} и {DELETE} тоже работают.
Примеры: "^c" Ctrl+C · "^+{ESC}" Ctrl+Shift+Esc · "%{F4}" Alt+F4 · "@d" Win+D ·
"^{HOME}" Ctrl+Home · "{enter}" Enter.
Знакомы с SendKeys из .NET? Префиксы и имена в фигурных скобках следуют
синтаксису SendKeys от Microsoft. Этот
текст добавляет @ для клавиши Windows, а также {NUMPAD0}…{NUMPAD9}, {SEPARATOR} и {DECIMAL} для
собственных клавиш цифровой клавиатуры. В нём нет счётчиков повтора ({LEFT 4}), нескольких клавиш в одном
тексте ("^s{ENTER}"), групп в скобках ("+(ec)"), ~ для Enter, буквальных символов в фигурных скобках,
таких как {+}, и коротких имён {BKSP} и {INS}.