Class DateInput

java.lang.Object
de.willuhn.jameica.gui.input.DateInput
All Implemented Interfaces:
Input, Part
public class DateInput extends Object implements Input
Fix und fertig konfiguriertes Eingabe-Feld fuer die Datumseingabe. Das ist ein Meta-Input-Feld, welches sich unter der Haube aus einem DialogInput und einem CalendarDialog zusammensetzt.

  • Field Summary

    Fields inherited from interface Input

    DATAKEY_TOOLTIP

  • Constructor Summary

    Constructors
    Constructor
    Description
    DateInput()
    Konstruktor ohne Datumsangabe aber mit Default-Format.
    DateInput(Date date)
    Konstruktor mit uebergebenem Datum und Default-Format.
    DateInput(Date date, DateFormat format)
    Konstruktor mit uebergebenem Datum und Format.

  • Method Summary

    Modifier and Type
    Method
    Description
    final void
    addListener(org.eclipse.swt.widgets.Listener l)
    Fuegt dem Eingabe-Feld einen Listener hinzu, der bei jedem Focus-Wechsel ausgeloest wird.
    void
    disable()
    Deaktiviert das komplette Control (Button und Text).
    final void
    disableClientControl()
    Deaktiviert nur den Text.
    void
    enable()
    Aktiviert das komplette Control (Button und Text).
    final void
    enableClientControl()
    Aktiviert nur den Text.
    void
    focus()
    Gibt diesem Eingabefeld den Focus.
    org.eclipse.swt.widgets.Control
    getControl()
    Liefert das eigentliche Eingabecontrol.
    Object
    getData(String key)
    Liefert die Context-Daten.
    String
    getName()
    Liefert die Label-Bezeichnung des Eingabe-Feldes.
    Object
    getValue()
    Liefert ein Objekt vom Typ Date oder null, wenn das Datum nicht geparst werden konnte.
    boolean
    hasChanged()
    Prueft, ob sich der Wert von Input.getValue() seit dem letzten Aufruf von hasChanged() geaendert hat.
    boolean
    isEnabled()
    Prueft, ob das Eingabe-Feld aktiv ist.
    boolean
    isMandatory()
    Prueft, ob es sich um ein Pflichtfeld handelt.
    final void
    paint(org.eclipse.swt.widgets.Composite parent)
    Positioniert und malt das Eingabefeld im uebergebenen Composite.
    final void
    paint(org.eclipse.swt.widgets.Composite parent, int width)
    Positioniert und malt das Eingabefeld im uebergebenen Composite.
    void
    setComment(String comment)
    Fuegt hinter das Eingabefeld noch einen Kommentar.
    void
    setData(String key, Object data)
    Speichert optionale Context-Daten.
    void
    setEnabled(boolean enabled)
    Aktiviert oder deaktiviert das komplette Control (Button und Text).
    void
    setMandatory(boolean mandatory)
    Legt fest, ob es sich um ein Pflichtfeld handelt.
    void
    setName(String name)
    Speichert die Label-Bezeichnung des Eingabe-Feldes.
    void
    setText(String text)
    Legt den anzuzeigenden Text auf dem Kalender-Dialog fest.
    void
    setTitle(String title)
    Legt den auf dem Kalender-Dialog anzuzeigenden Titel fest.
    void
    setValue(Object value)
    Schreibt einen neuen Wert in das Eingabefeld.

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

    • DateInput

      public DateInput()
      Konstruktor ohne Datumsangabe aber mit Default-Format.

    • DateInput

      public DateInput(Date date)
      Konstruktor mit uebergebenem Datum und Default-Format.
      Parameters:
      date - das Datum.

    • DateInput

      public DateInput(Date date, DateFormat format)
      Konstruktor mit uebergebenem Datum und Format.
      Parameters:
      date - das Datum.
      format - das Format.

  • Method Details

    • disable

      public void disable()
      Deaktiviert das komplette Control (Button und Text).
      Specified by:
      disable in interface Input

    • enable

      public void enable()
      Aktiviert das komplette Control (Button und Text).
      Specified by:
      enable in interface Input

    • focus

      public void focus()
      Description copied from interface: Input
      Gibt diesem Eingabefeld den Focus.
      Specified by:
      focus in interface Input

    • getControl

      public org.eclipse.swt.widgets.Control getControl()
      Description copied from interface: Input
      Liefert das eigentliche Eingabecontrol. Es muss von jeder abgeleiteten Klasse implementiert werden und das Eingabe-Feld zurueckliefern.

      Da der Implementierer das Composite benoetigt, in dem das Control positioniert werden soll, kann er sich der Methode AbstractInput.getParent() in dieser Klasse bedienen.

      Specified by:
      getControl in interface Input
      Returns:
      das zu zeichnende Control.

    • getValue

      public Object getValue()
      Liefert ein Objekt vom Typ Date oder null, wenn das Datum nicht geparst werden konnte.
      Specified by:
      getValue in interface Input
      Returns:
      Wert des Feldes.

    • isEnabled

      public boolean isEnabled()
      Description copied from interface: Input
      Prueft, ob das Eingabe-Feld aktiv ist.
      Specified by:
      isEnabled in interface Input
      Returns:
      true, wenn es aktiv ist.

    • setEnabled

      public void setEnabled(boolean enabled)
      Aktiviert oder deaktiviert das komplette Control (Button und Text).
      Specified by:
      setEnabled in interface Input
      Parameters:
      enabled - true, wenn es aktiv sein soll.

    • enableClientControl

      public final void enableClientControl()
      Aktiviert nur den Text.

    • disableClientControl

      public final void disableClientControl()
      Deaktiviert nur den Text.

    • setValue

      public void setValue(Object value)
      Description copied from interface: Input
      Schreibt einen neuen Wert in das Eingabefeld.
      Specified by:
      setValue in interface Input
      Parameters:
      value - der neu anzuzeigende Wert.

    • setText

      public void setText(String text)
      Legt den anzuzeigenden Text auf dem Kalender-Dialog fest.
      Parameters:
      text - Text auf dem Kalender-Dialog.

    • setTitle

      public void setTitle(String title)
      Legt den auf dem Kalender-Dialog anzuzeigenden Titel fest.
      Parameters:
      title - der auf dem Dialog anzuzeigende Titel.

    • addListener

      public final void addListener(org.eclipse.swt.widgets.Listener l)
      Description copied from interface: Input
      Fuegt dem Eingabe-Feld einen Listener hinzu, der bei jedem Focus-Wechsel ausgeloest wird. Besteht das Eingabe-Feld aus mehreren Teilen (z.Bsp. bei SearchInput aus Eingabe-Feld + Knopf dahinter) dann wird der Listener bei Focus-Wechsel jedes dieser Teile ausgeloest.
      Specified by:
      addListener in interface Input
      Parameters:
      l - zu registrierender Listener.

    • paint

      public final void paint(org.eclipse.swt.widgets.Composite parent)
      Description copied from interface: Input
      Positioniert und malt das Eingabefeld im uebergebenen Composite. Es wird dabei mit einer vorgegebenen Standard-Breite gemalt.
      Specified by:
      paint in interface Input
      Specified by:
      paint in interface Part
      Parameters:
      parent - Das Composite, in dem das Eingabefeld gemalt werden soll.
      See Also:

    • paint

      public final void paint(org.eclipse.swt.widgets.Composite parent, int width)
      Description copied from interface: Input
      Positioniert und malt das Eingabefeld im uebergebenen Composite.
      Specified by:
      paint in interface Input
      Parameters:
      parent - Das Composite, in dem das Eingabefeld gemalt werden soll.
      width - angegebene Breite.

    • setComment

      public void setComment(String comment)
      Description copied from interface: Input
      Fuegt hinter das Eingabefeld noch einen Kommentar. Existiert der Kommentar bereits, wird er gegen den neuen ersetzt.

      Hinweis: Wird die Funktion nicht aufgerufen, bevor das Eingabe-Feld gemalt wird, dann wird es auch nicht angezeigt. Denn vorm Malen muss bekannt sein, ob es angezeigt werden soll, damit der Platz dafuer reserviert werden kann.

      Specified by:
      setComment in interface Input
      Parameters:
      comment - Kommentar.

    • isMandatory

      public boolean isMandatory()
      Description copied from interface: Input
      Prueft, ob es sich um ein Pflichtfeld handelt.
      Specified by:
      isMandatory in interface Input
      Returns:
      true, wenn es sich um ein Pflichfeld handelt.

    • setMandatory

      public void setMandatory(boolean mandatory)
      Description copied from interface: Input
      Legt fest, ob es sich um ein Pflichtfeld handelt.
      Specified by:
      setMandatory in interface Input
      Parameters:
      mandatory - true, wenn es ein Pflichtfeld ist.

    • getName

      public String getName()
      Description copied from interface: Input
      Liefert die Label-Bezeichnung des Eingabe-Feldes.
      Specified by:
      getName in interface Input
      Returns:
      Label-Bezeichnung.

    • setName

      public void setName(String name)
      Description copied from interface: Input
      Speichert die Label-Bezeichnung des Eingabe-Feldes.
      Specified by:
      setName in interface Input
      Parameters:
      name - Label-Bezeichnung.

    • hasChanged

      public boolean hasChanged()
      Description copied from interface: Input
      Prueft, ob sich der Wert von Input.getValue() seit dem letzten Aufruf von hasChanged() geaendert hat.
      Specified by:
      hasChanged in interface Input
      Returns:
      true, wenn sich der Wert geaendert hat, sonst false.

    • setData

      public void setData(String key, Object data)
      Description copied from interface: Input
      Speichert optionale Context-Daten.
      Specified by:
      setData in interface Input
      Parameters:
      key - freier Schluessel.
      data - beliebige Nutzdaten.
      See Also:
      • Widget.setData(Object)

    • getData

      public Object getData(String key)
      Description copied from interface: Input
      Liefert die Context-Daten.
      Specified by:
      getData in interface Input
      Parameters:
      key - der Schluessel.
      Returns:
      die Contextdaten.