Package com.standbysoft.component.date.swing

Provides a set of date components for Swing that solve various date selection problems.

See:
Description

Interface Summary

DateRenderer	This interface defines the method required by any object that would like to be a renderer for dates in a JMonth.
JDatePicker.Popup	This interface defines the access to the popup used by a date picker.
MonthModel	A month model is a helper interface that lets you control different settings for a JMonth component.
WeekModel	A week model is a helper interface that lets you control various week settings for a JMonth component.

Class Summary

DefaultDateRenderer	Default implementation for a DateRenderer that uses a JLabel to render the requested date.
DefaultMonthModel	A default implementation for a MonthModel.
DefaultWeekModel	A default implementation for a WeekModel.
JDateComponent	JDateComponent is the base class for all date selection components.
JDateComponent.DateAction
JDateComponent.RollDateAction	This action is used to increment/decrement the value of one date field with one unit.
JDateComponent.SelectFirstDayAction	This action is used to select the first selectable day of the currently selected month.
JDateComponent.SelectLastDayAction	This action is used to select the last selectable day of the currently selected month.
JDateComponent.SelectNoneAction	This action is used to deselect all selected dates.
JDateComponent.SelectTodayAction	This action is used to select the today date.
JDateEditComponent	JDateEditComponent is the base class for all date editing components.
JDateField	A date field is a plain implementation for a date edit component.
JDatePicker	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.
JMonth	A JMonth is a convenient way of representing all the days of a month from the calendar.
JMonthView	A multiple-month calendar that enables users to view and select dates by means of an intuitive interface.

Package com.standbysoft.component.date.swing Description

Provides a set of date components for Swing that solve various date selection problems. The rest of the classes and interfaces are either used by these components or they provide common functionality.

To learn more about this package you may want to read about:

• The Big Picture
• Date Selection
• Date Editing

The Big Picture

Date input and selection is an important operation in most desktop applications. The components from this package were designed to offer an elegant solution both from a programmer's and a user's perspective.

As you will see, they just assemble and provide a coherent interface for the mechanisms (selection, editing, parsing) defined in the com.standbysoft.component.date.

All components inherit from a base class JDateComponent that provides basic date selection functionality for all components. Unlike JMonth, JDateField and JDatePicker do not inherit directly from it but from JDateEditComponent, which also adds specific date editing functionality.

Date Selection

All date components use a DateSelectionModel to abstract everything there is about date selection. One can use JDateComponent.setDateSelectionModel(DateSelectionModel) respectively JDateComponent.getDateSelectionModel() to specify and determine the selection model used by a component.

Operations may be performed either directly on the date selection model or indirectly using a component's API. For instance, here is how one could determine whether a date component allows null dates:

        JDateComponent comp = ...make a date component
        comp.isEmptySelectionAllowed();
        comp.getDateSelectionModel().isEmptySelectionAllowed();

Every component's description specifies the methods that further delegate to the date selection model.

Date Editing

JDateEditComponent defines the general contract for a date edit component. Such components may use the built-in validating editor or accept free text entries that get to be converted to dates using a date parser.