de.willuhn.jameica.gui.input

Class DateInput

java.lang.Object

de.willuhn.jameica.gui.input.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 and 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

Methods

Modifier and Type	Method and 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 java.util.Date oder null, wenn das Datum nicht geparst werden konnte.
boolean	hasChanged() Prueft, ob sich der Wert von 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

See Also:

Input.disable()

enable

public void enable()

Aktiviert das komplette Control (Button und Text).

Specified by:

enable in interface Input

See Also:

Input.enable()

focus

public void focus()

Description copied from interface: Input

Gibt diesem Eingabefeld den Focus.

Specified by:

focus in interface Input

See Also:

Input.focus()

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 getParent() in dieser Klasse bedienen.

Specified by:

getControl in interface Input

Returns:

das zu zeichnende Control.

See Also:

Input.getControl()

getValue

public java.lang.Object getValue()

Liefert ein Objekt vom Typ java.util.Date oder null, wenn das Datum nicht geparst werden konnte.

Specified by:

getValue in interface Input

Returns:

Wert des Feldes.

See Also:

Input.getValue()

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.

See Also:

Input.isEnabled()

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.

See Also:

Input.setEnabled(boolean)

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.

See Also:

Input.setValue(java.lang.Object)

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.

See Also:

Input.addListener(org.eclipse.swt.widgets.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:

Input.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.

See Also:

Input.paint(org.eclipse.swt.widgets.Composite, int)

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.

See Also:

Input.setComment(java.lang.String)

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.

See Also:

Input.isMandatory()

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.

See Also:

Input.setMandatory(boolean)

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.

See Also:

Input.getName()

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.

See Also:

Input.setName(java.lang.String)

hasChanged

public boolean hasChanged()

Description copied from interface: Input

Prueft, ob sich der Wert von getValue() seit dem letzten Aufruf von hasChanged geaendert hat.

Specified by:

hasChanged in interface Input

Returns:

true, wenn sich der Wert geaendert hat, sonstfalse.

See Also:

Input.hasChanged()

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:

Input.setData(java.lang.String, java.lang.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.

See Also:

Input.getData(java.lang.String)