public class DatePicker extends CalendarPane
This implementatin allows for specifying time component along with the date. Make sure that: 1) keepTime property is true; 2) stripTime is false; 3) dateFormat has time fields;
Modifier and Type | Field and Description |
---|---|
static int |
PICKER_STYLE_BUTTON
A constant for the "pickerStyle" property.
|
static int |
PICKER_STYLE_FIELD_AND_BUTTON
A constant for the "pickerStyle" property.
|
static java.lang.String |
PROPERTY_NAME_DATE_FORMAT
The name of a "dateFormat" property.
|
static java.lang.String |
PROPERTY_NAME_DROPDOWN_FOCUSABLE
The name of a "popupFocusable" property.
|
static java.lang.String |
PROPERTY_NAME_FIELD_EDITABLE
The name of a "fieldEditable" property.
|
static java.lang.String |
PROPERTY_NAME_KEEP_TIME
The name of a "keepTime" property.
|
static java.lang.String |
PROPERTY_NAME_PICKER_STYLE
The name of a "pickerStyle" property.
|
PROPERTY_NAME_DATE, PROPERTY_NAME_FOCUS_LOST_BEHAVIOR, PROPERTY_NAME_HOLIDAY_POLICY, PROPERTY_NAME_LOCALE, PROPERTY_NAME_RESOURCES, PROPERTY_NAME_SHOW_NONE_BTN, PROPERTY_NAME_SHOW_NUMBER_WEEK, PROPERTY_NAME_SHOW_TODAY_BTN, PROPERTY_NAME_STRIP_TIME, PROPERTY_NAME_STYLE, PROPERTY_NAME_VETO_POLICY, PROPERTY_NAME_ZONE, STYLE_CLASSIC, STYLE_MODERN
PROPERTY_NAME_COLOR_OVERRIDE_MAP
TOOL_TIP_TEXT_KEY, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
COLOR_CALENDAR_GRID_BACKGROUND_DISABLED, COLOR_CALENDAR_GRID_BACKGROUND_ENABLED, COLOR_CALENDAR_GRID_FOCUS, COLOR_CALENDAR_GRID_FOREGROUND_DISABLED, COLOR_CALENDAR_GRID_FOREGROUND_ENABLED, COLOR_CALENDAR_GRID_HOLIDAY_FOREGROUND_DISABLED, COLOR_CALENDAR_GRID_HOLIDAY_FOREGROUND_ENABLED, COLOR_CALENDAR_GRID_RESTRICTED, COLOR_CALENDAR_GRID_SELECTION_BACKGROUND_DISABLED, COLOR_CALENDAR_GRID_SELECTION_BACKGROUND_ENABLED, COLOR_CALENDAR_GRID_WEEKEND_FOREGROUND_DISABLED, COLOR_CALENDAR_GRID_WEEKEND_FOREGROUND_ENABLED, COLOR_CALENDAR_HEADER_BACKGROUND_DISABLED, COLOR_CALENDAR_HEADER_BACKGROUND_ENABLED, COLOR_CALENDAR_HEADER_FOREGROUND_DISABLED, COLOR_CALENDAR_HEADER_FOREGROUND_ENABLED, COLOR_CALENDAR_HEADER_FOREGROUND_WEEKEND_DISABLED, COLOR_CALENDAR_HEADER_FOREGROUND_WEEKEND_ENABLED
Constructor and Description |
---|
DatePicker()
Constructor.
|
DatePicker(java.util.Date initialDate)
Constructor.
|
DatePicker(java.util.Date initialDate,
java.text.DateFormat dateFormat)
Constructor.
|
DatePicker(java.util.Date initialDate,
java.text.DateFormat dateFormat,
java.util.Locale locale)
Constructor.
|
DatePicker(java.util.Date initialDate,
java.text.DateFormat dateFormat,
java.util.Locale locale,
java.util.TimeZone zone)
Constructor.
|
DatePicker(java.util.Date initialDate,
int dateStyle)
Constructor.
|
DatePicker(java.util.Date initialDate,
int dateStyle,
java.util.Locale locale)
Constructor.
|
DatePicker(java.util.Date initialDate,
int dateStyle,
java.util.Locale locale,
java.util.TimeZone zone)
Constructor.
|
Modifier and Type | Method and Description |
---|---|
boolean |
commitEdit()
Forces the control to commit current user's edit.
|
java.text.DateFormat |
getDateFormat()
Returns the date format.
|
int |
getPickerStyle()
Returns current visual style of the picker control.
|
java.lang.String |
getUIClassID() |
void |
hidePopup()
Hides the calendar dropdown without selecting a date.
|
boolean |
isDropdownFocusable()
Is the dropdown focusable?
|
boolean |
isFieldEditable()
Is the edit field of the control editable by the user?
|
boolean |
isKeepTime()
Does UI try to preserve time components entered in the edit field?
|
void |
revertEdit()
Forces the control to revert current user's edit to reflect current
control's date.
|
void |
setDateFormat(java.text.DateFormat dateFormat)
Sets the date format constant defined by
DateFormat and updates
the control to reflect new date style. |
void |
setDropdownFocusable(boolean popupFocusable)
Enables or disables focusability of the dropdown calendar.
|
void |
setFieldEditable(boolean fieldEditable)
Enables or disables editing of the edit field by the user.
|
void |
setKeepTime(boolean keepTime)
Determines if the UI should try to preserve time components entered in
the edit field.
|
void |
setPickerStyle(int pickerStyle)
Sets the current visual style of the picker control.
|
void |
showButtonOnly(boolean buttonOnly)
A shortucut method to switch picker style between
PICKER_STYLE_FIELD_AND_BUTTON and PICKER_STYLE_BUTTON |
void |
showPopup()
Displays the calendar dropdown.
|
addActionListener, addCommitListener, commitOrRevert, fireActionEvent, fireCommitEvent, getDate, getFocusLostBehavior, getHolidayPolicy, getLocale, getResources, getStyle, getVetoPolicy, getZone, isShowNoneButton, isShowNumberOfWeek, isShowTodayButton, isStripTime, observeMonth, removeActionListener, removeCommitListener, setDate, setFocusLostBehavior, setHolidayPolicy, setLocale, setResources, setShowNoneButton, setShowNumberOfWeek, setShowTodayButton, setStripTime, setStyle, setVetoPolicy, setZone, stripTime
getColorOverrideMap, getUI, setColorOverrideMap, updateUI
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintImmediately, paintImmediately, print, printAll, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, createImage, createImage, createVolatileImage, createVolatileImage, dispatchEvent, enable, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
public static final java.lang.String PROPERTY_NAME_DATE_FORMAT
public static final java.lang.String PROPERTY_NAME_FIELD_EDITABLE
public static final java.lang.String PROPERTY_NAME_KEEP_TIME
public static final java.lang.String PROPERTY_NAME_PICKER_STYLE
public static final java.lang.String PROPERTY_NAME_DROPDOWN_FOCUSABLE
public static final int PICKER_STYLE_FIELD_AND_BUTTON
public static final int PICKER_STYLE_BUTTON
public DatePicker()
public DatePicker(java.util.Date initialDate)
public DatePicker(java.util.Date initialDate, int dateStyle)
public DatePicker(java.util.Date initialDate, java.text.DateFormat dateFormat)
public DatePicker(java.util.Date initialDate, int dateStyle, java.util.Locale locale)
public DatePicker(java.util.Date initialDate, java.text.DateFormat dateFormat, java.util.Locale locale)
public DatePicker(java.util.Date initialDate, int dateStyle, java.util.Locale locale, java.util.TimeZone zone)
public DatePicker(java.util.Date initialDate, java.text.DateFormat dateFormat, java.util.Locale locale, java.util.TimeZone zone)
public java.lang.String getUIClassID()
getUIClassID
in class CalendarPane
public java.text.DateFormat getDateFormat()
setDateFormat(DateFormat)
public void setDateFormat(java.text.DateFormat dateFormat)
DateFormat
and updates
the control to reflect new date style.
dateFormat
- the date format constant to setgetDateFormat()
,
DateFormat
public boolean isFieldEditable()
If not editable, the user can not type in the date and can only use calendar drop-down to select dates.
true
if the edit field is editable,
false
otherwisesetFieldEditable(boolean)
public void setFieldEditable(boolean fieldEditable)
If not editable, the user can not type in the date and can only use calendar drop-down to select dates.
fieldEditable
- the editable value to setisFieldEditable()
public boolean isDropdownFocusable()
If not focusable, the dropdown calendar will lack some keyboard input capabilities.
true
if the dropdown is focusable,
false
otherwisesetDropdownFocusable(boolean)
public void setDropdownFocusable(boolean popupFocusable)
If not focusable, the dropdown calendar will lack some keyboard input capabilities.
popupFocusable
- the focusable value to setisDropdownFocusable()
public boolean isKeepTime()
If true
and if the date format has some time fields
(hours, minutes, seconds, fraction of second), the UI tries to respect
the time fields' values entered by user as much as possible.
Note: to be able to receive time portion of the date, make sure
CalendarPane.isStripTime()
is false
(the dafualt).
true
if the UI respects time fields,
false
otherwisesetKeepTime(boolean)
,
CalendarPane.setStripTime(boolean)
,
CalendarPane.isStripTime()
public void setKeepTime(boolean keepTime)
If true
and if the date format has some time fields
(hours, minutes, seconds, fraction of second), the UI tries to respect
the time fields' values entered by user as much as possible.
Note: to be able to receive time portion of the date, make sure
CalendarPane.isStripTime()
is false
(the dafualt).
keepTime
- true
to make the UI respects time fields,
false
otherwiseisKeepTime()
,
CalendarPane.setStripTime(boolean)
,
CalendarPane.isStripTime()
public int getPickerStyle()
NOTE: do not confuse with CalendarPane.getStyle()
.
public void setPickerStyle(int pickerStyle)
The control is then updated to reflect the new style.
NOTE: do not confuse with CalendarPane.getStyle()
.
pickerStyle
- the style to setPICKER_STYLE_BUTTON
,
PICKER_STYLE_FIELD_AND_BUTTON
public void showButtonOnly(boolean buttonOnly)
PICKER_STYLE_FIELD_AND_BUTTON
and PICKER_STYLE_BUTTON
buttonOnly
- true
to set PICKER_STYLE_BUTTON
,
false
to set
PICKER_STYLE_FIELD_AND_BUTTON
public void showPopup()
public void hidePopup()
public boolean commitEdit()
CalendarPane
CommitEvent
is fired.commitEdit
in class CalendarPane
true
if successful, false
otherwiseCalendarPane.revertEdit()
,
CalendarPane.getFocusLostBehavior()
,
CalendarPane.setFocusLostBehavior(int)
public void revertEdit()
CalendarPane
CommitEvent
is fired.revertEdit
in class CalendarPane
CalendarPane.revertEdit()
,
CalendarPane.getFocusLostBehavior()
,
CalendarPane.setFocusLostBehavior(int)