com.gsoft.titration.client
Class DateChooser

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Dialog
                          |
                          +--javax.swing.JDialog
                                |
                                +--com.gsoft.titration.client.DateChooser

public class DateChooser

extends JDialog

implements ActionListener, FocusListener, ItemListener, KeyListener, MouseListener

Custom dialog box to enter dates. The DateChooser
class presents a calendar and allows the user to visually select a
day, month and year so that it is impossible to enter an invalid
date.

Fields inherited from class java.awt.Component

TOP_ALIGNMENT, CENTER_ALIGNMENT, BOTTOM_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT

Constructor Summary

DateChooser(Dialog owner, String title)           Constructs a new DateChooser with the given title.

DateChooser(Dialog owner)           Constructs a new DateChooser.

DateChooser(Frame owner, String title)           Constructs a new DateChooser with the given title.

DateChooser(Frame owner)           Constructs a new DateChooser.

Method Summary
void	actionPerformed(ActionEvent e)           Called when the "Ok" button is pressed.
private void	construct()           Initializes this DateChooser object.
void	focusGained(FocusEvent e)           Called when the calendar gains the focus.
void	focusLost(FocusEvent e)           Called when the calendar loses the focus.
private int	getSelectedDay()           Gets the selected day, as an int.
void	itemStateChanged(ItemEvent e)           Called when a new month or year is selected.
void	keyPressed(KeyEvent e)           Called when a key is pressed and the calendar has the focus.
void	keyReleased(KeyEvent e)
void	keyTyped(KeyEvent e)
void	mouseClicked(MouseEvent e)           Called when the mouse is clicked on a day in the calendar.
void	mouseEntered(MouseEvent e)
void	mouseExited(MouseEvent e)
void	mousePressed(MouseEvent e)
void	mouseReleased(MouseEvent e)
Date	select(Date date)           Selects a date.
Date	select()           Selects new date.
private void	setSelected(JLabel newDay)           Sets the selected day.
private void	setSelected(int newDay)           Sets the selected day.
private void	update()           Updates the calendar.

Methods inherited from class javax.swing.JDialog

dialogInit, createRootPane, processKeyEvent, processWindowEvent, setDefaultCloseOperation, getDefaultCloseOperation, update, setJMenuBar, getJMenuBar, isRootPaneCheckingEnabled, setRootPaneCheckingEnabled, addImpl, remove, setLayout, getRootPane, setRootPane, getContentPane, setContentPane, getLayeredPane, setLayeredPane, getGlassPane, setGlassPane, setLocationRelativeTo, paramString, getAccessibleContext

Methods inherited from class java.awt.Dialog

addNotify, isModal, setModal, getTitle, setTitle, show, hide, dispose, isResizable, setResizable

Methods inherited from class java.awt.Window

finalize, pack, toFront, toBack, getToolkit, getWarningString, getLocale, getInputContext, setCursor, getOwner, getOwnedWindows, addWindowListener, removeWindowListener, getListeners, processEvent, getFocusOwner, postEvent, isShowing, applyResourceBundle, applyResourceBundle, getGraphicsConfiguration

Methods inherited from class java.awt.Container

getComponentCount, countComponents, getComponent, getComponents, getInsets, insets, add, add, add, add, add, remove, removeAll, getLayout, doLayout, layout, invalidate, validate, validateTree, setFont, getPreferredSize, preferredSize, getMinimumSize, minimumSize, getMaximumSize, getAlignmentX, getAlignmentY, paint, print, paintComponents, printComponents, addContainerListener, removeContainerListener, processContainerEvent, deliverEvent, getComponentAt, locate, getComponentAt, findComponentAt, findComponentAt, removeNotify, isAncestorOf, list, list

Methods inherited from class java.awt.Component

getName, setName, getParent, getPeer, setDropTarget, getDropTarget, getTreeLock, isValid, isDisplayable, isVisible, isEnabled, setEnabled, enable, enable, disable, isDoubleBuffered, enableInputMethods, setVisible, show, getForeground, setForeground, getBackground, setBackground, getFont, setLocale, getColorModel, getLocation, getLocationOnScreen, location, setLocation, move, setLocation, getSize, size, setSize, resize, setSize, resize, getBounds, bounds, setBounds, reshape, setBounds, getX, getY, getWidth, getHeight, getBounds, getSize, getLocation, isOpaque, isLightweight, getGraphics, getFontMetrics, getCursor, paintAll, repaint, repaint, repaint, repaint, printAll, imageUpdate, createImage, createImage, prepareImage, prepareImage, checkImage, checkImage, contains, inside, contains, dispatchEvent, addComponentListener, removeComponentListener, addFocusListener, removeFocusListener, addHierarchyListener, removeHierarchyListener, addHierarchyBoundsListener, removeHierarchyBoundsListener, addKeyListener, removeKeyListener, addMouseListener, removeMouseListener, addMouseMotionListener, removeMouseMotionListener, addInputMethodListener, removeInputMethodListener, getInputMethodRequests, enableEvents, disableEvents, coalesceEvents, processComponentEvent, processFocusEvent, processMouseEvent, processMouseMotionEvent, processInputMethodEvent, processHierarchyEvent, processHierarchyBoundsEvent, handleEvent, mouseDown, mouseDrag, mouseUp, mouseMove, mouseEnter, mouseExit, keyDown, keyUp, action, gotFocus, lostFocus, isFocusTraversable, requestFocus, transferFocus, nextFocus, hasFocus, add, remove, toString, list, list, list, addPropertyChangeListener, removePropertyChangeListener, addPropertyChangeListener, removePropertyChangeListener, firePropertyChange, setComponentOrientation, getComponentOrientation

Methods inherited from class java.lang.Object

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

Field Detail

calendar

private GregorianCalendar calendar

Auxiliary variable to compute dates.

private JButton cancel

"Cancel" button.

private JLabel day

Selected day.

private final static String[] DAYS

Names of the days of the week.

private JLabel[][] days

Calendar, as a matrix of labels. The first row represents the
first week of the month, the second row, the second week, and
so on. Each column represents a day of the week, the first is
Sunday, and the last is Saturday. The label's text is the
number of the corresponding day.

private final static Color DAYS_FOREGROUND

Text color of the days' numbers in the calendar.

private FocusablePanel daysGrid

Day selection control. It is just a panel that can receive the
focus. The actual user interaction is driven by the
DateChooser class.

private final static Border EMPTY_BORDER

Empty border, used when the calendar does not have the focus.

private final static int FIRST_YEAR

First year that can be selected.

private final static Border FOCUSED_BORDER

Border used to highlight the selected day when the calendar
has the focus.

private final static int LAST_YEAR

Last year that can be selected.

private int lastDay

Last day of the selected month.

private JComboBox month

Month selection control.

private final static String[] MONTHS

Names of the months.

private int offset

Day of the week (0=Sunday) corresponding to the first day of
the selected month. Used to calculate the position, in the
calendar (days), corresponding to a given day.

private JButton ok

"Ok" button.

private boolean okClicked

true if the "Ok" button was clicked to close the
dialog box, false otherwise.

private final static Color SELECTED_DAY_BACKGROUND

Text color of the selected day in the calendar.

private final static Color SELECTED_DAY_FOREGROUND

Background color of the selected day in the calendar.

private final static Color WEEK_DAYS_FOREGROUND

Text color of the days of the weeks, used as column headers in
the calendar.

private JComboBox year

Year selection control.

public DateChooser(Dialog owner, String title)

Constructs a new DateChooser with the given title.

Parameters:

owner owner dialog

title dialog title

public DateChooser(Dialog owner)

Constructs a new DateChooser.

Parameters:

owner owner dialog

public DateChooser(Frame owner, String title)

Constructs a new DateChooser with the given title.

Parameters:

owner owner frame

title dialog title

public DateChooser(Frame owner)

Constructs a new DateChooser.

Parameters:

owner owner frame

public void actionPerformed(ActionEvent e)

Called when the "Ok" button is pressed. Just sets a flag and
hides the dialog box.

private void construct()

Initializes this DateChooser object. Creates the
controls, registers listeners and initializes the dialog box.

public void focusGained(FocusEvent e)

Called when the calendar gains the focus. Just re-sets the
selected day so that it is redrawn with the border that
indicate focus.

public void focusLost(FocusEvent e)

Called when the calendar loses the focus. Just re-sets the
selected day so that it is redrawn without the border that
indicate focus.

private int getSelectedDay()

Gets the selected day, as an int. Parses the text
of the selected label in the calendar to get the day.

Returns: the selected day or -1 if there is no day selected

public void itemStateChanged(ItemEvent e)

Called when a new month or year is selected. Updates the calendar
to reflect the selection.

public void keyPressed(KeyEvent e)

Called when a key is pressed and the calendar has the
focus. Handles the arrow keys so that the user can select a day
using the keyboard.

public void keyReleased(KeyEvent e)

public void keyTyped(KeyEvent e)

public void mouseClicked(MouseEvent e)

Called when the mouse is clicked on a day in the
calendar. Selects the clicked day.

public void mouseEntered(MouseEvent e)

public void mouseExited(MouseEvent e)

public void mousePressed(MouseEvent e)

public void mouseReleased(MouseEvent e)

public Date select(Date date)

Selects a date. Displays the dialog box, with a given date as
the selected date, and allows the user select a new date.

Parameters:

date initial date

Returns: the new date selected or null if the user
press "Cancel" or closes the dialog box

public Date select()

Selects new date. Just calls select(java.util.Date) with the
system date as the parameter.

Returns: the same as the function select(java.util.Date)

private void setSelected(JLabel newDay)

Sets the selected day. The day is specified as the label
control, in the calendar, corresponding to the day to select.

Parameters:

newDay day to select

private void setSelected(int newDay)

Sets the selected day. The day is specified as the number of
the day, in the month, to selected. The function compute the
corresponding control to select.

Parameters:

newDay day to select

private void update()

Updates the calendar. This function updates the calendar panel
to reflect the month and year selected. It keeps the same day
of the month that was selected, except if it is beyond the last
day of the month. In this case, the last day of the month is
selected.