Package com.standbysoft.component.date.swing.plaf.basic

Contains the UI delegates that implement the look and feel for the Swing date components.

See:
Description

Class Summary

AbstractDateFieldUI	Defines the general structure that is used by subclasses to implement the actual UI delegate for JDateField.
AbstractDatePickerUI	Defines the general structure that is used by subclasses to implement the actual UI delegate for JDatePicker.
AbstractMonthUI	Defines the general structure that is used by subclasses to implement the actual UI delegate for JMonth.
AbstractMonthViewUI	Defines the general structure that is used by subclasses to implement the actual UI delegate for JMonthView.
BasicDateFieldUI	Implements only what is strictly necessary for a JDateField UI delegate.
BasicDatePickerUI	Implements only what is strictly necessary for a JDatePicker UI delegate.
BasicMonthUI	Implements only what is strictly necessary for a JMonth UI delegate.
BasicMonthViewUI	Implements only what is strictly necessary for a JMonthView UI delegate.
DefaultMonthUI	Default implementation for a JMonth UI delegate.
DefaultMonthViewUI	Default implementation for a JMonthView UI delegate.

Package com.standbysoft.component.date.swing.plaf.basic Description

Contains the UI delegates that implement the look and feel for the Swing date components. A UI delegate is an object used by a Swing component to implement its look and behavior. In other words, it is what the user actually sees as component. If this is a new concept for you, the article Introducing Swing Architecture has a detailed presentation about it.

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

• The Purpose of This Package
• How to Read This Package
• How to Use This Package

The Purpose of This Package

The isolation of the UI implementation makes it possible to use whatever delegate. You are free to choose the face that suits best your component in a given context.

For instance, this package provides a UI delegate for JMonthView (a calendar component) that has two buttons to scroll to the previous and next months in the calendar. For most applications this could be enough but you might need to also have two buttons that scroll the year. This problem can be solved easily by using a different UI delegate that adds the two buttons and the corresponding functionality.

Creating a delegate from scratch is a time consuming task, so this package is meant to help you create them with as little effort as possible.

How to Read This Package

This package contains quite a few classes, so here is how they are organized.

• Abstract: The abstract classes like AbstractMonthUI define the structure of a certain UI delegate. It is most likely that you will have nothing to do with these classes. They just allow a better code organization.
• Basic: The basic classes like BasicMonthUI are actual delegates that can be used on the corresponding components. They are called basic because they implement only what is striclty necessary for a UI delegate to work. When creating your own delegate you should extend these basic classes.
• Default: The default classes like DefaultMonthUI improve the basic implementation where it is the case. As you can see, not all delegates have a default implementation.

Having this structure in mind, you can now read more about each of the classes from this package.

How to Use This Package

The purpose of this package is to help you create custom UI delegates for the date components. You can create a delegate from scratch by implementing the DateUI interface but that would surely take you a lot of time. An easier way is to just extend the basic classes from this package.

If what you need is just a UI delegate slightly different that the default ones, you should extend the default classes.

Related Documentation

The tutorial contains a step by step example that shows how to create and register your own UI delegate.