# Funktionsreferenz

InputBox

Zeigt eine InputBox an, die den Nutzer auffordert, einen String einzugeben.

InputBox ( "title", "Prompt" [, "Default" [, "password char" [, Width, Height [, Left, Top [, TimeOut]]]]] )

Parameter

title | Der Titel der InputBox
prompt | Ein Beschreibungstext für den Nutzer, damit er weiß, was er eingeben soll.
default | Der Startwert der InputBox
password char | [optional] Das Zeichen, mit dem alle eingegebenen Zeichen maskiert werden. Wenn du willst, dass das echte Zeichen angezeigt werden soll, dann übergebe einen leeren String ("") (Standardwert) oder ein Leerzeichen als erstes Zeichen. Wenn du einen mehrere Zeichen langen String angibst, wird nur das erste Zeichen zum Maskieren genutzt. Die weiteren Zeichen haben eine besondere Bedutung. Siehe dazu die Bemerkungen.
width | [optional] Die Breite des Fensters. Wenn die Breite definiert wird, muss auch die Höhe angegeben werden. Gib -1 an, um die Standardbreite zu verwenden.
height | [optional] Die Höhe des Fensters. Wenn die Höhe definiert wird, muss auch die Breite angegeben werden. Gib -1 an, um die Standardhöhe zu verwenden
left | [optional] Horizontale Position der InputBox. Standardmäßig wird die Box zentriert. Wenn angegeben, muss auch die vertikale Position bestimmt werden.
top | [optional] Vertikale Position der InputBox. Standardmäßig wird die Box zentriert. Wenn angegeben, muss auch die horizontale Position bestimmt werden.
timeout | [optional] Wie viele Sekunden soll gewartet werden, bis die InputBox automatisch über den Cancel-Button verlassen wird.

Bemerkungen

BlockInput(1) hindert Windows 98-/Me-Nutzer daran, Daten einzugeben.
Die InputBox ist größenveränderbar, hat aber eine Mindestgröße von ungefähr 190 x 115 Pixeln. Die Standardgröße ist ungefähr 250 x 190 Pixel.
Der zurückgegebene String wird nicht länger als 254 Zeichen sein und wenn die Eingabe Tabulatoren o.ä. enthält, wird der String bei deren erstem Vorkommen abgeschnitten.
Die zweiten und folgenden Zeichen des Password-Parameters können verwendet werden, um die Eingabemöglichkeiten einzuschränken. Ein Leerzeichen an erster Stelle bewirkt, dass die Eingaben im Klartext angezeigt werden. Ein M nach dem ersten Zeichen zeigt, dass eine Eingabe getätigt werden muss. Es wird dann nichts passieren, wenn der Nutzer "OK" drückt, ohne einen Text einzugeben. Das Fenster wird nicht geschlossen und gibt nichts zurück.
Am Ende kannst du noch die Maximallänge der Eingabe festlegen. Gib einfach eine Zahl ganz hinten an, um die Länge zu bestimmen.

Siehe auch

MsgBox

Beispiel

;Places the input box in the top left corner displaying the characters as they
;are typed.
$answer = InputBox("Question", "Where were you born?", "Planet Earth", "", _
-1, -1, 0, 0)
;Asks the user to enter a password. Don't forget to validate it!
$passwd = InputBox("Security Check", "Enter your password.", "", "*")
;Asks the user to enter a 1 or 2 character response. The M in the password
;field indicates that blank string are not accepted and the 2 indicates that the
;responce will be at most 2 characters long.
$value = InputBox("Testing", "Enter the 1 or 2 character code.", "", " M2")