InputBox 函數

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

在對話方塊中顯示提示,等待使用者輸入文字或按一下按鈕,然後傳回包含文字方塊內容的字串。

語法

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)