Hilfe

CreateTextField

B+

Aufruf

textfield = CreateTextField (x, y, breite, höhe, gruppe [,style])

Parameter

x Koordinate X
y Koordinate Y
breite Breite von Textfield
höhe Höhe von Textfield
gruppe Identität einer Gruppe
style +1=Passworteingabe
+65536=Objekt fixieren


Rückgabewert

Identität des Textfield-Objekts wird zurückgeliefert


Beschreibung

Die Funktion CreateTextField erstellt ein Textfield-Objekt (Eingabezeile). Gib dazu die Startkoordinate X/Y und Breite/Höhe an. Gruppe ist die Identität von Window, Panel, Tabber oder Canvas.

Text kann mit SetGadgetText gesetzt und mit TextFieldText wieder ausgelesen werden.



Bei jeder Eingabe wird ein Event zurückgeliefert. EventData enthält dann die letzte Eingabe als ASCII-Wert.


Möchte man bei einem fokussiertem Eingabefeld das Betätigen der Esc- oder Returntaste abfangen, kann man dies mit Hilfe eines "Scheinbutton" bewerkstelligen. Siehe dazu CreateButton und dessen Modi 4 bzw. 5.


Beispiel

Erstellt eine Eingabezeile. Mit Return wird es beendet und eine Msgbox angezeigt:

window = CreateWindow("Window", 0, 0, 300, 100, 0, 1)
textfield = CreateTextField(10, 10, 200, 20, window)

Repeat
   If GetKey() = 27 Then End
   If WaitEvent() = $401 And EventSource() = textfield Then
      If EventData() = 13 Then
         Notify TextFieldText(textfield)
         End
      EndIf
   EndIf
Forever


Siehe auch

CreateLabel, TextFieldText

Übersicht GUI TextField