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 ( Eingabeaufforderung [, Titel ] [, Standard ] [, XPosition ] [, YPosition ] [, Hilfedatei ] [, Kontext ] )
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 von Eingabeaufforderung beträgt etwa 1024 Zeichen, abhängig von der Breite der verwendeten Zeichen. Wenn 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- und Zeilenvorschubzeichen (Chr(13) und Chr(10)) zwischen den einzelnen Zeilen trennen. |
|
Titel |
Optional. Zeichenfolgenausdruck, der auf der Titelleiste des Dialogfelds angezeigt wird. Wenn Sie Titel weglassen, wird der Name der Anwendung auf der Titelleiste platziert. |
|
Standard |
Optional. Zeichenfolgenausdruck, der im Textfeld als Standardantwort angezeigt wird, wenn keine weitere Eingabe bereitgestellt wird. Wenn Sie Standard 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 XPosition 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 YPosition nicht angegeben wird, wird das Dialogfeld vertikal positioniert – bei ca. einem Drittel des Bildschirms von oben. |
|
Hilfedatei |
Optional. Zeichenfolgenausdruck, der die Hilfedatei angibt, die verwendet wird, um kontextbezogene Hilfe für das Dialogfeld bereitzustellen. Wenn Hilfedatei angegeben wird, muss Kontext ebenfalls 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 Hilfedatei ebenfalls angegeben werden. |
Anmerkungen
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 Hostanwendung 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: Wenn Sie mehr als das erste genannte Argument angeben möchten, verwenden Sie InputBox in einem Ausdruck. Wenn Sie einige Positionsargumente weglassen, müssen Sie das entsprechende als 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)
