Office: InputBox-Funktion (Eingabefeld)

InputBox-Funktion (Eingabefeld)
Access für Microsoft 365 Access 2019 Access 2016 Access 2013 Access 2010 Access 2007 Mehr... Weniger 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, z. B. Microsoft Office Excel 2007, fügen ebenfalls automatisch eine Hilfe-Schaltfläche zum Dialogfeld 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.

:)