Class DateInput

  • All Implemented Interfaces:
    Input, Part

    public class DateInput
    extends java.lang.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.
    • Constructor Summary

      Constructors 
      Constructor Description
      DateInput()
      Konstruktor ohne Datumsangabe aber mit Default-Format.
      DateInput​(java.util.Date date)
      Konstruktor mit uebergebenem Datum und Default-Format.
      DateInput​(java.util.Date date, java.text.DateFormat format)
      Konstruktor mit uebergebenem Datum und Format.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      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).
      void disableClientControl()
      Deaktiviert nur den Text.
      void enable()
      Aktiviert das komplette Control (Button und Text).
      void enableClientControl()
      Aktiviert nur den Text.
      void focus()
      Gibt diesem Eingabefeld den Focus.
      org.eclipse.swt.widgets.Control getControl()
      Liefert das eigentliche Eingabecontrol.
      java.lang.Object getData​(java.lang.String key)
      Liefert die Context-Daten.
      java.lang.String getName()
      Liefert die Label-Bezeichnung des Eingabe-Feldes.
      java.lang.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.
      void paint​(org.eclipse.swt.widgets.Composite parent)
      Positioniert und malt das Eingabefeld im uebergebenen Composite.
      void paint​(org.eclipse.swt.widgets.Composite parent, int width)
      Positioniert und malt das Eingabefeld im uebergebenen Composite.
      void setComment​(java.lang.String comment)
      Fuegt hinter das Eingabefeld noch einen Kommentar.
      void setData​(java.lang.String key, java.lang.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​(java.lang.String name)
      Speichert die Label-Bezeichnung des Eingabe-Feldes.
      void setText​(java.lang.String text)
      Legt den anzuzeigenden Text auf dem Kalender-Dialog fest.
      void setTitle​(java.lang.String title)
      Legt den auf dem Kalender-Dialog anzuzeigenden Titel fest.
      void setValue​(java.lang.Object value)
      Schreibt einen neuen Wert in das Eingabefeld.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • DateInput

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

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

        public DateInput​(java.util.Date date,
                         java.text.DateFormat format)
        Konstruktor mit uebergebenem Datum und Format.
        Parameters:
        date - das Datum.
        format - das Format.
    • Method Detail

      • 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 java.lang.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​(java.lang.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​(java.lang.String text)
        Legt den anzuzeigenden Text auf dem Kalender-Dialog fest.
        Parameters:
        text - Text auf dem Kalender-Dialog.
      • setTitle

        public void setTitle​(java.lang.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:
        Part.paint(org.eclipse.swt.widgets.Composite)
      • 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​(java.lang.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 java.lang.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​(java.lang.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​(java.lang.String key,
                            java.lang.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 java.lang.Object getData​(java.lang.String key)
        Description copied from interface: Input
        Liefert die Context-Daten.
        Specified by:
        getData in interface Input
        Parameters:
        key - der Schluessel.
        Returns:
        die Contextdaten.