InputBox 函數

套用到
Microsoft 365 Access Access 2024 Access 2021 Access 2019 Access 2016

在對話框中顯示提示,等待使用者輸入文字或點擊按鈕,並回傳包含文字框內容的字串。

語法

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)