InputBox

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

InputBoxObj := InputBox(Prompt, Title, Options, Default)

参数

Prompt

类型: 字符串

如果为空或省略, 则默认为空文本. 否则, 请指定文本, 通常是用于提示用户期望输入的数据类型的信息. 如果 Prompt 较长, 可以通过延续片段的方法将其分解成较短的几行, 这样可以增加可读性和可维护性.

Title

类型: 字符串

如果省略, 则默认为 A_ScriptName 当前的值. 否则, 请指定输入框的标题.

Options

类型: 字符串

如果为空或省略, 则输入框将在屏幕上水平和垂直居中, 默认大小约为 380x200 像素, 具体取决于操作系统版本和主题. 否则, 指定由以下一个或多个选项组成的字符串, 每个选项之间用空格或制表符分隔.

Xn 和 Yn: 对话框的 X 和 Y 坐标. 例如, x0 y0 将窗口置于桌面的左上角. 如果省略任何一个坐标, 则对话框将在该维度上居中. 任何一个坐标都可以是负数, 以使对话框部分或完全偏离桌面(或在多显示器设置中的辅助显示器上).

Wn 和 Hn: 对话框客户端区域的宽度和高度, 不包括标题栏和边框. 例如, w200 h100.

Tn: 指定超时时间, 单位为秒. 例如, T10.0 为 10 秒. 如果这个值超过 2147483(24.8 天), 那么它会被设置为 2147483. 达到超时时间后, 输入框窗口会自动关闭同时把 InputBoxObj.Result 设置为单词 "Timeout". InputBoxObj.Value 仍将包含用户输入的内容.

Password: 通过将用户键入的内容替换为屏蔽字符, 隐藏用户输入(例如密码输入). 如果需要一个非默认的屏蔽字符, 请将其紧接在单词 Password 之后. 例如, Password* 将使屏蔽字符变为星号而不是黑色圆圈(子弹).

Default

类型: 字符串

如果为空或省略, 则默认为无字符串. 否则, 指定一个字符串, 该字符串将在对话框首次出现时出现在输入框的编辑字段中. 用户可以通过回退键或其他方式来改变它.

返回值

类型: 对象

此函数返回一个具有以下属性的对象:

• Value(字符串): 用户输入的文本.
• Result(字符串): 以下单词之一表示输入框是如何关闭的: OK, Cancel 或 Timeout.

备注

输入框通常看起来像这样:

此对话框允许用户输入文本然后按下 OK 或 CANCEL. 用户可以通过拖动对话框的边界来调整它的大小.

GUI 窗口可以通过 OwnDialogs 选项显示模式输入框. 模式输入框阻止用户与 GUI 窗口交互, 直到输入框被关闭.

相关

Gui 对象, MsgBox, FileSelect, DirSelect, ToolTip, InputHook

示例

password := InputBox("(your input will be hidden)", "Enter Password", "password").value

IB := InputBox("Please enter a phone number.", "Phone Number", "w640 h480")
if IB.Result = "Cancel"
    MsgBox "You entered '" IB.Value "' but then cancelled."
else
    MsgBox "You entered '" IB.Value "'."