函数参考


InputBox

显示以一个输入框以供用户输入数据.

InputBox ( "标题", "提示信息" [, "默认数据" [, "密码字符" [, 宽度, 高度 [, 左方, 顶部 [, 超时时间 [,句柄]]]]]] )

参数

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

返回值

成功: 返回用户输入的字符串.
失败: 返回空字符串并把 @error 设为以下数值之一:
@Error 0 = 返回的字符串是有效的.
1 = 用户按下了 Cancel(取消)按钮.
2 = 超时.
3 = 输入框显示失败,这通常是由参数无效引起的.
4 = InputBox 不能显示于任何显示器.
5 = 错误参数,当指定宽度而没指定高度或者指定左方而没指定顶部.

注意/说明

用户可调整输入框的窗口大小,但有一个最小尺寸限制:大约 190 x 115(象素).默认的大小是大约 250 x 190(象素).

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

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

另外您还可以在 密码字符 参数的后面加上一个数字以指定输入字符串的最大长度.

相关

MsgBox

示例/演示


;在屏幕的左上角显示一个包含文本的输入框.
Local $answer = InputBox("问题", "你在哪里出生?", "地球", "", _
         - 1, -1, 0, 0)

;要求用户输入密码, 并验证密码的有效性!
Local $passwd = InputBox("安全检查", "输入您的密码.", "", "*")

;密码字符
;第一个字符为 空格 则表示输入可见.
;第二个字符是 M 则表示用户必须输入至少一个字符.
;第三个字符是 2 则表示输入字符长度, 最多2个字符.
Local $value = InputBox("测试", "输入 1 或 2 个字符码.", "", " M2")