AutoHotKey 新手入门教程

AutoHotKey 真是一个好玩的工具！短短几行代码就是先了“窗口置顶”、“窗口透明”等功能，之前我还特意为此装了好几个小工具，现在都可以卸掉了。闲来无事，就把 Quick Start 翻译了一下，我没有逐字逐句地翻译，有时候我嫌原文罗嗦就用自己的话概括地描述了一下。

原文地址：http://www.autohotkey.com/docs/Tutorial.htm

教程目录

创建脚本
启动程序
模拟鼠标键盘
操纵窗口
输入
变量与剪切板
循环
操纵文件
其他特性

创建脚本

每个脚本都是一个纯文本文件，由一些能被 AutoHotKey.exe 执行的命令组成。一个脚本可能还包含热键

和热字符串

。如果没有热键和热字符串，脚本在启动的时候就会从头依次执行到尾。

创建一个新的脚本：

下载

并安装 AutoHotkey。
右击鼠标，选择 新建 -> 文本文档
。
输入文件名并确保以 .ahk
结尾。例如：Test.ahk。
右击文件，选择 编辑脚本
。
输入以下内容：#space::Run www.google.com

上一行的第一个字符 "#" 代表键盘上的 Windows 键；所以 #space 表示在按住 Windows 键后再按空格键。"::" 后面的命令会在热键激活后执行，在本例中则会打开谷歌主页。继续按下面步骤操作，来执行这个脚本：

保存并关闭该文件。
双击该文件来启动它。在系统托盘里会出现一个新图标。
按下 Windows 和空格键，网页会在默认的浏览器里打开。
右击系统托盘里的绿色图标可以退出或编辑当前脚本。

注意：

可以同时启动多个脚本，并且在系统托盘里都会有一个相应的图标。
每个脚本都能定义多个热键
和热字符串

。
想让某个脚本开机即启动，可以将它的快捷方式放到开始菜单的启动目录里
。

启动程序

命令 Run

可以运行程序、打开文档、网页链接或快捷键。请参看以下示例：

Run Notepad
Run C:/My Documents/Address List.doc
Run C:/My Documents/My Shortcut.lnk
Run www.yahoo.com
Run mailto:someone@somedomain.com

可以给这些命令设置任何热键

。下面第一个例子的快捷键是 Win+N ，第二个是 Control+Alt+C：

#n::Run Notepad
^!c::Run calc.exe

上例是单行热键，因为每个热键之包含一条命令。如果命令多余一条，则热键定义必须单独放一行，其后每条命令放一行，且最后一行必须是 return

。例如：

#n::
Run http://www.google.com
Run Notepad.exe
return

如果待执行的程序或文档没有集成到系统中，则需要指定完整路径：

Run %A_ProgramFiles%/Winamp/Winamp.exe

上例中 %A_ProgramFiles% 是内建变量

。比起直接使用诸如 C:/Program Files

这样的绝对路径，推荐使用内建变量，它使得脚本的可移植性更好，即能在其他机器上正常运行。注意：命令和变量都是大小写无关的。例如 "Run" 与 "run"、"A_ProgramFiles"与"a_programfiles"都是一样的。

用 RunWait

代替 Run，脚本就会一直等在，直到刚才运行程序退出。在下例中 MsgBox

命令直到记事本被关闭后才执行：

RunWait Notepad
MsgBox The user has finished (Notepad has been closed).

更多关于启动程序的内容 -- 像附带参数、制定工作路径以及获取程序返回值 -- 请点击这里

。

模拟鼠标键盘

用 Send

命令可以向当前活动窗口发送键盘击键消息。下例中定义了热键 Control+Alt+S 来输入签名：

^!s::
Send Sincerely,{Enter}John Smith
return

上例中{Enter}是模拟回车键，其他字符都是字面意思。下一个例子展示了其他几个特殊字符：

Send ^c!{tab}pasted:^v

代码会依次发送 Control+C、Alt+Tab、字符串 "pasted:"和 Control+V。完整的特殊字符列表请参阅 Send

命令。

最后，按键序列还可以用于定义字符串的缩写，即热字符串

。例如，下例将 btw 定义为 by the way 的缩写，无论何时你输入 btw 后再输入空格或逗号，都会被替换成 "by the way"：

::btw::by the way

鼠标点击

：

在发送鼠标点击事件前要先确定鼠标的位置（X, Y 坐标值）。AutoHotKey 自带的 Window Spy 可以很方便地确定鼠标的位置：

启动 Window Spy 。
激活你感兴趣的窗口 (Window Spy 默认置于窗口顶端)。
鼠标指针移到目标位置，Window Spy 就能显示出鼠标的坐标位置（在 Windows XP 或之前的版本中，按下 Shift-Alt-Tab 来激活 Window Spy，以便复制和粘贴 "冻结" 的坐标位置）。
将上面的坐标位置应用于 Click
命令。下例中鼠标在 112, 223 出单击一下左键：
Click 112, 223

移动鼠标（未按键）用 MouseMove

；拖动鼠标（有按键） MouseClickDrag

。

操纵窗口

用 WinActivate

来激活一个窗口；用 IfWinExist

或 WinWait

判断某个窗口是否存在。以下示例演示这些命令的用法：

IfWinExist Untitled - Notepad
{
WinActivate
}
else
{
Run Notepad
WinWait Untitled - Notepad
WinActivate
}

例子中首先搜索标题以 "Untitled - Notepad"（忽略大小写）开头的窗口。如果找到了就激活它；否则就启动记事本程序，等到窗口以出现就激活它。上例中还使用了上一次找到的的窗口

避免在每个 WinActivate 后面再次指定标题。

一些常用的窗口管理命令：

IfWinActive

：检查指定的窗口是否处于激活状态。
WinWaitActive
：等待指定的窗口处于激活状态（通常在发送窗口激活指令——比如按下 Control-F 来弹出查找窗口——后使用）。
WinClose
：关闭指定的窗口。
WinMove
：移动或/且调整窗口大写。
WinMinimize
，WinMaximize

，WinRestore

：分别是最小化、最大化和恢复指定的窗口。

输入

下例显示一个对话框，它有两个按钮（YES 和 NO）：

MsgBox, 4, , Would you like to continue?
IfMsgBox, No
return
; Otherwise, the user picked yes.
MsgBox You pressed YES.

使用 InputBox

提示用户输入一个字符串；FileSelectFile

或 FileSelectFolder

供用户选择文件和文件夹；更高级的任务使用 Gui

命令来自定义界面。

提示：从其他例子中你可能已经注意到第一个逗号往往被忽略（除非第一个参数为空或执行 := 、 = 或当前命令是后续语句

唯一的顶部命令)。例如：

MsgBox This is ok.
MsgBox, This is ok too (it has an explicit comma).

变量与剪切板

变量

是脚本用于存储文本或数值的内存区域。在数学运算和比较运算里，只包含数字（可以附带可选的小数点）的变量会自动解析成数值。

除了函数

里的局部变量，所有其他变量都是全局变量。即，它们的值可在脚本的任意地方读取和修改。此外，变量在使用前无需声明，直接使用即可（初始值为空）。

下例演示如何给变量赋字符串：

MyVar1 = 123
MyVar2 = my string

下例演示将变量的值与字符串或数值进行比较：

if MyVar2 = my string
{
MsgBox MyVar2 contains the string "my string".
}
if MyVar1 >= 100
{
MsgBox MyVar1 contains %MyVar1%, which is a number greater than or equal to 100.
}

你可能注意到第二个 MsgBox 语句中 MyVar1

被两个百分号包围着。此处会显示 MyVar1

变量的值。在给变量赋值时也可以使用相同的技巧。例如：

MyVarConcatenated = %MyVar1% %MyVar2%

上例中变量 MyVarConcatenated 的值是 "123 my string"（不含引号）。

考虑下面这个例子，它演示两个变量相互比较：

if (ItemCount > ItemLimit)
{
MsgBox The value in ItemCount, which is %ItemCount%, is greater than %ItemLimit%.
}

注意到上例的第一行包含一对小括号。小括号表示这个 if 语句包含一个表达式

；缺少它们则看作 "非表达式 if 语句"，于是需要用百分号将 ItemLimit 括起（这样的 if 语句限定只能使用一个比较运算符，即它们不能包含数学运算符或连词 "AND" 和 "OR" 等）。

数学

：如下例所示，使用冒号等号（:=）运算符可以将表达式

的计算结果赋值给一个变量：

NetPrice := Price * (1 - Discount/100)

完整的数学运算符请参阅表达式

一节。

剪切板

：Clipboard

是一个特殊变量，它代表 Windows 的系统剪切板。虽然如此，你还是可以像普通变量一样使用它。下例会显示当前剪切板里的内容：

MsgBox %clipboard%

考虑下面的例子，它用一段新的文本替代剪切板里当前的内容：

clipboard = A line of text.`r`nA second line of text.`r`n

上面的 `r 和 `n （第一个字符是倒引号，键盘 1 左边的那个键）分别代表回车符和换行符。这两个字符会将文本换到新的一行，效果等价于键入键盘上的 Enter 键。

下例演示将文本追加到剪切板（或其他任何变量）：

clipboard = %clipboard% And here is the text to append.

更多内容请参阅剪切板

和变量

两节。

循环

loop

可以连续地执行一段代码。下例中弹出 MsgBox

窗口三次：

Loop 3
{
MsgBox This window will be displayed three times.
}

你也可以在 Loop 后面指定一个变量，在迭代次数不确定时这个方法很奏效：

Loop %RunCount%
{
Run C:/Check Server Status.exe
Sleep 60000 ; Wait 60 seconds.
}

上例中，除非 RunCount 小于或等于 0，否则循环体至少能执行一次。

根据不同的条件，可以中途跳出循环。执行下例程序后，当用户按住 F1 键，程序就会不断地发送点击鼠标左键事件：

$F1:: ; Make the F1 key into a hotkey (the $ symbol facilitates the "P" mode of GetKeyState below).
Loop ; Since no number is specified with it, this is an infinite loop unless "break" or "return" is encountered inside.
{
if not GetKeyState("F1", "P") ; If this statement is true, the user has physically released the F1 key.
break ; Break out of the loop.
; Otherwise (since the above didn't "break"), keep clicking the mouse.
Click ; Click the left mouse button at the cursor's current position.
}
return

上例中，当用户放开 F1 键，程序就能知道并通过 break

命令终止循环。Break

使得程序跳到循环体外。

一个替代方案是使用 "while" 循环

：

$F1::
while GetKeyState("F1", "P") ; While the F1 key is being held down physically.
{
Click
}
return

上例演示了通用的循环结构。下面的循环结构适用于一些特殊场合：

File-reading/writing loop

：逐行获取文件内容。它可用于将基于行结构的文件转换成其他格式。还可以用于搜索特定内容。

Files and folders loop

：逐个遍历文件和文件夹。它允许你逐个处理文件或文件夹。

Parsing loop