Zeigt eine Eingabeaufforderung in einem Dialogfeld an, wartet darauf, dass der Benutzer Text eingibt oder auf eine Schaltfläche klickt, und gibt eine Zeichenfolge mit dem Inhalt des Textfelds zurück.
Syntax
InputBox(prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
Die Syntax der Funktion InputBox weist die folgenden Argumente auf:
| Argument | Beschreibung |
|---|---|
| Eingabeaufforderung | Erforderlich. Zeichenfolgenausdruck, der als Nachricht im Dialogfeld angezeigt wird. Die maximale Länge der Eingabeaufforderung beträgt je nach Breite der verwendeten Zeichen ungefähr 1024 Zeichen. Wenn die Eingabeaufforderung aus mehr als einer Zeile besteht, können Sie die Zeilen mit einem Wagenrücklaufzeichen (Chr(13)), einem Zeilenvorschubzeichen (Chr(10)) oder einer Wagenrücklauf-Zeilenvorschub-Zeichenkombination (Chr(13) & Chr(10)) zwischen jeder Zeile trennen. |
| Titel | Optional. Zeichenfolgenausdruck, der auf der Titelleiste des Dialogfelds angezeigt wird. Wenn Sie keinen Titel angeben, wird der Anwendungsname in der Titelleiste platziert. |
| Standard | Optional. Zeichenfolgenausdruck, der im Textfeld als Standardantwort angezeigt wird, wenn keine weitere Eingabe bereitgestellt wird. Wenn Sie "Standard" nicht angeben, wird das Textfeld leer angezeigt. |
| XPosition | Optional. Numerischer Ausdruck, der den horizontalen Abstand (in Twips) des linken Rands des Dialogfelds vom linken Rand des Bildschirms angibt. Wenn xpos weggelassen wird, wird das Dialogfeld horizontal zentriert. |
| YPosition | Optional. Numerischer Ausdruck, der den vertikalen Abstand (in Twips) des oberen Rands des Dialogfelds vom oberen Rand des Bildschirms angibt. Wenn ypos weggelassen wird, wird das Dialogfeld etwa ein Drittel des Bildschirms vertikal positioniert. |
| Hilfedatei | Optional. Zeichenfolgenausdruck, der die Hilfedatei angibt, die verwendet wird, um kontextbezogene Hilfe für das Dialogfeld bereitzustellen. Wenn eine Hilfedatei bereitgestellt wird, muss auch der Kontext bereitgestellt werden. |
| Kontext | Optional. Numerischer Ausdruck, der die Hilfekontextnummer angibt, die dem entsprechenden Hilfethema vom Autor der Hilfe zugewiesen wurde. Wenn Kontext bereitgestellt wird, muss auch die Hilfedatei bereitgestellt werden. |
Hinweise
Wenn sowohl Hilfedatei als auch Kontext bereitgestellt werden, kann der Benutzer F1 (Windows) bzw. HILFE (Macintosh) drücken, um das dem Kontext entsprechende Hilfethema anzuzeigen. Einige Hostanwendungen fügen dem Dialogfeld auch automatisch eine Schaltfläche Hilfe hinzu. Wenn der Benutzer auf OK klickt oder die EINGABETASTE drückt, gibt die InputBox-Funktion den Inhalt des Textfelds zurück. Wenn der Benutzer auf Abbrechen klickt, gibt die Funktion eine Zeichenfolge der Länge NULL ("") zurück.
Hinweis
Sie müssen InputBox in einem Ausdruck verwenden, um mehr als das erste benannte Argument anzugeben. Wenn Sie einige Positionsargumente weglassen, müssen Sie das entsprechende Kommatrennzeichen einschließen.
Beispiel
Hinweis
Die folgenden Beispiele zeigen die Verwendung dieser Funktion in einem VBA-Modul (Visual Basic for Applications). Wenn Sie weitere Informationen zum Arbeiten mit VBA wünschen, wählen Sie Entwicklerreferenz in der Dropdownliste neben Suchen aus, und geben Sie einen oder mehrere Begriffe in das Suchfeld ein.
Dieses Beispiel zeigt verschiedene Methoden zur Verwendung der InputBox-Funktion, um den Benutzer zur Eingabe eines Werts aufzufordern. Wenn die X- und Y-Positionen nicht angegeben werden, wird das Dialogfeld automatisch für die jeweiligen Achsen zentriert. Die Variable MyValue enthält den vom Benutzer eingegebenen Wert, wenn der Benutzer auf OK klickt oder die EINGABETASTE drückt. Wenn der Benutzer auf Abbrechen klickt, wird eine Zeichenfolge der Länge NULL zurückgegeben.
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)