org.gnu.gtk

Class Calendar

public class Calendar extends Widget

A Calendar is a widget that displays a calendar one month at a time.
Constructor Summary
Calendar()
Create a new Calendar object with the current date selected.
Calendar(Handle handle)
Construct a calendar using a handle to a native resource.
Method Summary
voidaddListener(CalendarListener listener)
Register an object to handle calendar events.
voidclearMarks()
Remove all visual marks.
voidfreeze()
Locks the display of the Calendar until it is thawed with the thaw() method.
static CalendargetCalendar(Handle handle)
Internal static factory method to be used by Java-Gnome only.
CalendargetDate()
Gets the selected date from the Calendar widget.
CalendarDisplayOptionsgetDisplayOptions()
Gets the display options (whether to display the heading and the month headings.
ClassgetEventListenerClass(String signal)
EventTypegetEventType(String signal)
static TypegetType()
Retrieve the runtime type used by the GLib library.
int[]getYearMonthDay()
Gets the selected date from a Calendar.
voidmarkDay(int day)
Places a visual marker on a particular day.
voidremoveListener(CalendarListener listener)
Removes a listener
voidselectDay(int day)
Selects a day from the current month.
voidselectMonth(int month, int year)
Shifts the calendar to a different month.
voidsetDisplayOptions(CalendarDisplayOptions displayOptions)
Sets the display options (whether to display the heading and the month headings.
voidthaw()
Defrosts a Calendar.
voidunmarkDay(int day)
Removes the visual marker from a particular day.

Constructor Detail

Calendar

public Calendar()
Create a new Calendar object with the current date selected.

Calendar

public Calendar(Handle handle)
Construct a calendar using a handle to a native resource.

Method Detail

addListener

public void addListener(CalendarListener listener)
Register an object to handle calendar events.

See Also: CalendarListener

clearMarks

public void clearMarks()
Remove all visual marks.

freeze

public void freeze()

Deprecated:

Locks the display of the Calendar until it is thawed with the thaw() method.

getCalendar

public static Calendar getCalendar(Handle handle)
Internal static factory method to be used by Java-Gnome only.

getDate

public Calendar getDate()

Deprecated: the form returning java.util.Calendar is deprecated and will be replaced. Use {@link #getYearMonthDay()} as a workaround until libgtk-java 2.10, when getDate() will return an int[3] instead.

Gets the selected date from the Calendar widget.

Returns: A Calendar object that represents the date selected in the widget.

getDisplayOptions

public CalendarDisplayOptions getDisplayOptions()
Gets the display options (whether to display the heading and the month headings.

getEventListenerClass

public Class getEventListenerClass(String signal)

getEventType

public EventType getEventType(String signal)

getType

public static Type getType()
Retrieve the runtime type used by the GLib library.

getYearMonthDay

public int[] getYearMonthDay()
Gets the selected date from a Calendar.

Returns: a three wide array of integers: the array at [0] is the year (4 digits), the array at [1] is the month (range from 1-12), and the array at [2] is the numeric day (range from 1-{28,29,30,31}).

markDay

public void markDay(int day)
Places a visual marker on a particular day.

Parameters: day The day number to mark between 1 and 31.

removeListener

public void removeListener(CalendarListener listener)
Removes a listener

See Also: addListener

selectDay

public void selectDay(int day)
Selects a day from the current month.

Parameters: day A day number between 1 and 31, or 0 to unselect the currently selected day.

selectMonth

public void selectMonth(int month, int year)
Shifts the calendar to a different month.

Parameters: month The month to select. This value is zero based. year The year the month is in.

setDisplayOptions

public void setDisplayOptions(CalendarDisplayOptions displayOptions)
Sets the display options (whether to display the heading and the month headings.

Parameters: displayOptions The options to set.

thaw

public void thaw()

Deprecated:

Defrosts a Calendar. All changes made since the last freeze() are displayed.

unmarkDay

public void unmarkDay(int day)
Removes the visual marker from a particular day.

Parameters: day The day number to unmark between 1 and 31.