Das XdevTextArea ist ein mehrzeiliges Eingabefeld, das zu den Formular-Komponenten gehört.
Wichtige Events:
textChange - Wird nach einer kurzen Verzögerung ausgelöst, nachdem der Inhalt verändert wurde, u.a. durch Hinzufügen oder Löschen von Zeichen. Bei Properties > Misc > TextChangeEventMode kann der Zeitpunkt wann das Event ausgelöst wird, noch genauer definiert werden.
Misc
valueChange - Wird ausgelöst, wenn der Inhalt verändert wurde, u.a. durch Hinzufügen oder Löschen von Zeichen, jedoch erst wenn die UI-Komponente den Fokus verliert.
Wichtige Properies:
Rows - Definiert die Höhe einer Formular-Komponente in Zeilen. Eine Row entspricht ungefähr der Höhe eines Zeichens. Die Einstellung ist nur dann relevant, wenn in der Toolbox > Height?Undefined).
TextChangeEventMode - Legt fest, wann genau das Event textChange ausgelöst wird.
LAZY - Standard-Einstellung. Das Event wird erst ausgelöst, wenn nach der letzten Änderung eine Pause erfolgt. Die Länge der Pause kann bei Properties > Misc > TextChangeTimeout definiert werden.
- EAGER - Das Event wird bei jedem einzelnen Tastendruck ausgelöst.
- TIMEOUT - Das Event wird erst ausgelöst, wenn nach der letzten Änderung eine Pause erfolgt.
TextChangeTimeout - Definiert die Länge der Pause in Millisekunden nach der das Event textChange ausgelöst wird.
Examples:
Inhalt zuweisen - Weist dem XdevTextField einen Text als String zu. Dies kann ggf. ein textChange oder valueChange Event auslösen.
textArea.setValue("Hello 123 !!!");
Inhalt auslesen
String content = textArea.getValue();
Inhalt löschen - Löscht den gesamten Text im XdevTextArea. Dies kann ggf. ein textChange oder valueChange Event auslösen.
textArea.clear();
Cursor setzen - Setzt den Cursor an eine bestimmte Position. Die Position wird als int Wert angegeben.
textField.setCursorPosition(10);
Fokus setzen - Weist dem XdevTextArea den Focus zu. Dies kann ggf. ein focus Event auslösen.
textArea.focus();
Inhalt selektieren
textArea.selectAll();
Zur XdevTextArea Javadoc
Tipps:
String in Integer umwandeln - Wenn es sich beim Inhalt des XdevTextArea um eine Ganzzahl handelt mit der Sie weiter rechnen möchten, müssen Sie den String mit der Methode Integer.parseInt(String s) in einen Integer konvertieren. Die Methode nimmt einen String entgegen, der nur Ziffern enthält. Lediglich die Zeichen + und - am Anfang des Wertes sind erlaubt.
String content = textArea.getValue(); Integer value = Integer.parseInt(content);
Integer in String umwandeln - Wenn Sie einem XdevTextArea eine Ganzzahl zuweisen möchten, müssen Sie diese zuvor in einen String konvertieren, z.B. mit der Methode Integer.toString(Integer i).
Integer value = 100; String content = Integer.toString(value); textArea.setValue(content);