[Inhalt] [Zurück] [Weiter] [Thema] [Index]

InputBox()


Syntax:

InputBox (String text, Real breite, String vorgabe [,Bool abbr [,Real maxz [, Bool geheim]]]) : String
text: beliebiger Text
breite: Breite des Eingabefeldes in Pixeln
vorgabe: Vorbelegung des Eingabefeldes
abbr: optional: es wird ein Abbruchbutton erzeugt
maxz: optional: Maximale Anzahl eingebbarer Zeichen
geheim: optional: Eingabe erfolgt verdeckt

Beispiel:

dateiname := InputBox("Bitte Dateinamen eingeben", 100, "out.dat")

Beschreibung:

Erzeugt ein neues Fenster, welches den Text text, ein Eingabefeld und einen OK-Button enthält. breite ist die Breite dieses Eingabefeldes und vorgabe dessen Vorbelegung.

Mit abbr kann eingestellt werden, ob neben dem OK-Button auch ein Abbruch-Button erzeugt werden soll.

Mit maxz kann optional angegeben werden, wieviel Zeichen der Benutzer maximal eingeben kann. Die Voreinstellung ist 0, also beliebig viele.

Wenn geheim True ist, erfolgt die Eingabe verdeckt. Die Voreinstellung ist False.

Das AGWindow, aus dem diese Input-Box gestartet wurde, ist solange inaktiv, bis der Benutzer den OK-Button (oder den Abbruch-Button) gedrückt hat oder im Eingabefeld Return drückt. Der Programmablauf wird solange angehalten.

Der Rückgabewert ist der Inhalt des Eingabefeldes, es sei denn der Abbruch-Button wurde gedrückt, dann ist der Inhalt das Ascii-Zeichen 3. (Char(3))

Zur Positionierung des Fensters siehe OkBox().

Siehe auch OkBox(), SelectBox(), ElementBox(), MultiBox(), ZIBox() und MakeModalWin().



toposoft 28.10.2024