AutoHotKey入门教程

关键字： 工具技师 AutoHotKey

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

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

教程目录

创建脚本

每个脚本都是一个纯文本文件，由一些能被 AutoHotKey.exe 执行的命令组成。一个脚本可能还包含热键和热字符串。如果没有热键和热字符串，脚本在启动的时候就会从头依次执行到尾。

创建一个新的脚本：

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

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

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

注意：

启动程序

命令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"、"AProgramFiles"与"aprogramfiles"都是一样的。

用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 可以很方便地确定鼠标的位置：

  1. 启动 Window Spy 。
  2. 激活你感兴趣的窗口 (Window Spy 默认置于窗口顶端)。
  3. 鼠标指针移到目标位置，Window Spy 就能显示出鼠标的坐标位置（在 Windows XP 或之前的版本中，按下 Shift-Alt-Tab 来激活 Window Spy，以便复制和粘贴 "冻结" 的坐标位置）。
  4. 将上面的坐标位置应用于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 this statement is true, the user has physically released the F1 key.
    if not GetKeyState("F1", "P")
        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：从字符串中逐个获取子串。比如将 "Red,Green,Blue" 分成三个字段。

Registry loop：逐个遍历注册表中的键。

操纵文件

下例中使用FileAppend将文本追加到文件末尾（或创建一个新文件）。注意：它使用 `n （换行符）来换行：

FileAppend, A line of text to append.`n, C:/My Documents/My Text File.txt

使用FileDelete删除一个已存在的文件。例如：

FileDelete, C:/My Documents/My Text File.txt

其他一些常用的、和文件和文件夹相关的命令：

其他特性

参阅命令列表。

zzp-me： AutoHotKey教程