InputBox-Funktion

Microsoft® Visual Basic® Scripting Edition
InputBox Function

Beschreibung

Zeigt in einem Dialogfeld eine Eingabeaufforderung an, wartet auf eine Texteingabe oder die Auswahl einer Schaltfläche durch den Benutzer und gibt den Inhalt des Textfeldes zurück.

Syntax

InputBox(Eingabeaufforderung[, title][, Standard][, xpos][, ypos][, Hilfedatei, Kontext])

Die Syntax der InputBox-Funktion besteht aus folgenden Teilen:

Teil Beschreibung
Eingabeaufforderung Zeichenfolgeausdruck, der als Meldung im Dialogfeld angezeigt wird. Die maximale Länge der Eingabeaufforderung ist etwa 1024 Zeichen, abhängig von der Breite der verwendeten Zeichen. Wenn die Eingabeaufforderung mehr als eine Zeile umfaßt, können Sie zwei Zeilen jeweils durch ein Wagenrücklaufzeichen (Chr(13)), ein Zeilenvorschubzeichen (Chr(10)) oder eine Kombination aus Wagenrücklauf- und Zeilenvorschubzeichen (Chr(13)& Chr(10)) trennen.
Titel Zeichenfolgenausdruck, der in der Titelleiste des Dialogfelds angezeigt wird. Wenn Sie Titel nicht angeben, wird der Name der Anwendung in der Titelleiste angezeigt.
Standard Zeichenfolgenausdruck, der im Textfeld standardmäßig angezeigt wird, wenn keine andere Eingabe erfolgt. Wenn Sie Standard nicht angeben, wird ein leeres Textfeld angezeigt.
xpos Numerischer Ausdruck, der den horizontalen Abstand des linken Dialogfeldrands vom linken Bildschirmrand in Twips angibt. Wenn xpos nicht angegeben wird, wird das Dialogfeld horizontal zentriert.
ypos Numerischer Ausdruck, der den vertikalen Abstand des oberen Dialogfeldrands vom oberen Bildschirmrand in Twips angibt. Wenn ypos nicht angegeben wird, wird das Dialogfeld vertikal etwa um ein Drittel der Bildschirmhöhe nach unten verschoben.
Hilfedatei Zeichenfolgenausdruck, der die Hilfedatei angibt, die für die kontextbezogene Hilfe zum Dialogfeld geöffnet wird. Wenn Hilfedatei angegeben wird, muß Kontext ebenfalls angegeben werden.
Kontext Numerischer Ausdruck, der die Hilfe-Kontextnummer angibt, die der Hilfe-Autor dem zugehörigen Hilfethema zugeordnet hat. Wenn Kontext angegeben wird, muß Hilfedatei ebenfalls angegeben werden.

Anmerkungen

Wenn sowohl Hilfedatei als auch Kontext angegeben werden, wird dem Dialogfeld automatisch die Schaltfläche Hilfe hinzugefügt.
Wenn der Benutzer auf OK klickt oder die EINGABETASTE drückt, gibt die InputBox-Funktion den Inhalt des Textfeldes zurück. Klickt der Benutzer auf Abbrechen, so gibt die Funktion eine Zeichenfolge der Länge 0 ("") zurück.

Teil	Beschreibung
Eingabeaufforderung	Zeichenfolgeausdruck, der als Meldung im Dialogfeld angezeigt wird. Die maximale Länge der Eingabeaufforderung ist etwa 1024 Zeichen, abhängig von der Breite der verwendeten Zeichen. Wenn die Eingabeaufforderung mehr als eine Zeile umfaßt, können Sie zwei Zeilen jeweils durch ein Wagenrücklaufzeichen (Chr(13)), ein Zeilenvorschubzeichen (Chr(10)) oder eine Kombination aus Wagenrücklauf- und Zeilenvorschubzeichen (Chr(13)& Chr(10)) trennen.
Titel	Zeichenfolgenausdruck, der in der Titelleiste des Dialogfelds angezeigt wird. Wenn Sie Titel nicht angeben, wird der Name der Anwendung in der Titelleiste angezeigt.
Standard	Zeichenfolgenausdruck, der im Textfeld standardmäßig angezeigt wird, wenn keine andere Eingabe erfolgt. Wenn Sie Standard nicht angeben, wird ein leeres Textfeld angezeigt.
xpos	Numerischer Ausdruck, der den horizontalen Abstand des linken Dialogfeldrands vom linken Bildschirmrand in Twips angibt. Wenn xpos nicht angegeben wird, wird das Dialogfeld horizontal zentriert.
ypos	Numerischer Ausdruck, der den vertikalen Abstand des oberen Dialogfeldrands vom oberen Bildschirmrand in Twips angibt. Wenn ypos nicht angegeben wird, wird das Dialogfeld vertikal etwa um ein Drittel der Bildschirmhöhe nach unten verschoben.
Hilfedatei	Zeichenfolgenausdruck, der die Hilfedatei angibt, die für die kontextbezogene Hilfe zum Dialogfeld geöffnet wird. Wenn Hilfedatei angegeben wird, muß Kontext ebenfalls angegeben werden.
Kontext	Numerischer Ausdruck, der die Hilfe-Kontextnummer angibt, die der Hilfe-Autor dem zugehörigen Hilfethema zugeordnet hat. Wenn Kontext angegeben wird, muß Hilfedatei ebenfalls angegeben werden.