InputBox 函式

  • 發行項

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

語法

InputBox(prompt, [ title ], [ default ], [ xpos ], [ ypos ], [ helpfile, context ])

InputBox 函數語法具有這些具名引數引數：

組件 描述
prompt 必要。 字串運算式，顯示為對話方塊中的訊息。 prompt 長度的最大值約為 1024 字元，需視使用的字元寬度而定。 如果 prompt 包含多行，則可以使用歸位字元 (Chr(13))、換行字元 (Chr(10))，或歸位字元/換行字元組合 ((Chr(13) & (Chr(10)) 來分隔各行。
title 選用。 字串運算式顯示在對話方塊的標題列中。 如果省略標題，應用程式名稱會位於標題列中。
default 選用。 若未提供其他輸入，根據預設回應，會在文字方塊中顯示字串運算式。 如果您省略 default，則顯示空的文字方塊。
xpos 選用。 數值運算式，指定對話方塊左側與螢幕左側之間的水平距離 (以 Twip 為單位)。 如果省略 xpos ，則會將對話方塊水平置中。
ypos 選用。 數值運算式，指定對話方塊上端與螢幕頂端之間的垂直距離 (以 Twip 為單位)。 如果省略 ypos，則會將對話方塊垂直放在螢幕上方約三分之一的位置。
說明檔案 選用。 識別要使用之說明檔案的字串運算式會提供對話方塊的即時線上說明。 如果提供說明檔案，則也必須提供內容。
context 選用。 說明內容數字的數值運算式會指派至說明作者的適當說明主題。 如果提供內容，則也必須提供說明檔案。

註解

提供 helpfile 和 context 二者時，使用者可按下 F1 鍵 (Windows) 或 HELP (Macintosh) 檢視 context 對應的說明主題。 某些主應用程式 (例如 Microsoft Excel) 也會將 [說明] 按鈕自動新增到對話方塊。 如果使用者按一下 [確定] 或按 ENTER，InputBox 函式便會傳回文字方塊中的所有內容。 如果使用者選擇 [取消]，則函式會傳回零長度字串 ("")。

文字框只接受 255 個字元。 傳回字串會截斷為 254 個字元。

文本框不接受換行符，例如 Shift+Enter。 如果使用者在文字框中貼上含有換行符的文字，則會在換行符處截斷文字。

注意事項

若要指定一個以上的第一個具名引數，您必須在運算式中使用 InputBox。 若要略過某些位置的引數，您必須有對應的逗號分隔符號。

範例

本範例顯示各種使用 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)

另請參閱

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。