命名常量
具有一组固定选项的内置函数参数接受来自以下某个命名空间的 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 视为右键单击的按钮,遵循 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 | FolderWatchCreate 的 filterMask。这些是位标志,因此可以用 | 组合。 |
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 | ShellRunProgram 的 verb,它也接受以 Text 形式给出的任何其他谓词 |
Location | TopLeft=0 TopCenter=1 TopRight=2 MiddleLeft=3 MiddleCenter=4 MiddleRight=5 BottomLeft=6 BottomCenter=7 BottomRight=8 | UIShowDisplayMessage 的 location,它也接受 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 枚举命名(见下文) | 所有接受 Integer key 的 Keyboard* 内置函数 |
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}、{BACKSPACE}、{BKSP} 和 {INS} 同样有效。
示例:"^c" Ctrl+C · "^+{ESC}" Ctrl+Shift+Esc · "%{F4}" Alt+F4 · "@d" Win+D · "^{HOME}" Ctrl+Home · "{enter}" Enter。
熟悉 .NET 的 SendKeys? 前缀和大括号中的名称遵循 Microsoft 的
SendKeys 语法。此文本增加了表示 Windows 键的 @,
以及表示数字小键盘专用键的 {NUMPAD0}…{NUMPAD9}、{SEPARATOR} 和 {DECIMAL}。要在一个文本中发送多个键,请使用下面的 KeyboardSendKeys。
按键序列(KeyboardSendKeys)
KeyboardSendKeys 接受 Microsoft SendKeys 格式的整个序列,与上面一样用 @ 表示 Windows 键,因此每个组合键也都是一个序列。
| 写法 | 发送的内容 |
|---|---|
abc | 这些字符,在任何键盘布局上都按原样键入 |
键前面的 ^ + % @ | 为该键按住 Ctrl、Shift、Alt 或 Windows:"^a" 即 Ctrl+A |
~ | Enter |
{TAB}、{F5}、… | 按名称指定的键,即上面的名称 |
{LEFT 5}、{a 3} | 该键或字符按指定次数重复,1 到 1000 |
+(abc) | 为括号中的每个键按住 Shift |
{+} {^} {%} {~} {@} {(} {)} {{} {}} | 该字符本身 |
示例:"{TAB 3}^a" 三次 Tab,然后 Ctrl+A · "^s{ENTER}" Ctrl+S,然后 Enter ·
"%(fx)" Alt+F,然后 Alt+X · "me{@}example.com~" 该地址,然后 Enter。
在按下任何键之前会先检查整个文本。其中任何位置有错误(例如大括号中的未知名称,或没有 } 的 {),都会使操作因指出该字符的错误而停止,并且不会发送任何内容。一个序列最多 4096 个字符、10000 次击键(重复次数计算在内)。每次击键都会像 KeyboardTypeText 一样等待 键入延迟 设置的时间,但重复的方向键、Home、End、Page Up 或 Page Down 键会一次性发出。
按住 Ctrl、Alt、Shift 或 Windows 时,字母、数字或空格在每种键盘布局上都是同一个键。其他任何字符都会在前台窗口的布局上查找:"^;" 在德语布局上与在美式布局上是不同的键,而该布局无法与修饰键一起键入的字符会被视为错误。
修饰键后面的字母就是它的键,不论大小写:"^A" 与 "^a" 一样是 Ctrl+A。要按 Ctrl+Shift+A,请写 "^+a"。Microsoft 的 SendKeys 会为大写字母添加 Shift,因此 StrokesPlus.net 导入会为您写出该 Shift。
请用 KeyboardTypeText 而不是 KeyboardSendKeys 发送纯文本。 在这里,+ ^ % ~ @ ( ) { } 是命令,而不是字符:"50% off" 会按下 Alt+Space,而在 "[email protected]" 中,@ 会为 e 按住 Windows 键。不是您自己编写的文本(例如剪贴板或变量)可能包含其中任何一个,因此永远不要将其传给 KeyboardSendKeys。