# InputBox

显示一个输入框让用户输入字符串.

InputBox, OutputVar [, Title, Prompt, HIDE, Width, Height, X, Y, Font, Timeout, Default]

#### 参数

OutputVar | 用来保存用户输入文本的变量.
Title | 输入框的标题.如果为空或忽略,默认为脚本的名称.
Prompt | 输入框的文本,通常是用于提示用户期望输入输入的数据类型的信息.如果 提示 较长, 可以使用 continuation section/字串分段 的方法将它分成较短的几行，这样可以增加可读性和可维护性.
HIDE | 如果这个参数是单词 HIDE, 用户的输入将被屏蔽, 对于密码这是有用的.
Width | 如果此参数为空或省略，窗口的初始宽度将是375。该参数可以是一个 表达式.
Height | 如果此参数为空或省略，窗口的初始高度将是189。这个参数可以是一个表达式 。
X-Y | 窗口的 X 和 Y 坐标 (使用 0,0 可以将其移动到桌面的左上角), 可以使用 expressions/表达式. 如果其中一个或两个一起留空或省略, 在那个方向上对话框将居中显示. 其中一个或两个坐标可以为负数,这样可以将窗口部分或完全移出桌面.
Font | 还没有实现 (留空). 将来可能接受像 verdana:8 这样的字串.
Timeout | 以秒为单位的超时时间 (可以包含小数点或者是一个 表达式).? 如果它的值超过 2147483 (24.8 天), 它将会被设置为 2147483. 超过超时时间以后, 输入框窗口将自动关闭同时 ErrorLevel 被设置为 2. OutputVar 仍将保存用户输入的内容.
Default | 对话框首次出现时显示在输入框中的字串. 用户可以使用退格或其他方法修改这个字串.

#### ErrorLevel

请参阅以下信息。

#### 备注

该对话框允许用户输入文本，然后按 OK/确定 或 CANCEL/取消. 用户可以通过拖动其边界调整对话框的大小.

如果用户按下 CANCEL/取消 按钮: 对于 AutoIt v2 (.aut) 脚本, OutputVar 将被设置为空并且 ErrorLevel 的值不会被改变. 对于所有其他类型的脚本 (例如 .ahk, .ini) ErrorLevel 的值被设置为1 (按 OK/确定 时设置为0) 同时 OutputVar 用来保存用户输入的内容. 这使得 CANCEL/取消 按钮可以用来执行一个其他的功能而不是脚本设计者期望的取消功能.

如果对话超时,对于所有类型的脚本 ERRORLEVEL的 的值将被设置为2, 包括的AutoIt v2的脚本.因此, 在使用这个命令超时之前 AutoIt v2 脚本中应该明确的设置 ErrorLevel 的值为 0 .

通过 Gui +OwnDialogs 的方法, 一个 GUI 窗口可以显示模式输入框.模式输入框可以避免用户在消息框消失之前对原来的 GUI/图形界面 窗口进行操作.

#### 相关

GUI, Input, MsgBox, FileSelectFile, FileSelectFolder, SplashTextOn, ToolTip

#### 示例

    InputBox, password, Enter Password, (your input will be hidden), hide
    InputBox, UserInput, Phone Number, Please enter a phone number., , 640, 480
    if ErrorLevel
        MsgBox, CANCEL was pressed.
    else
        MsgBox, You entered "%UserInput%"