在對話方塊中顯示提示,等待使用者輸入文字或按一下按鈕,然後傳回包含文字方塊內容的字串。
語法
InputBox (提示 [, title ] [, 預設 ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
InputBox 函數語法具有下列引數:
| 引數 | 描述 |
|---|---|
| 提示 | 必要。 字串運算式顯示為對話方塊中的訊息。 提示的最大長度約為 1024 個字元,視所用字元的寬度而定。 如果 提示 包含多行,您可以使用歸位字元 (Chr (13) ) 、換行字元 (Chr (10) ) ,或歸位-換行字元組合 (Chr (13) & Chr (10) ) 。 |
| 標題 | 可省略。 顯示在對話方塊標題列中的字串運算式。 如果您省略 標題,應用程式名稱會放置在標題列中。 |
| 預設 | 可省略。 字串運算式會在文字方塊中顯示為,如果未提供其他輸入,則預設回應。 如果您省 略預設,文字方塊會顯示空白。 |
| XPOS | 可省略。 以 twips 為單位,指定對話方塊左邊緣與螢幕左邊緣的水平距離的數值運算式。 如果省略 xpos ,對話方塊會水平置中。 |
| YPOS | 可省略。 以 twips 為單位指定對話方塊上邊緣與螢幕頂端的垂直距離的數值運算式。 如果省略 ypos ,對話方塊會垂直放置在螢幕下方約三分之一的位置。 |
| 說明檔 | 可省略。 字串運算式,用於識別說明檔案,用來為對話方塊提供即時線上說明。 如果提供 說明檔 ,也必須提供 內容 。 |
| 內容 | 可省略。 數值運算式,即說明作者指派給適當 [說明] 主題的說明內容編號。 如果提供了 內容 ,還必須提供 說明檔 。 |
註解
在同時提供說明檔和內容時,使用者可以按 F1 (Windows) 或 Macintosh) ([說明],檢視對應內容的說明主題。 某些主應用程式也會自動在對話方塊中新增 [說明 ] 按鈕。 如果使用者按一下 [確定] 或按下 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)