org.cruxframework.crux.widgets.client.datebox.gwtoverride

Class DateBox

java.lang.Object

com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.Widget

com.google.gwt.user.client.ui.Composite

org.cruxframework.crux.widgets.client.datebox.gwtoverride.DateBox

All Implemented Interfaces:

com.google.gwt.editor.client.IsEditor<com.google.gwt.editor.client.LeafValueEditor<Date>>, com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.logical.shared.HasValueChangeHandlers<Date>, com.google.gwt.event.shared.HasHandlers, com.google.gwt.user.client.EventListener, com.google.gwt.user.client.TakesValue<Date>, com.google.gwt.user.client.ui.HasEnabled, com.google.gwt.user.client.ui.HasValue<Date>, com.google.gwt.user.client.ui.HasVisibility, com.google.gwt.user.client.ui.IsRenderable, com.google.gwt.user.client.ui.IsWidget

public class DateBox
extends com.google.gwt.user.client.ui.Composite
implements com.google.gwt.user.client.ui.HasEnabled, com.google.gwt.user.client.ui.HasValue<Date>, com.google.gwt.editor.client.IsEditor<com.google.gwt.editor.client.LeafValueEditor<Date>>

CruxDateBox

Author:

Samuel Almeida Cardoso (samuel@cruxframework.org)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DateBox.DefaultFormat Default DateBox.Format class.
static interface	DateBox.Format Implemented by a delegate to handle the parsing and formating of date values.

Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.UIObject.DebugIdImpl, com.google.gwt.user.client.ui.UIObject.DebugIdImplEnabled

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_STYLENAME Default style name.

Fields inherited from class com.google.gwt.user.client.ui.UIObject

DEBUG_ID_PREFIX

Constructor Summary

Constructors

Constructor and Description
DateBox() Create a date box with a new DatePicker.
DateBox(DatePicker picker, Date date, DateBox.Format format) Create a new date box.

Method Summary

Methods

Modifier and Type	Method and Description
com.google.gwt.event.shared.HandlerRegistration	addValueChangeHandler(com.google.gwt.event.logical.shared.ValueChangeHandler<Date> handler)
com.google.gwt.editor.client.LeafValueEditor<Date>	asEditor() Returns a TakesValueEditor backed by the DateBox.
int	getCursorPos() Gets the current cursor position in the date box.
DatePicker	getDatePicker() Gets the date picker.
boolean	getFireNullValues() Returns true iff the date box will fire ValueChangeEvents with a date value of null for invalid or empty string values.
DateBox.Format	getFormat() Gets the format instance used to control formatting and parsing of this DateBox.
com.google.gwt.user.client.ui.PopupPanel	getPopup()
int	getTabIndex() Gets the date box's position in the tab index.
com.google.gwt.user.client.ui.TextBox	getTextBox() Get text box.
Date	getValue() Get the date displayed, or null if the text box is empty, or cannot be interpreted.
void	hideDatePicker() Hide the date picker.
boolean	isDatePickerShowing() Returns true if date picker is currently showing, false if not.
boolean	isEnabled() Returns true if the date box is enabled, false if not.
void	setAccessKey(char key) Sets the date box's 'access key'.
void	setEnabled(boolean enabled) Sets whether the date box is enabled.
void	setFireNullValues(boolean fireNullValues) Sets whether or not the date box will fire ValueChangeEvents with a date value of null for invalid or empty string values.
void	setFocus(boolean focused) Explicitly focus/unfocus this widget.
void	setFormat(DateBox.Format format) Sets the format used to control formatting and parsing of dates in this DateBox.
void	setTabIndex(int index) Sets the date box's position in the tab index.
void	setValue(Date date) Set the date.
void	setValue(Date date, boolean fireEvents)
void	showDatePicker() Parses the current date box's value and shows that date.

Methods inherited from class com.google.gwt.user.client.ui.Composite

claimElement, getWidget, initializeClaimedElement, initWidget, isAttached, onAttach, onBrowserEvent, onDetach, render, render, resolvePotentialElement, setWidget

Methods inherited from class com.google.gwt.user.client.ui.Widget

addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, fireEvent, getHandlerCount, getLayoutData, getParent, isOrWasAttached, onLoad, onUnload, removeFromParent, setLayoutData, sinkEvents

Methods inherited from class com.google.gwt.user.client.ui.UIObject

addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, getTitle, isVisible, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, setElement, setElement, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, sinkBitlessEvent, toString, unsinkEvents

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.gwt.event.shared.HasHandlers

fireEvent

Field Detail

DEFAULT_STYLENAME

public static final String DEFAULT_STYLENAME

Default style name.

See Also:

Constant Field Values

Constructor Detail

DateBox

public DateBox()

Create a date box with a new DatePicker.

DateBox

public DateBox(DatePicker picker,
       Date date,
       DateBox.Format format)

Create a new date box.

Parameters:

date - the default date.

picker - the picker to drop down from the date box

format - to use to parse and format dates

Method Detail

addValueChangeHandler

public com.google.gwt.event.shared.HandlerRegistration addValueChangeHandler(com.google.gwt.event.logical.shared.ValueChangeHandler<Date> handler)

Specified by:

addValueChangeHandler in interface com.google.gwt.event.logical.shared.HasValueChangeHandlers<Date>

asEditor

public com.google.gwt.editor.client.LeafValueEditor<Date> asEditor()

Returns a TakesValueEditor backed by the DateBox.

Specified by:

asEditor in interface com.google.gwt.editor.client.IsEditor<com.google.gwt.editor.client.LeafValueEditor<Date>>

getCursorPos

public int getCursorPos()

Gets the current cursor position in the date box.

Returns:

the cursor position

getDatePicker

public DatePicker getDatePicker()

Gets the date picker.

Returns:

the date picker

getFireNullValues

public boolean getFireNullValues()

Returns true iff the date box will fire ValueChangeEvents with a date value of null for invalid or empty string values.

getFormat

public DateBox.Format getFormat()

Gets the format instance used to control formatting and parsing of this DateBox.

Returns:

the format

getTabIndex

public int getTabIndex()

Gets the date box's position in the tab index.

Returns:

the date box's tab index

getTextBox

public com.google.gwt.user.client.ui.TextBox getTextBox()

Get text box.

Returns:

the text box used to enter the formatted date

getValue

public Date getValue()

Get the date displayed, or null if the text box is empty, or cannot be interpreted.

Specified by:

getValue in interface com.google.gwt.user.client.TakesValue<Date>

Specified by:

getValue in interface com.google.gwt.user.client.ui.HasValue<Date>

Returns:

the current date value

hideDatePicker

public void hideDatePicker()

Hide the date picker.

isDatePickerShowing

public boolean isDatePickerShowing()

Returns true if date picker is currently showing, false if not.

isEnabled

public boolean isEnabled()

Returns true if the date box is enabled, false if not.

Specified by:

isEnabled in interface com.google.gwt.user.client.ui.HasEnabled

setAccessKey

public void setAccessKey(char key)

Sets the date box's 'access key'. This key is used (in conjunction with a browser-specific modifier key) to automatically focus the widget.

Parameters:

key - the date box's access key

setEnabled

public void setEnabled(boolean enabled)

Sets whether the date box is enabled.

Specified by:

setEnabled in interface com.google.gwt.user.client.ui.HasEnabled

Parameters:

enabled - is the box enabled

setFireNullValues

public void setFireNullValues(boolean fireNullValues)

Sets whether or not the date box will fire ValueChangeEvents with a date value of null for invalid or empty string values.

setFocus

public void setFocus(boolean focused)

Explicitly focus/unfocus this widget. Only one widget can have focus at a time, and the widget that does will receive all keyboard events.

Parameters:

focused - whether this widget should take focus or release it

setFormat

public void setFormat(DateBox.Format format)

Sets the format used to control formatting and parsing of dates in this DateBox. If this DateBox is not empty, the contents of date box will be replaced with current contents in the new format.

Parameters:

format - the new date format

setTabIndex

public void setTabIndex(int index)

Sets the date box's position in the tab index. If more than one widget has the same tab index, each such widget will receive focus in an arbitrary order. Setting the tab index to -1 will cause this widget to be removed from the tab order.

Parameters:

index - the date box's tab index

setValue

public void setValue(Date date)

Set the date.

Specified by:

setValue in interface com.google.gwt.user.client.TakesValue<Date>

Specified by:

setValue in interface com.google.gwt.user.client.ui.HasValue<Date>

setValue

public void setValue(Date date,
            boolean fireEvents)

Specified by:

setValue in interface com.google.gwt.user.client.ui.HasValue<Date>

showDatePicker

public void showDatePicker()

Parses the current date box's value and shows that date.

getPopup

public com.google.gwt.user.client.ui.PopupPanel getPopup()