Class JCalendar

All Implemented Interfaces:
ImageObserver, MenuContainer, PropertyChangeListener, Serializable, EventListener, Accessible

public class JCalendar extends JPanel implements PropertyChangeListener
JCalendar is a bean for entering a date by choosing the year, month and day.
Version:
$LastChangedRevision: 95 $, $LastChangedDate: 2006-05-05 18:43:15 +0200 (Fr, 05 Mai 2006) $
Author:
Kai Toedter
See Also:
  • Field Details

  • Constructor Details

    • JCalendar

      public JCalendar()
      Default JCalendar constructor.
    • JCalendar

      public JCalendar(Date date)
      JCalendar constructor which allows the initial date to be set.
      Parameters:
      date - the date
    • JCalendar

      public JCalendar(Calendar calendar)
      JCalendar constructor which allows the initial calendar to be set.
      Parameters:
      calendar - the calendar
    • JCalendar

      public JCalendar(Locale locale)
      JCalendar constructor allowing the initial locale to be set.
      Parameters:
      locale - the new locale
    • JCalendar

      public JCalendar(Date date, Locale locale)
      JCalendar constructor specifying both the initial date and locale.
      Parameters:
      date - the date
      locale - the new locale
    • JCalendar

      public JCalendar(Date date, boolean monthSpinner)
      JCalendar constructor specifying both the initial date and the month spinner type.
      Parameters:
      date - the date
      monthSpinner - false, if no month spinner should be used
    • JCalendar

      public JCalendar(Locale locale, boolean monthSpinner)
      JCalendar constructor specifying both the locale and the month spinner.
      Parameters:
      locale - the locale
      monthSpinner - false, if no month spinner should be used
    • JCalendar

      public JCalendar(boolean monthSpinner)
      JCalendar constructor specifying the month spinner type.
      Parameters:
      monthSpinner - false, if no month spinner should be used
    • JCalendar

      public JCalendar(Date date, Locale locale, boolean monthSpinner, boolean weekOfYearVisible)
      JCalendar constructor with month spinner parameter.
      Parameters:
      date - the date
      locale - the locale
      monthSpinner - false, if no month spinner should be used
      weekOfYearVisible - true, if weeks of year shall be visible
  • Method Details

    • main

      public static void main(String[] s)
      Creates a JFrame with a JCalendar inside and can be used for testing.
      Parameters:
      s - The command line arguments
    • getCalendar

      Returns the calendar property.
      Returns:
      the value of the calendar property.
    • getDayChooser

      Gets the dayChooser attribute of the JCalendar object
      Returns:
      the dayChooser value
    • getLocale

      public Locale getLocale()
      Returns the locale.
      Overrides:
      getLocale in class Component
      Returns:
      the value of the locale property.
      See Also:
    • getMonthChooser

      Gets the monthChooser attribute of the JCalendar object
      Returns:
      the monthChooser value
    • getYearChooser

      Gets the yearChooser attribute of the JCalendar object
      Returns:
      the yearChooser value
    • isWeekOfYearVisible

      public boolean isWeekOfYearVisible()
      Indicates if the weeks of year are visible..
      Returns:
      boolean true, if weeks of year are visible
    • propertyChange

      JCalendar is a PropertyChangeListener, for its day, month and year chooser.
      Specified by:
      propertyChange in interface PropertyChangeListener
      Parameters:
      evt - the property change event
    • setBackground

      public void setBackground(Color bg)
      Sets the background color.
      Overrides:
      setBackground in class JComponent
      Parameters:
      bg - the new background
    • setCalendar

      public void setCalendar(Calendar c)
      Sets the calendar property. This is a bound property.
      Parameters:
      c - the new calendar
      Throws:
      NullPointerException - - if c is null;
      See Also:
    • setCalendar

      private void setCalendar(Calendar c, boolean update)
      Sets the calendar attribute of the JCalendar object
      Parameters:
      c - the new calendar value
      update - the new calendar value
      Throws:
      NullPointerException - - if c is null;
    • setEnabled

      public void setEnabled(boolean enabled)
      Enable or disable the JCalendar.
      Overrides:
      setEnabled in class JComponent
      Parameters:
      enabled - the new enabled value
    • isEnabled

      public boolean isEnabled()
      Returns true, if enabled.
      Overrides:
      isEnabled in class Component
      Returns:
      true, if enabled.
    • setFont

      public void setFont(Font font)
      Sets the font property.
      Overrides:
      setFont in class JComponent
      Parameters:
      font - the new font
    • setForeground

      public void setForeground(Color fg)
      Sets the foreground color.
      Overrides:
      setForeground in class JComponent
      Parameters:
      fg - the new foreground
    • setLocale

      public void setLocale(Locale l)
      Sets the locale property. This is a bound property.
      Overrides:
      setLocale in class Component
      Parameters:
      l - the new locale value
      See Also:
    • setWeekOfYearVisible

      public void setWeekOfYearVisible(boolean weekOfYearVisible)
      Sets the week of year visible.
      Parameters:
      weekOfYearVisible - true, if weeks of year shall be visible
    • isDecorationBackgroundVisible

      Gets the visibility of the decoration background.
      Returns:
      true, if the decoration background is visible.
    • setDecorationBackgroundVisible

      public void setDecorationBackgroundVisible(boolean decorationBackgroundVisible)
      Sets the decoration background visible.
      Parameters:
      decorationBackgroundVisible - true, if the decoration background should be visible.
    • isDecorationBordersVisible

      public boolean isDecorationBordersVisible()
      Gets the visibility of the decoration border.
      Returns:
      true, if the decoration border is visible.
    • setDecorationBordersVisible

      public void setDecorationBordersVisible(boolean decorationBordersVisible)
      Sets the decoration borders visible.
      Parameters:
      decorationBordersVisible - true, if the decoration borders should be visible.
    • getDecorationBackgroundColor

      Returns the color of the decoration (day names and weeks).
      Returns:
      the color of the decoration (day names and weeks).
    • setDecorationBackgroundColor

      public void setDecorationBackgroundColor(Color decorationBackgroundColor)
      Sets the background of days and weeks of year buttons.
      Parameters:
      decorationBackgroundColor - the background color
    • getSundayForeground

      Returns the Sunday foreground.
      Returns:
      Color the Sunday foreground.
    • getWeekdayForeground

      Returns the weekday foreground.
      Returns:
      Color the weekday foreground.
    • setSundayForeground

      public void setSundayForeground(Color sundayForeground)
      Sets the Sunday foreground.
      Parameters:
      sundayForeground - the sundayForeground to set
    • setWeekdayForeground

      public void setWeekdayForeground(Color weekdayForeground)
      Sets the weekday foreground.
      Parameters:
      weekdayForeground - the weekdayForeground to set
    • getDate

      public Date getDate()
      Returns a Date object.
      Returns:
      a date object constructed from the calendar property.
    • setDate

      public void setDate(Date date)
      Sets the date. Fires the property change "date".
      Parameters:
      date - the new date.
      Throws:
      NullPointerException - - if tha date is null
    • setSelectableDateRange

      public void setSelectableDateRange(Date min, Date max)
      Sets a valid date range for selectable dates. If max is before min, the default range with no limitation is set.
      Parameters:
      min - the minimum selectable date or null (then the minimum date is set to 01\01\0001)
      max - the maximum selectable date or null (then the maximum date is set to 01\01\9999)
    • getMaxSelectableDate

      Gets the minimum selectable date.
      Returns:
      the minimum selectable date
    • getMinSelectableDate

      Gets the maximum selectable date.
      Returns:
      the maximum selectable date
    • setMaxSelectableDate

      public void setMaxSelectableDate(Date max)
      Sets the maximum selectable date.
      Parameters:
      max - maximum selectable date
    • setMinSelectableDate

      public void setMinSelectableDate(Date min)
      Sets the minimum selectable date.
      Parameters:
      min - minimum selectable date
    • getMaxDayCharacters

      public int getMaxDayCharacters()
      Gets the maximum number of characters of a day name or 0. If 0 is returned, dateFormatSymbols.getShortWeekdays() will be used.
      Returns:
      the maximum number of characters of a day name or 0.
    • setMaxDayCharacters

      public void setMaxDayCharacters(int maxDayCharacters)
      Sets the maximum number of characters per day in the day bar. Valid values are 0-4. If set to 0, dateFormatSymbols.getShortWeekdays() will be used, otherwise theses strings will be reduced to the maximum number of characters.
      Parameters:
      maxDayCharacters - the maximum number of characters of a day name.