在對話框中顯示提示,等待使用者輸入文字或點擊按鈕,並回傳包含文字框內容的字串。
語法
InputBox (提示 [, 標題 ] [, 預設 ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
InputBox 函式語法具有以下參數:
| 引數 | 描述 |
|---|---|
| 提示 | 必要。 字串表達式會以對話框中的訊息形式顯示。 提示詞最大長度約為1024個字元,視所用字元的寬度而定。 如果 提示 包含多行,你可以用回車字元 (Chr (13) ) 、換行字元 (Chr (10) ) ,或用換行字元組合 (Chr (13) & Chr (10) ) |
| 標題 | 可省略。 字串表達式顯示在對話框的標題欄中。 如果省略 標題,申請名稱會放在標題欄。 |
| 預設 | 可省略。 如果沒有其他輸入,字串表達式會顯示在文字框中作為預設回應。 如果你省略 預設,文字框會顯示為空。 |
| XPO | 可省略。 數值表達式,以 twips 表示對話框左邊緣與螢幕左邊緣的水平距離。 若省略 xpos ,對話框會水平居中。 |
| YPOS | 可省略。 數值表達式,以 twips 單位表示對話框上緣與螢幕頂端的垂直距離。 若省略 ypos ,對話框垂直位置約位於螢幕下方三分之一處。 |
| 幫助檔案 | 可省略。 字串表達式,用來識別說明檔案,提供對話框的情境相關說明。 如果提供 幫助檔案 ,也必須提供 上下文 。 |
| 背景 | 可省略。 數值表達式,即由幫助作者指派給適當說明主題的幫助上下文編號。 若提供 上下文 ,也必須提供 幫助檔案 。 |
註解
當同時提供 說明檔 與 上下文 時,使用者可以按下 Windows) (F1 或 Macintosh) 按 Help,查看對應 的說明主題 (。 部分主機應用程式也會自動在對話框中新增 說明 按鈕。 如果使用者點擊 確定 或按下 ENTER,InputBox 函式會回傳文字框中的內容。 如果使用者點擊 取消,函式會回傳一個零長度的字串 (“”) 。
注意
若要指定超過第一個命名參數,必須在表達式中使用 InputBox 。 若要省略部分位置論元,必須包含相應的逗號分隔符。
範例
注意
下列範例示範如何在 Visual Basic for Applications (VBA) 模組中使用此函數。 如需使用 VBA 的詳細資訊,請在 [搜尋] 旁的下拉式清單中選取 [開發人員參考],並在 [搜尋] 方塊中輸入一個或多個字詞。
此範例展示了使用 InputBox 函式提示使用者輸入數值的多種方式。 若省略 x 與 y 位置,對話框會自動置中對應軸。 變數 MyValue 包含使用者在點擊 確定 鍵或按下 ENTER 鍵時所輸入的值。 如果使用者點擊 取消,會回傳一個長度為零的字串。
Dim Message, Title, Default, MyValue
Message = "Enter a value between 1 and 3" ' Set prompt.
Title = "InputBox Demo" ' Set title.
Default = "1" ' Set default.
' Display message, title, and default value.
MyValue = InputBox(Message, Title, Default)
' Use Helpfile and context.
' The Help button is added automatically.
MyValue = InputBox(Message, Title,,,,"DEMO.HLP", 10)
' Display dialog box at position 100, 100.
MyValue = InputBox(Message, Title, Default, 100, 100)