在對話框中顯示提示、等候使用者輸入文字或按下按鈕,並傳回包含文字框內容的字串。
語法
InputBox ( 提示 [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
InputBox 函數語法具有下列自變數:
引數 |
描述 |
---|---|
提示 |
必要。 字串表示式在對話框中顯示為訊息。 提示 字元的 長度上限大約為 1024 個字元,視所使用的字元寬度而定。 如果提示包含多行, 您可以使用歸位字元 (Chr (13 ) ) 、 (Chr ( 10) ) 的線段字元,或 (Chr ( 13) & Chr ( 10) ) 字元歸位字元組合來分隔線條。 |
標題 |
選擇性。 對話框標題列中顯示的字串表達式。 如果您省略 標題,應用程式名稱會放在標題欄中。 |
預設 |
選擇性。 如果沒有提供其他輸入,字串表達式會在文字框中顯示為默認回應。 如果您省略 預設值,文字框會顯示空白。 |
xpos |
選擇性。 以 twip 指定對話方塊左邊緣與螢幕左邊緣的水平距離數位運算式。 如果省略 xpos ,對話框會水準置中。 |
ypos |
選擇性。 以 twip 指定對話框上邊緣與螢幕頂端垂直距離的數值表示式。 如果省略 了 ypos ,對話框會垂直放置在螢幕下方約三分之一的位置。 |
helpfile |
選擇性。 字串表示式,用來為對話方塊提供內容相關說明的 [說明]。 如果 提供 helpfile ,也必須提供 內容 。 |
上下文 |
選擇性。 數值表達式,即說明作者指派給適當説明主題的說明內容編號。 如果提供 內容 ,也必須提供 說明歸檔 。 |
註解
同時提供 說明檔 和 內容 時,使用者可以按下 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)