Eingabefeld

Zeigt eine Eingabeaufforderung in einem Dialogfeld an, wartet darauf, dass der Benutzer Text eingibt oder auf eine Schaltfläche klickt, und gibt den Inhalt des Textfelds zurück.

Aufbau

InputBox(Eingabeaufforderung[, Titel][, Standardwert][, x-Position][, y-Position][, Hilfedatei, Kontext])

Parameter

Eingabeaufforderung – Zeichenfolgenausdruck, der als Meldung im Dialogfeld angezeigt wird. Die maximale Länge der Eingabeaufforderung beträgt etwa 1024 Zeichen, abhängig von der Breite der verwendeten Zeichen. Wenn die Eingabeaufforderung aus mehr als einer Zeile besteht, können Sie die Zeilen durch ein Wagenrücklaufzeichen (Chr(13)), ein Zeilenvorschubzeichen (Chr(10)) oder eine Kombination aus Wagenrücklauf- und Zeilenvorschubzeichen (Chr(13) & Chr(10)) zwischen den einzelnen Zeilen trennen.

Titel – Zeichenfolgenausdruck, der in der Titelleiste des Dialogfelds angezeigt wird. Wenn Sie den Titel weglassen, wird der Name der Anwendung in der Titelleiste angezeigt.

Standard – Zeichenfolgenausdruck, der im Textfeld als Standardantwort angezeigt wird, wenn keine andere Eingabe erfolgt. Wenn Sie „default“ weglassen, wird das Textfeld leer angezeigt.

xpos – Numerischer Ausdruck, der in Twips den horizontalen Abstand zwischen dem linken Rand des Dialogfelds und dem linken Rand des Bildschirms angibt. Wenn „xpos“ weggelassen wird, wird das Dialogfeld horizontal zentriert.

ypos – Numerischer Ausdruck, der in Twips den vertikalen Abstand zwischen der Oberkante des Dialogfelds und dem oberen Bildschirmrand angibt. Wird „ypos“ weggelassen, wird das Dialogfeld etwa im unteren Drittel des Bildschirms positioniert.

helpfile – Zeichenfolgenausdruck, der die Hilfedatei angibt, die für die kontextsensitive Hilfe des Dialogfelds verwendet werden soll. Wenn „helpfile“ angegeben wird, muss auch „context“ angegeben werden.

Kontext – Numerischer Ausdruck, der die vom Hilfeautor dem entsprechenden Hilfethema zugewiesene Hilfe-Kontextsnummer angibt. Wenn ein Kontext angegeben wird, muss auch eine Hilfedatei angegeben werden.

Beschreibung

Wenn sowohl „helpfile“ als auch „context“ angegeben werden, wird dem Dialogfeld automatisch eine Schaltfläche „Hilfe“ hinzugefügt.

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 leere Zeichenkette ('') zurück.

Beispiel

Im folgenden Beispiel wird die Funktion InputBox verwendet, um ein Eingabefeld anzuzeigen und die Zeichenkette der Variablen Input zuzuweisen:

Dim Input

Input = InputBox("Geben Sie Ihren Namen ein")

MsgBox ("Sie haben eingegeben: " & Input) |