函数说明

InputBox

---

显示以一个输入框以供用户输入数据。InputBox ( "标题", "提示信息" [, "默认数据" [, "密码字符" [, 宽度, 高度 [, 左边, 上边 [, 超时时间]]]]] )

 

参数

标题	输入框的标题文字。
提示信息	提示用户程序需要获得的数据。
默认数据	显示在输入文本框中的默认文字。
密码字符	[可选参数] 显示在输入文本框中用以代替用户输入字符的字符。如果要正常显示字符只需定义此参数为空字符串""（默认）或空格字符即可。 如果此参数被设为多字符的字符串则只有第一个字符才有效。第二个字符及后面的其它字符有其它特殊用途。请查看下面的注意部分。
宽度	[可选参数] 窗口宽度。如有指定此参数则高度参数也必须指定。指定 -1 则表示使用默认宽度。
高度	[可选参数] 窗口高度。如有指定此参数则宽度参数也必须指定。指定 -1 则表示使用默认高度。
左边	[可选参数] 输入框左边离屏幕左边的距离（象素）。默认情况下，输入框是居中显示的，如有指定此参数则 上边 参数也必须指定。
上边	[可选参数] 输入框上边离屏幕左边的距离（象素）。默认情况下，输入框是居中显示的，如有指定此参数则 左边 参数也必须指定。
超时时间	[可选参数] 以秒为单位。指定时间过后输入框将自动关闭。

 

返回值

成功：	返回用户输入的字符串。
失败：	返回空字符串并把 @error 设为以下数值之一：
@Error	0 = 返回的字符串是有效的。
	1 = 用户按下了 Cancel（取消）按钮。
	2 = 超时。
	3 = 输入框显示失败，这通常是由参数无效引起的。

 

注意

使用 BlockInput(1) 可阻止用户输入数据（Windows 98/Me）。

用户可调整输入框的窗口大小，但有一个最小尺寸限制：大约 190 x 115（象素）。默认的大小是大约 250 x 190（象素）。

返回的字符串不会超过 254 个字符，如果输入的内容中含有回车或换行符，那么返回的字符串将被这些字符的第一个断开。

密码字符 参数的第二个及后面的其它字符可被用来限制用户输入。如果第一个字符是空格则输入得字符将可见，若第二个字符是 M 则表示输入将是强制性（Mandatory）的，也就是说用户必须输入至少一个字符，如果在没有输入任何内容的情况下按下 Ok 按钮则脚本不会有任何反应，输入框既不会消失也不会返回字符串。

另外您还可以在 密码字符 参数的后面加上一个数字以指定输入字符串的最大长度（参考下面的示例）。

 

相关

MsgBox

 

示例

;下面这个输入框将在屏幕左上角显示，并显示相应的提示文字。
$answer = InputBox("问题", "请问您的出生地是？", "地球", "", _
    -1, -1, 0, 0)

;要求用户输入密码。在实际的程序代码中别忘了再提供一次确认密码哦！
$passwd = InputBox("权限核查", "请输入密码：", "", "*")

;要求用户输入字符1或2。在密码字符参数中的 M 表示不接受空字符串，
;而数字 2 则表示最多只能输入两个字符。
$value = InputBox("测试", "请输入字符1或2：", "", " M2")