函数说明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")