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 ungefähr 1.024 Zeichen, abhängig von der Breite der verwendeten 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 Kombination aus Wagenrücklauf-Zeilenvorschubzeichen (Chr(13) & Chr(10)) zwischen den einzelnen Zeilen trennen. |
| Titel | Optional. Zeichenfolgenausdruck, der auf der Titelleiste des Dialogfelds angezeigt wird. Wenn Sie den Titel weglassen, 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 die Standardeinstellung weglassen, 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 nicht angegeben 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 ausgelassen wird, wird das Dialogfeld etwa ein Drittel des Wegs nach unten auf dem Bildschirm vertikal positioniert. |
| Hilfedatei | Optional. Zeichenfolgenausdruck, der die Hilfedatei angibt, die verwendet wird, um kontextbezogene Hilfe für das Dialogfeld bereitzustellen. Wenn helpfile bereitgestellt wird, muss auch kontext angegeben werden. |
| Kontext | Optional. Numerischer Ausdruck, der die Hilfekontextnummer angibt, die dem entsprechenden Hilfethema vom Autor der Hilfe zugewiesen wurde. Wenn Kontext angegeben wird, muss auch die Hilfedatei bereitgestellt werden. |
Hinweise
Wenn sowohl Hilfedatei als auch Kontext angegeben werden, kann der Benutzer F1 (Windows) oder HILFE (Macintosh) drücken, um das Hilfethema anzuzeigen, das dem Kontext entspricht. Einige Hostanwendungen fügen dem Dialogfeld auch automatisch eine Hilfeschaltfläche 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
Um mehr als das erste benannte Argument anzugeben, müssen Sie InputBox in einem Ausdruck verwenden. 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)