java.lang.Object
   |
   +--java.awt.Component
         |
         +--java.awt.Container
               |
               +--javax.swing.JComponent
                     |
                     +--javax.swing.text.JTextComponent
                           |
                           +--javax.swing.JTextField
                                 |
                                 +--javax.swing.JFormattedTextField

Deklaration

Beschreibung

• JFormattedTextField.REVERT
  Wenn der eingegebene Wert nicht richtig ist, wird der alte Wert erneut genommen.
• JFormattedTextField.COMMIT
  Der Wert wird übernommen, wenn er korrekt ist. Andernfalls bleibt der falsche Wert im Feld stehen.
• JFormattedTextField.COMMIT_OR_REVERT (der Standard)
  Wenn der neue Wert korrekt ist, wird er übernommen. Ansonsten wird der alte Wert zurückgeholt.
• JFormattedTextField.PERSIST
  Der neue Wert wird weder überprüft noch ü,bernommen.

Wenn man verhindern will, dass die Komponete bei falscher Eingabe verlassen werden kann, kann folgender Code verwendet werden:

 public class FormattedTextFieldVerifier extends InputVerifier {
     public boolean verify(JComponent input) {
         if (input instanceof JFormattedTextField) {
             JFormattedTextField ftf = (JFormattedTextField)input;
             AbstractFormatter formatter = ftf.getFormatter();
             if (formatter != null) {
                 String text = ftf.getText();
                 try {
                      formatter.stringToValue(text);
                      return true;
                  } catch (ParseException pe) {
                      return false;
                  }
              }
          }
          return true;
      }
      public boolean shouldYieldFocus(JComponent input) {
          return verify(input);
      }
  }
 

Datenelemente im Detail

public final static int COMMIT

Konstante, die angibt, dass beim Verlust des Fokus commitEdit aufgerufen werden soll. Bei einer Exception passiert weiter nichts.

public final static int COMMIT_OR_REVERT

Konstante, die angibt, dass beim Verlust des Fokus commitEdit aufgerufen werden soll. Bei einer Exception wird der alte Wert genommen.

public final static int REVERT

Konstante, die angibt, dass beim Verlust des Fokus der alte Wert wieder genommen wird.

public final static int PERSIST

Konstante, die angibt, dass beim Verlust des Fokus der neue Wert behalten bleibt.

Konstruktoren im Detail

public JFormattedTextField()

Erzeugt ein neues Exemplar.

public JFormattedTextField(Object value)

Erzeugt ein nees Exemplar mit dem angegebenen Inhalt.

public JFormattedTextField(Format format)

Erstellt ein neues Exemplar, das das angegebene Format aufweist.

public JFormattedTextField(JFormattedTextField.AbstractFormatter formatter)

Erstellt ein neues Exemplar mit dem angegebenen AbstractFormatter.

public JFormattedTextField(JFormattedTextField.AbstractFormatterFactory factory)

Erstellt ein neues Exemplar mit der angegebenen Factory.

public JFormattedTextField(JFormattedTextField.AbstractFormatterFactory factory, Object currentValue)

Erstellt ein neues Exemplar mit der angegebenen Factory und dem angegebenen Wert.

Methoden im Detail

public void setFocusLostBehavior(int behavior)

Setzt das Verhalten beim Verlassen der Komponente auf JFormattedTextField.COMMIT_OR_REVERT, JFormattedTextField.REVERT, JFormattedTextField.COMMIT oder JFormattedTextField.PERSIST.

public int getFocusLostBehavior()

Liefert das Verhalten beim Verlassen der Komponente (JFormattedTextField.COMMIT_OR_REVERT, JFormattedTextField.REVERT, JFormattedTextField.COMMIT oder JFormattedTextField.PERSIST).

public void setFormatterFactory(JFormattedTextField.AbstractFormatterFactory tf)

Setzt die Factory, die ein Exemplar des AbstractFormatter liefert.

public JFormattedTextField.AbstractFormatterFactory getFormatterFactory()

Liefert die Factory.

protected void setFormatter(JFormattedTextField.AbstractFormatter format)

Setzt den AbstractFormatter. Man sollte jedoch eine Factory setzten.

public JFormattedTextField.AbstractFormatter getFormatter()

Liefert den AbstractFormatter, der den aktuellen Wert anzeigt und parst.

public void setValue(Object value)

Setzt den Wert.

public Object getValue()

Liefert den Wert.

public void commitEdit()

Speichert, wenn möglich, den aktuellen Wert.

Exception: ParseException

• Wird ausgelöst, wenn der AbstractFormatter den Wert nicht annehmen konnte..

public boolean isEditValid()

Liefert true, wenn der aktuell editierte Wert korrekt ist.

protected void invalidEdit()

Wird aufgerufen, wenn der Benutzer ein ungültigen Wert eingegeben hat. Die Standard-Implementierung gibt ein akustisches Signal aus.

protected void processFocusEvent(FocusEvent e)

Behandlet den Fokus-Event.

public Action[] getActions()

Liefert die Actions des Editors.

public String getUIClassID()

Liefert den Namen der Look-and-Feel-Klasse, die diese Komponente rendert.

public void setDocument(Document doc)

Setzt das Dokument bei dem Editor.