org.apache.pivot.wtk
Class CalendarButton

java.lang.Object
  extended by org.apache.pivot.wtk.Component
      extended by org.apache.pivot.wtk.Button
          extended by org.apache.pivot.wtk.CalendarButton
All Implemented Interfaces:
ConstrainedVisual, Visual

public class CalendarButton
extends Button

A component that allows a user to select a calendar date. The calendar is hidden until the user pushes the button.


Nested Class Summary
 
Nested classes/interfaces inherited from class org.apache.pivot.wtk.Button
Button.DataRenderer, Button.Group, Button.GroupListener, Button.NamedGroupDictionary, Button.NamedGroupDictionaryListener, Button.State
 
Nested classes/interfaces inherited from class org.apache.pivot.wtk.Component
Component.ComponentDictionary, Component.DecoratorSequence, Component.StyleDictionary, Component.UserDataDictionary
 
Field Summary
static String COUNTRY_KEY
           
static String LANGUAGE_KEY
           
static String VARIANT_KEY
           
 
Constructor Summary
CalendarButton()
           
CalendarButton(Object buttonData)
           
 
Method Summary
 ListenerList<CalendarButtonListener> getCalendarButtonListeners()
          Returns the calendar button listener list.
 ListenerList<CalendarButtonSelectionListener> getCalendarButtonSelectionListeners()
          Returns the calendar button selection listener list.
 Filter<CalendarDate> getDisabledDateFilter()
           
 Locale getLocale()
          Returns the locale used to present calendar data.
 CalendarDate getSelectedDate()
          Returns the currently selected date.
 String getSelectedDateKey()
          Gets the data binding key that is set on this calendar button.
 void load(Dictionary<String,?> context)
          Loads the selected date from the specified bind context using this date picker button's bind key, if one is set.
 void setDisabledDateFilter(Filter<CalendarDate> disabledDateFilter)
           
 void setLocale(Dictionary<String,?> locale)
          Sets the locale used to present calendar data.
 void setLocale(Locale locale)
          Sets the locale used to present calendar data.
 void setLocale(String locale)
          Sets the locale used to present calendar data.
 void setSelectedDate(CalendarDate selectedDate)
          Sets the selected date.
 void setSelectedDate(String selectedDate)
          Sets the selected date to the date represented by the specified date string.
 void setSelectedDateKey(String selectedDateKey)
          Sets this calendar button's data binding key.
 void setToggleButton(boolean toggleButton)
          Sets the button's toggle state.
 void store(Dictionary<String,?> context)
          Stores the selected date into the specified bind context using this date picker button's bind key, if one is set.
 
Methods inherited from class org.apache.pivot.wtk.Button
getAction, getButtonData, getButtonListeners, getButtonPressListeners, getButtonStateListeners, getDataRenderer, getGroup, getNamedGroupDictionaryListeners, getNamedGroups, getSelectedKey, getState, getStateKey, isSelected, isToggleButton, isTriState, press, setAction, setAction, setButtonData, setDataRenderer, setEnabled, setGroup, setGroup, setSelected, setSelectedKey, setState, setState, setStateKey, setTriState
 
Methods inherited from class org.apache.pivot.wtk.Component
clearFocus, getAttributes, getBounds, getComponentClassListeners, getComponentDataListeners, getComponentDecoratorListeners, getComponentKeyListeners, getComponentListeners, getComponentMouseButtonListeners, getComponentMouseListeners, getComponentMouseWheelListeners, getComponents, getComponentStateListeners, getCursor, getDecoratedBounds, getDecorators, getDisplay, getDragSource, getDropTarget, getFocusedComponent, getGraphics, getHandle, getHeight, getLocation, getMaximumPreferredHeight, getMaximumPreferredWidth, getMenuHandler, getMinimumPreferredHeight, getMinimumPreferredWidth, getParent, getPreferredHeight, getPreferredHeight, getPreferredHeightLimits, getPreferredSize, getPreferredWidth, getPreferredWidth, getPreferredWidthLimits, getSize, getSkin, getStyles, getTooltipText, getUserData, getVisibleArea, getVisibleArea, getVisibleArea, getWidth, getWindow, getX, getY, installSkin, invalidate, isBlocked, isEnabled, isFocusable, isFocused, isMouseOver, isOpaque, isPreferredHeightSet, isPreferredSizeSet, isPreferredWidthSet, isShowing, isValid, isVisible, keyPressed, keyReleased, keyTyped, load, mapPointFromAncestor, mapPointToAncestor, mouseClick, mouseDown, mouseMove, mouseOut, mouseOver, mouseUp, mouseWheel, paint, repaint, repaint, repaint, repaint, repaint, repaint, requestFocus, scrollAreaToVisible, scrollAreaToVisible, setAttributes, setCursor, setCursor, setDragSource, setDropTarget, setHeight, setLocation, setLocation, setMaximumPreferredHeight, setMaximumPreferredWidth, setMenuHandler, setMinimumPreferredHeight, setMinimumPreferredWidth, setParent, setPreferredHeight, setPreferredHeightLimits, setPreferredHeightLimits, setPreferredSize, setPreferredSize, setPreferredWidth, setPreferredWidthLimits, setPreferredWidthLimits, setSize, setSize, setSkin, setStyles, setStyles, setStyles, setTooltipText, setVisible, setWidth, setX, setY, store, toString, transferFocus, validate
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

LANGUAGE_KEY

public static final String LANGUAGE_KEY
See Also:
Constant Field Values

COUNTRY_KEY

public static final String COUNTRY_KEY
See Also:
Constant Field Values

VARIANT_KEY

public static final String VARIANT_KEY
See Also:
Constant Field Values
Constructor Detail

CalendarButton

public CalendarButton()

CalendarButton

public CalendarButton(Object buttonData)
Method Detail

setToggleButton

public void setToggleButton(boolean toggleButton)
Description copied from class: Button
Sets the button's toggle state.

Overrides:
setToggleButton in class Button
Throws:
UnsupportedOperationException - This method is not supported by CalendarButton.

getSelectedDate

public CalendarDate getSelectedDate()
Returns the currently selected date.

Returns:
The currently selected date, or null if nothing is selected.

setSelectedDate

public void setSelectedDate(CalendarDate selectedDate)
Sets the selected date.

Parameters:
selectedDate - The date to select, or null to clear the selection.

setSelectedDate

public final void setSelectedDate(String selectedDate)
Sets the selected date to the date represented by the specified date string. The date string must be in the ISO 8601 "calendar date" format, which is [YYYY]-[MM]-[DD].

Parameters:
selectedDate - A string in the form of [YYYY]-[MM]-[DD] (e.g. 2008-07-23)

getLocale

public Locale getLocale()
Returns the locale used to present calendar data.


setLocale

public void setLocale(Locale locale)
Sets the locale used to present calendar data.

Parameters:
locale -

setLocale

public void setLocale(Dictionary<String,?> locale)
Sets the locale used to present calendar data.

Parameters:
locale - An dictionary containing values for language, country, and variant. Country and variant are optional but the must adhere to the following rules:
  • If variant is specified, language and country are required;
  • Otherwise, if country is specified, language is required;
  • Otherwise, language is required.

setLocale

public void setLocale(String locale)
Sets the locale used to present calendar data.

Parameters:
locale - A JSON map containing values for language, country, and variant.
See Also:
setLocale(Dictionary)

getDisabledDateFilter

public Filter<CalendarDate> getDisabledDateFilter()

setDisabledDateFilter

public void setDisabledDateFilter(Filter<CalendarDate> disabledDateFilter)

getSelectedDateKey

public String getSelectedDateKey()
Gets the data binding key that is set on this calendar button.


setSelectedDateKey

public void setSelectedDateKey(String selectedDateKey)
Sets this calendar button's data binding key.


load

public void load(Dictionary<String,?> context)
Loads the selected date from the specified bind context using this date picker button's bind key, if one is set.

Overrides:
load in class Button

store

public void store(Dictionary<String,?> context)
Stores the selected date into the specified bind context using this date picker button's bind key, if one is set.

Overrides:
store in class Button

getCalendarButtonListeners

public ListenerList<CalendarButtonListener> getCalendarButtonListeners()
Returns the calendar button listener list.


getCalendarButtonSelectionListeners

public ListenerList<CalendarButtonSelectionListener> getCalendarButtonSelectionListeners()
Returns the calendar button selection listener list.