com.standbysoft.component.date.swing
Class JDatePicker

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              com.standbysoft.component.date.swing.JDateComponent
                  com.standbysoft.component.date.swing.JDateEditComponent
                      com.standbysoft.component.date.swing.JDatePicker

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.swing.SwingConstants

Direct Known Subclasses:

JdbDatePicker

public class JDatePicker
extends JDateEditComponent

A date picker is an advanced date edit component that not only allows to edit dates but also allows to select them by means of a drop down calendar. You can find task-oriented documentation and examples of using date pickers in Using the JDatePicker Component, a section in The JDatePicker Suite Tutorial.

The editable property is configurable and it is not active by default. When set as editable, the date picker can be configured just like any other JDateEditComponent. The popup property can be used to access the popup calendar used to select the dates.

The default UI delegate used by this component is BasicDatePickerUI. When using this delegate, the component can be configured with some client properties that improve its behavior.

See Also:

Serialized Form

Nested Class Summary

static interface

JDatePicker.Popup This interface defines the access to the popup used by a date picker.

Nested classes/interfaces inherited from class com.standbysoft.component.date.swing.JDateComponent

JDateComponent.DateAction, JDateComponent.RollDateAction, JDateComponent.SelectFirstDayAction, JDateComponent.SelectLastDayAction, JDateComponent.SelectNoneAction, JDateComponent.SelectTodayAction

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

static java.lang.String	CANCEL_COMMAND Action name that indicates a cancel command.
static java.lang.String	CONFIRM_COMMAND Action name that indicates a confirm command.
protected boolean	isEditable Defines whether the component is editable or not.
protected JDatePicker.Popup	popup The popup with the calendar used to select a date for the date picker.

Fields inherited from class com.standbysoft.component.date.swing.JDateEditComponent

autoRestore, autoValidate, beepOnError, dateFormat, dateFormatPattern, dateFormatStyle, dateModel, dateModelListener, dateParser, emptySelectionText, freeText, horizontalAlignment, text, timeFormatStyle

Fields inherited from class com.standbysoft.component.date.swing.JDateComponent

actionCommand, calendar, dateSelectionModel, dateSelectionModelListener, locale, selectFirstDayAction, selectLastDayAction, selectNextDayAction, selectNoneAction, selectPreviousDayAction, selectSameDayNextMonthAction, selectSameDayNextWeekAction, selectSameDayNextYearAction, selectSameDayPreviousMonthAction, selectSameDayPreviousWeekAction, selectSameDayPreviousYearAction, selectTodayAction, timeZone

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

JDatePicker()
Creates a default non-editable date picker has the today date selected.

JDatePicker(boolean editable)
Creates a date picker with a specified editable state.

Method Summary

static javax.swing.table.TableCellEditor	createTableCellEditor() Returns a JDatePicker based table cell editor.
static javax.swing.table.TableCellEditor	createTableCellEditor(JDatePicker datePicker) Returns a JDatePicker based table cell editor.
JDatePicker.Popup	getPopup() Returns the popup used by this date picker.
java.lang.String	getUIClassID() Returns the name of the L&F class that renders this component.
boolean	isEditable() Returns whether this component is editable or not.
void	setEditable(boolean editable) Enables dates to be typed-in or not.
void	setPopup(JDatePicker.Popup popup) Specifies the popup that will be used to select a date.

Methods inherited from class com.standbysoft.component.date.swing.JDateEditComponent

addDateListener, commitEdit, fireDateChanged, fireDateFieldChanged, fireDateFieldCleared, getAutoCenturyYear, getDateFormat, getDateModel, getDateParser, getEmptySelectionText, getHorizontalAlignment, getSelectedDateAsText, getText, invalidEdit, isAutoCentury, isAutoRestore, isAutoValidate, isBeepOnError, isEditValid, isFreeText, removeDateListener, setAutoCentury, setAutoCenturyYear, setAutoRestore, setAutoValidate, setBeepOnError, setDateFormat, setDateFormat, setDateFormat, setDateFormat, setDateModel, setDateParser, setDateSelectionModel, setEmptySelectionText, setFreeText, setHorizontalAlignment, setLocale, setSelectedDate, setText, setTimeZone

Methods inherited from class com.standbysoft.component.date.swing.JDateComponent

addActionListener, addDateSelectionListener, fireActionEvent, fireDateSelectionChanged, fireDisabledDatesChanged, fireDisabledDateSelectionAttempted, fireEmptySelectionAllowedChanged, fireSelectionModeChanged, getActionCommand, getCalendar, getDateSelectionModel, getLocale, getSelectedDate, getTimeZone, getUI, isEmptySelectionAllowed, removeActionListener, removeDateSelectionListener, setActionCommand, setEmptySelectionAllowed, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, 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, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, 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, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, 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, hide, 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, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, 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, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

CANCEL_COMMAND

public static final java.lang.String CANCEL_COMMAND

Action name that indicates a cancel command. A cancel command is issued when the popup calendar is canceled.

See Also:

Constant Field Values

CONFIRM_COMMAND

public static final java.lang.String CONFIRM_COMMAND

Action name that indicates a confirm command. A confirm command is issued when the popup calendar is closed as a result of selecting a date.

See Also:

Constant Field Values

popup

protected JDatePicker.Popup popup

The popup with the calendar used to select a date for the date picker.

isEditable

protected boolean isEditable

Defines whether the component is editable or not.

Constructor Detail

JDatePicker

public JDatePicker()

Creates a default non-editable date picker has the today date selected. Null dates are allowed by default.

JDatePicker

public JDatePicker(boolean editable)

Creates a date picker with a specified editable state.

Parameters:

editable - true if an editable date picker should be created; false otherwise.

Method Detail

createTableCellEditor

public static javax.swing.table.TableCellEditor createTableCellEditor()

Returns a JDatePicker based table cell editor.

Returns:

table cell editor for Date objects.

createTableCellEditor

public static javax.swing.table.TableCellEditor createTableCellEditor(JDatePicker datePicker)

Returns a JDatePicker based table cell editor.

Parameters:

datePicker - date picker that will be used to edit table objects

Returns:

table cell editor for Date objects.

getUIClassID

public java.lang.String getUIClassID()

Returns the name of the L&F class that renders this component.

Overrides:

getUIClassID in class javax.swing.JComponent

Returns:

the string "DatePickerUI"

setPopup

public void setPopup(JDatePicker.Popup popup)

Specifies the popup that will be used to select a date.

WARNING: This method is intended to be used internally by this API.

Parameters:

popup - popup of the date picker

getPopup

public JDatePicker.Popup getPopup()

Returns the popup used by this date picker.

Returns:

popup used by this date picker

setEditable

public void setEditable(boolean editable)

Enables dates to be typed-in or not.

Parameters:

editable - true if the editor should be activated; false otherwise.

isEditable

public boolean isEditable()

Returns whether this component is editable or not.

Returns:

true if the component is in editable mode, that is the editor is activated; false otherwise.