com.sencha.gxt.widget.core.client

Class DatePicker

java.lang.Object

Widget

com.sencha.gxt.widget.core.client.Component

com.sencha.gxt.widget.core.client.DatePicker

All Implemented Interfaces:

HasGestureRecognizers, BeforeHideEvent.HasBeforeHideHandlers, BeforeShowContextMenuEvent.HasBeforeShowContextMenuHandler, BeforeShowEvent.HasBeforeShowHandlers, BlurEvent.HasBlurHandlers, DisableEvent.HasDisableHandlers, EnableEvent.HasEnableHandlers, FocusEvent.HasFocusHandlers, HideEvent.HasHideHandlers, MoveEvent.HasMoveHandlers, ShowContextMenuEvent.HasShowContextMenuHandler, ShowEvent.HasShowHandlers, HasFocusSupport, HasItemId

public class DatePicker
extends Component

A date picker that displays a calendar for the specified month and provides the user the ability to select the month, year and day.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	DatePicker.DatePickerAppearance The appearance of the date picker.
static class	DatePicker.DatePickerDateTimeFormatInfo Provides the date time info constants the date picker.
class	DatePicker.DatePickerDefaultMessages The translatable strings (e.g.
static interface	DatePicker.DatePickerMessages The translatable strings (e.g.
static class	DatePicker.DateState

Field Summary

Fields

Modifier and Type	Field and Description
protected DateWrapper	activeDate
protected Element[]	cells
protected DatePicker.DatePickerDateTimeFormatInfo	dateTimeInfo
protected Date	maxDate
protected DatePicker.DatePickerMessages	messages
protected Date	minDate
protected XElement	monthPicker
protected TextButton	monthPickerCancelButton
protected TextButton	monthPickerOkButton
protected CompositeElement	mpMonths
protected int	mpSelMonth
protected int	mpSelYear
protected int	mpyear
protected CompositeElement	mpYears
protected XElement	overElement
protected int	startDay
protected long	today
protected TextButton	todayBtn
protected DateWrapper	value

Fields inherited from class com.sencha.gxt.widget.core.client.Component

adjustSize, allowTextSelection, cacheSizes, disableContextMenu, disabled, disabledStyle, ensureVisibilityOnSizing, height, hidden, lastSize, layer, left, mask, maskMessage, monitorWindowResize, pageX, pageY, resizeHandler, shim, tabIndex, toolTip, toolTipConfig, top, width, windowResizeDelay, windowResizeTask

Constructor Summary

Constructors

Constructor and Description
DatePicker() Creates a date picker with the default appearance.
DatePicker(DatePicker.DatePickerAppearance appearance) Creates a date picker with the specified appearance.

Method Summary

Modifier and Type	Method and Description
HandlerRegistration	addValueChangeHandler(<any> handler)
protected void	createMonthPicker()
protected void	doAttachChildren()
protected void	doDetachChildren()
protected void	enableTodayButton()
DatePicker.DatePickerAppearance	getAppearance()
protected int	getCalculatedStartDay()
DatePicker.DatePickerDateTimeFormatInfo	getDateTimeInfo() Returns the date time messages used by the date picker.
Date	getMaxDate() Returns the field's maximum allowed date.
DatePicker.DatePickerMessages	getMessages() Returns the date picker messages.
Date	getMinDate() Returns the picker's minimum data.
int	getStartDay() Returns the picker's start day.
Date	getValue()
protected void	handleDateClick(XElement target, String dt)
protected void	handlerKeyPress(NativeEvent evt)
protected void	hideMonthPicker()
void	onBrowserEvent(Event event)
protected void	onClick(Event event)
protected void	onDayClick(XElement e)
protected void	onDisable()
protected void	onEnable()
protected void	onKeyDown(NativeEvent evt)
protected void	onKeyEnd(NativeEvent evt)
protected void	onKeyEnter(NativeEvent evt)
protected void	onKeyHome(NativeEvent evt)
protected void	onKeyLeft(NativeEvent evt)
protected void	onKeyPageDown(NativeEvent evt)
protected void	onKeyPageUp(NativeEvent evt)
protected void	onKeyRight(NativeEvent evt)
protected void	onKeyUp(NativeEvent evt)
protected void	onMouseOut(Event event)
protected void	onMouseOver(Event event)
protected void	onTap(TouchData touchData)
protected void	selectToday()
protected void	setCellStyle(Element cell, Date d, long sel, long min, long max)
void	setDateTimeInfo(DatePicker.DatePickerDateTimeFormatInfo dateTimeInfo) Sets the date time info instance and updates its values.
void	setMaxDate(Date maxDate) Sets the picker's maximum allowed date.
void	setMessages(DatePicker.DatePickerMessages messages) Optionally, sets the date picker messages.
void	setMinDate(Date minDate) Sets the picker's minimum allowed date.
void	setStartDay(int startDay) Sets the picker's start day index as returned by DateTimeFormatInfo#weekdaysNarrow().
void	setValue(Date date)
void	setValue(Date date, boolean fireEvents)
protected void	showMonthPicker()
protected void	showNextMonth()
protected void	showNextYear()
protected void	showPreviousYear()
protected void	showPrevMonth()
protected void	update(DateWrapper date)
protected void	updateMPMonth(int month)
protected void	updateMPYear(int year)

Methods inherited from class com.sencha.gxt.widget.core.client.Component

addBeforeHideHandler, addBeforeShowContextMenuHandler, addBeforeShowHandler, addBlurHandler, addDisableHandler, addEnableHandler, addFocusHandler, addGestureRecognizer, addHideHandler, addMoveHandler, addResizeHandler, addShowContextMenuHandler, addShowHandler, addStyleDependentName, addStyleOnOver, adjustPosition, adjustSize, applyState, assertAfterRender, assertPreRender, blur, clearSizeCache, disable, disableContextMenu, disableEvents, enable, enableEvents, fireCancellableEvent, fireEvent, focus, getData, getElement, getFocusEl, getFocusSupport, getGestureRecognizer, getGestureRecognizerCount, getHideMode, getId, getItemId, getOffsetHeight, getOffsetWidth, getPositionEl, getShadow, getShadowPosition, getStateId, getTabIndex, getToolTip, hide, hideShadow, hideToolTip, isAllowTextSelection, isAutoHeight, isAutoWidth, isDeferHeight, isEnabled, isMonitorWindowResize, isRendered, isStateful, isVisible, isVisible, mask, mask, notifyHide, notifyShow, onAfterFirstAttach, onAttach, onBlur, onDetach, onFocus, onHide, onHideContextMenu, onLoad, onPosition, onResize, onRightClick, onShow, onShowContextMenu, onTouch, onUnload, onWindowResize, removeStyleDependentName, removeStyleOnOver, removeToolTip, setAllowTextSelection, setBorders, setBounds, setBounds, setContextMenu, setData, setDeferHeight, setEnabled, setHeight, setHeight, setHideMode, setId, setItemId, setMonitorWindowResize, setPagePosition, setPixelSize, setPosition, setShadow, setShadowPosition, setSize, setStateful, setStateId, setStyleDependentName, setTabIndex, setToolTip, setToolTipConfig, setVisible, setWidth, setWidth, show, sync, syncSize, unmask

Methods inherited from class java.lang.Object

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

Field Detail

todayBtn

protected TextButton todayBtn

monthPickerOkButton

protected TextButton monthPickerOkButton

monthPickerCancelButton

protected TextButton monthPickerCancelButton

activeDate

protected DateWrapper activeDate

value

protected DateWrapper value

today

protected long today

maxDate

protected Date maxDate

minDate

protected Date minDate

cells

protected Element[] cells

startDay

protected int startDay

monthPicker

protected XElement monthPicker

mpMonths

protected CompositeElement mpMonths

mpYears

protected CompositeElement mpYears

mpSelMonth

protected int mpSelMonth

mpSelYear

protected int mpSelYear

mpyear

protected int mpyear

messages

protected DatePicker.DatePickerMessages messages

overElement

protected XElement overElement

dateTimeInfo

protected DatePicker.DatePickerDateTimeFormatInfo dateTimeInfo

Constructor Detail

DatePicker

public DatePicker()

Creates a date picker with the default appearance.

DatePicker

public DatePicker(DatePicker.DatePickerAppearance appearance)

Creates a date picker with the specified appearance.

Parameters:

appearance - the appearance of the date picker

Method Detail

addValueChangeHandler

public HandlerRegistration addValueChangeHandler(<any> handler)

getAppearance

public DatePicker.DatePickerAppearance getAppearance()

getMaxDate

public Date getMaxDate()

Returns the field's maximum allowed date.

Returns:

the max date

setMaxDate

public void setMaxDate(Date maxDate)

Sets the picker's maximum allowed date.

Parameters:

maxDate - the max date

getMessages

public DatePicker.DatePickerMessages getMessages()

Returns the date picker messages.

Returns:

the messages

setMessages

public void setMessages(DatePicker.DatePickerMessages messages)

Optionally, sets the date picker messages.

Parameters:

messages - the messages

getDateTimeInfo

public DatePicker.DatePickerDateTimeFormatInfo getDateTimeInfo()

Returns the date time messages used by the date picker. Changes to the returned instance (calling setters) will not be applied to the date picker until setDateTimeInfo(com.sencha.gxt.widget.core.client.DatePicker.DatePickerDateTimeFormatInfo) is called.

Returns:

the date time info

setDateTimeInfo

public void setDateTimeInfo(DatePicker.DatePickerDateTimeFormatInfo dateTimeInfo)

Sets the date time info instance and updates its values. This method allows the date picker's constants to be changed at runtime.

Parameters:

dateTimeInfo - the date time info

getMinDate

public Date getMinDate()

Returns the picker's minimum data.

Returns:

the minimum date

setMinDate

public void setMinDate(Date minDate)

Sets the picker's minimum allowed date.

Parameters:

minDate - the minimum date

getStartDay

public int getStartDay()

Returns the picker's start day.

Returns:

the start day

setStartDay

public void setStartDay(int startDay)

Sets the picker's start day index as returned by DateTimeFormatInfo#weekdaysNarrow().

Parameters:

startDay - the start day index

getValue

public Date getValue()

setValue

public void setValue(Date date)

onBrowserEvent

public void onBrowserEvent(Event event)

Overrides:

onBrowserEvent in class Component

onEnable

protected void onEnable()

Overrides:

onEnable in class Component

onDisable

protected void onDisable()

Overrides:

onDisable in class Component

setValue

public void setValue(Date date,
                     boolean fireEvents)

doAttachChildren

protected void doAttachChildren()

doDetachChildren

protected void doDetachChildren()

getCalculatedStartDay

protected int getCalculatedStartDay()

handlerKeyPress

protected void handlerKeyPress(NativeEvent evt)

hideMonthPicker

protected void hideMonthPicker()

onClick

protected void onClick(Event event)

onDayClick

protected void onDayClick(XElement e)

onKeyDown

protected void onKeyDown(NativeEvent evt)

onKeyEnd

protected void onKeyEnd(NativeEvent evt)

onKeyEnter

protected void onKeyEnter(NativeEvent evt)

onKeyHome

protected void onKeyHome(NativeEvent evt)

onKeyLeft

protected void onKeyLeft(NativeEvent evt)

onKeyPageDown

protected void onKeyPageDown(NativeEvent evt)

onKeyPageUp

protected void onKeyPageUp(NativeEvent evt)

onKeyRight

protected void onKeyRight(NativeEvent evt)

onKeyUp

protected void onKeyUp(NativeEvent evt)

onMouseOut

protected void onMouseOut(Event event)

onMouseOver

protected void onMouseOver(Event event)

onTap

protected void onTap(TouchData touchData)

showMonthPicker

protected void showMonthPicker()

showNextMonth

protected void showNextMonth()

showNextYear

protected void showNextYear()

showPreviousYear

protected void showPreviousYear()

showPrevMonth

protected void showPrevMonth()

updateMPMonth

protected void updateMPMonth(int month)

updateMPYear

protected void updateMPYear(int year)

createMonthPicker

protected void createMonthPicker()

enableTodayButton

protected void enableTodayButton()

handleDateClick

protected void handleDateClick(XElement target,
                               String dt)

selectToday

protected void selectToday()

setCellStyle

protected void setCellStyle(Element cell,
                            Date d,
                            long sel,
                            long min,
                            long max)

update

protected void update(DateWrapper date)