autoit InputBox 函數(shù)

更新時間：2008年06月18日 21:58:18 作者：

顯示以一個輸入框以供用戶輸入數(shù)據(jù)。InputBox ( "標題", "提示信息" [, "默認數(shù)據(jù)" [, "密碼字符" [, 寬度, 高度 [, 左邊, 上邊 [, 超時時間]]]]] )

函數(shù)說明

InputBox

顯示以一個輸入框以供用戶輸入數(shù)據(jù)。InputBox ( "標題", "提示信息" [, "默認數(shù)據(jù)" [, "密碼字符" [, 寬度, 高度 [, 左邊, 上邊 [, 超時時間]]]]] )

參數(shù)

標題	輸入框的標題文字。
提示信息	提示用戶程序需要獲得的數(shù)據(jù)。
默認數(shù)據(jù)	顯示在輸入文本框中的默認文字。
密碼字符	[可選參數(shù)] 顯示在輸入文本框中用以代替用戶輸入字符的字符。如果要正常顯示字符只需定義此參數(shù)為空字符串""（默認）或空格字符即可。如果此參數(shù)被設為多字符的字符串則只有第一個字符才有效。第二個字符及后面的其它字符有其它特殊用途。請查看下面的注意部分。
寬度	[可選參數(shù)] 窗口寬度。如有指定此參數(shù)則高度參數(shù)也必須指定。指定 -1 則表示使用默認寬度。
高度	[可選參數(shù)] 窗口高度。如有指定此參數(shù)則寬度參數(shù)也必須指定。指定 -1 則表示使用默認高度。
左邊	[可選參數(shù)] 輸入框左邊離屏幕左邊的距離（象素）。默認情況下，輸入框是居中顯示的，如有指定此參數(shù)則上邊參數(shù)也必須指定。
上邊	[可選參數(shù)] 輸入框上邊離屏幕左邊的距離（象素）。默認情況下，輸入框是居中顯示的，如有指定此參數(shù)則左邊參數(shù)也必須指定。
超時時間	[可選參數(shù)] 以秒為單位。指定時間過后輸入框將自動關閉。

返回值

成功：	返回用戶輸入的字符串。
失敗：	返回空字符串并把 @error 設為以下數(shù)值之一：
@Error	0 = 返回的字符串是有效的。
	1 = 用戶按下了 Cancel（取消）按鈕。
	2 = 超時。
	3 = 輸入框顯示失敗，這通常是由參數(shù)無效引起的。

注意

使用 BlockInput(1) 可阻止用戶輸入數(shù)據(jù)（Windows 98/Me）。

用戶可調整輸入框的窗口大小，但有一個最小尺寸限制：大約 190 x 115（象素）。默認的大小是大約 250 x 190（象素）。

返回的字符串不會超過 254 個字符，如果輸入的內容中含有回車或換行符，那么返回的字符串將被這些字符的第一個斷開。

密碼字符參數(shù)的第二個及后面的其它字符可被用來限制用戶輸入。如果第一個字符是空格則輸入得字符將可見，若第二個字符是 M 則表示輸入將是強制性（Mandatory）的，也就是說用戶必須輸入至少一個字符，如果在沒有輸入任何內容的情況下按下 Ok 按鈕則腳本不會有任何反應，輸入框既不會消失也不會返回字符串。

另外您還可以在密碼字符參數(shù)的后面加上一個數(shù)字以指定輸入字符串的最大長度（參考下面的示例）。

相關

MsgBox

示例

;下面這個輸入框將在屏幕左上角顯示，并顯示相應的提示文字。
$answer = InputBox("問題", "請問您的出生地是？", "地球", "", _
-1, -1, 0, 0)

;要求用戶輸入密碼。在實際的程序代碼中別忘了再提供一次確認密碼哦！
$passwd = InputBox("權限核查", "請輸入密碼：", "", "*")

;要求用戶輸入字符1或2。在密碼字符參數(shù)中的 M 表示不接受空字符串，
;而數(shù)字 2 則表示最多只能輸入兩個字符。
$value = InputBox("測試", "請輸入字符1或2：", "", " M2")