XdevFormattedTextField

Das FormattedTextField ist ein TextField, mit dem sich numerische Werte mit einer bestimmten Formatierung ausgeben lassen, z.B. mit Währungszeichen, 1000er Trennzeichen oder in einer länderspezifischer Schreibweise. Die Formatierung lässt sich über die Eigenschaft Format festlegen. Die Standardeinstellung Plattform-Standard ist generell empfehlenswert, da damit immer das Standardformat des jeweiligen Systems verwendet wird und Sie somit die Plattformunabhängigkeit Ihrer Anwendung wahren. Formatierungen werden jedoch grundsätzlich nicht mit gespeichert, sondern dienen lediglich der optischen Aufbereitung der Daten.

●Format: In den Eigenschaften können Sie den Format-Assistenten aufrufen, um den Text im Eingabefeld zu formatieren, z.B. für die Darstellung einer Währung oder eines Datums.

Für Berechnungen mit Werten aus einem XdevFormattedTextField müssen Sie diese mit Hilfe einer get Methode auslesen. Je nach Datentyp stehen dafür entsprechende get Methoden zur Verfügung, z.B. getInt( ), getDouble( ), etc. Da es sich beim Rückgabewert um einen Zahlenwert handelt, können Sie anschließend sämtliche von Java unterstützen mathematische Operationen durchführen.

int laenge = formattedTextField.getInt();
int breite = formattedTextField2.getInt();
int flaeche = laenge * breite;

formattedTextField3.setValue(flaeche);

Tipp: Das XdevFormattedTextField unterstützt auch Datums-Werte. Die Komponente XdevDateTextField ist dafür jedoch besser geeignet.

// Zeichenkette wird ausgelesen und in einer String-Variable gespeichert
String text = formattedTextField.getText();

●offs - Der Offset, welcher definiert, ab dem wievielten Zeichen die gewünschte Zeichenkette ausgelesen werden soll.

●Rückgabewert: Es wird die Zeichenkette zurückgegeben, welche anhand der übergebenen Parameter aus dem FormattedTextField ausgelesen wurde Beträgt die Länge 0, so wird ein leerer String zurückgegeben.

// Setzt den Text des FormattedTextFields auf "Hallo Welt!
formattedTextField.setText("Hallo Welt!");

//Liest den Inhalt des FormattedTextFields ab dem 7. Zeichen aus und beendet die Zeichenkette nach dem 4. ausgelesenen Zeichen.
String text = formattedTextField.getText(6, 4);

//Gibt "Welt" auf der Konsole aus
System.out.println(text);

●Rückgabewert: Der Textinhalt des FormattedTextFields als int. Kann dieser nicht konvertiert werden, wird eine Ausnahme erzeugt.

// Zeichenkette wird ausgelesen und in einer Integer-Variable gespeichert
int zahl = formattedTextField.getInt();

●defaultValue - Mit defaultValue geben Sie einen Integer-Wert an, der zurückgegeben wird, falls der Inhalt des FormattedTextFields nicht in einen Integerwert konvertiert werden kann.

●Rückgabewert: Der Wert des XdevFormattedTextFields als Integer. Kann der Inhalt der Komponente nicht konvertiert werden, wird der übergebene Standardwert zurückgegeben.

// Setzt den Text des FormattedTextFields auf "Hallo Welt!
formattedTextField.setText("Hallo Welt!");

// Liest den Inhalt des FormattedTextFields aus und versucht diesen zu Integer zu konvertieren.

// Speichert den Wert 5 in die Variable, da der Text "Hallo Welt!" nicht nach Integer konvertiert werden kann.
int value = formattedTextField.getInt(5);

●Rückgabewert: Der Textinhalt des FormattedTextFields als Double. Kann dieser nicht konvertiert werden, wird eine Ausnahme erzeugt.

// Zeichenkette wird ausgelesen und in einer Double-Variable gespeichert
double zahl = formattedTextField.getDouble();

●defaultValue - Mit defaultValue geben Sie einen Double-Wert an, der zurückgegeben wird, falls der Inhalt des FormattedTextFields nicht in einen Doublewert konvertiert werden kann.

●Rückgabewert: Der Wert des XdevFormattedTextFields als Double. Kann der Inhalt der Komponente nicht konvertiert werden, wird der übergebene Standardwert zurückgegeben.

// Setzt den Text des FormattedTextFields auf "Hallo Welt!
formattedTextField.setText("Hallo Welt!");

// Liest den Inhalt des FormattedTextFields aus und versucht diesen zu Double zu konvertieren.

// Speichert den Wert 5,5 in die Variable, da der Text "Hallo Welt!" nicht nach Double konvertiert werden kann.
double value = formattedTextField.getDouble(5.5);

●Rückgabewert: Der Textinhalt des FormattedTextFields als XdevDate. Kann dieser nicht konvertiert werden, wird eine Ausnahme erzeugt.

// Zeichenkette wird ausgelesen und in einer XdevDate-Variable gespeichert
XdevDate date = formattedTextField.getDate();

●defaultValue - Mit defaultValue geben Sie ein XdevDate an, das zurückgegeben wird, falls der Inhalt des FormattedTextFields nicht in ein XdevDate-Objekt konvertiert werden kann.

●Rückgabewert: Der Wert des XdevFormattedTextFields als XdevDate. Kann der Inhalt der Komponente nicht konvertiert werden, wird das übergebene Objekt zurückgegeben.

// Setzt den Text des FormattedTextFields auf "Hallo Welt!
formattedTextField.setText("Hallo Welt!");

// Liest den Inhalt des FormattedTextFields aus und versucht, diesen in ein XdevDate zu konvertieren.
// Speichert den Wert "14.01.14 00:00:00" in die Variable, da der Text "Hallo Welt!" nicht in ein XdevDate-Objekt konvertiert werden kann.
XdevDate date = formattedTextField.getDate(new XdevDate(2014,0,14));