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

dftg