AutoIt教程：8. 阅读帮助文件

AutoIt实际上很强大，至少“足够强大”。除了它的内建函数相当丰富之外[1]，还有大量的UDF，并且，在AutoIt论坛上时时刻刻都有人在不断地补充各种功用的新UDF。
尽管看起来很简单，这一节可能是最重要的内容。
先让我们拿MsgBox()这个函数作为讲解起点。打开MsgBox()这个函数的帮助文档，我们最先看到的是它的简要说明和参数定义：
MsgBox
Displays a simple message box with optional timeout.
MsgBox( flag,”title”,”text”[, timeout [,hwnd]])
参数定义中的方括号（“[ ]”）的含义是，“该参数在函数定义中设定了默认值，所以，这个参数是可选参数”，即，可以不指定这个参数，如果不指定的话，则直接使用函数定义的默认值──而这个默认值究竟是什么，在接下来的文档中有详细的解释。
Parameters

读过文档之后，就会知道
MsgBox(4096,”Test”,”This box has no timeout limit”,0)
和
MsgBox(4096,”Test”,”This box has no timeout limit”)
是一样的。
而“4096”究竟是什么意思，在接下来的文档中可以找到：

在使用MsgBox()的话，AutoIt用这个函数的返回值来判断用户究竟按下了对话框中的哪一个按钮，比如，如果用户按下的是“OK”（确定）按钮，那么返回值是1；如果按下的是“ABORT”（取消）按钮，则返回值是3；如果在Time Out 的时间内没有任何动作，返回值是-1……
请尝试一下以下代码（Testing17.au3）：
While1
$n=MsgBox(3,’MsgBox Demo’,’Please Press one of the buttons…’)
Select
Case$n==6
MsgBox(0,’Info’,’You pressed “YES”‘,2)
Case$n==7
MsgBox(0,’Info’,’You pressed “NO”‘,2) Case$n==2
MsgBox(0,’Info’,’You pressed “CANCEL”, and quit the program…’,2)
ExitLoop
EndSelect
WEnd
注意：在AutoIt中，每个函数都是有“返回值”的──即便在定义的时候没有给出返回值，AutoIt也会自动返回一个0……
请尝试一下以下代码（Testing18.au3）：
Func DoNothing()
EndFunc
MsgBox(0,””,”Function DoNothing() returns “&
__DoNothing())
如果函数调用处于表达式之中，那么它的返回值讲参与表达式计算；如果函数只是被调用（比如，一行代码中只有一个MsgBox()函数）而已，那么它的返回值将被“扔掉”（Throw out）。
另外，调用UDF的时候，需要“引用”定义文件，语法是：#Include
。之前我们已经见过具体的例子，比如想使用_ArrayDisplay这个函数的话，那么就得在程序开头加上#Include 。_ArrayDisplay 的参数定义如下：
#Include
_ArrayDisplay(Const ByRef$avArray[,$sTitle=”Array: ListView Display”[,$iItemLimit=-1[,$iTranspose=0[, $sSeparator=””[,$sReplace=”|”[,$sHeader=””]]]]]])以后当你需要做什么事情的时候，
1.先去看看AutoIt帮助文档，看看有没有能够完成相应功能的函数
2.认真阅读该函数的帮助文档，以及其中的范例
3.将此函数把玩一阵，测试它的方方面面
4.将其应用到你的程序中去……
5.最后，如果你有兴趣的话，可以去阅读一下那些UDF的源码（都是公开的），
学习它们的构建方法……
学会看帮助文档，就好像是学会查词典一样，是最基础，却又最重要的技能。听起来很荒唐，但确实有很多人学了一辈子英语却不懂如何查词典，于是一辈子有解决不完的问题，而又不知道症结究竟在哪里；同样的道理，有很多人学了很久的编程，却从来没有认真研究过如何查看文档，于是最终与那些学英语却不会查词典的人同一个下场，并且从不自知。
Wikipedia上有个很好的条目，建议所有人都去认真阅读一下：
http://www.doczj.com/doc/1b5d369e51e79b8968022637.html /wiki/Rtfm
Footnotes:
1.以后你会知道，任何一种编程语言，真正强大的地方都在于它们各自的“函数库”
（Library）……