InputBox

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

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

参数

Prompt

类型: 字符串

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

Title

类型: 字符串

输入框的标题. 如果为空或省略, 则它默认为 A_ScriptName.

Options

类型: 字符串

不区分大小写的字符串选项, 每个选项与最后一个选项之间用空格或制表符分隔.

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

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

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

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 "'."