GtkCalendar

Displays a calendar and allows the user to select a date.

Object Hierarchy

GObject
`-- GtkObject
       `-- GtkWidget
              `-- GtkCalendar

Description

A GtkCalendar is a widget that displays a calendar as a grid, one month at a time, allowing the user to select a particular date.

The month and year currently displayed can be modified using select_month() . The exact day to be selected may be modified using select_day() .

You may place a visual mark on a particular day by using mark_day() . The marker may be removed using unmark_day() .

The visual style of the calendar may be modified comprehensively using set_display_options() . Of course, the whole purpose of creating the calendar itself is to retrieve the input from the user! You may use get_date() to retrieve the date selected by the user.

Constructors

-- Creates a calender widget.

Methods

clear_marks()
  Removes all visual markers.
display_options()
  DEPRECATED. Sets display options for the calendar.
freeze()
  Freezes the display prior to allow updates.
get_date()
  Returns the currently selected date as an indexed array containing the year, the month and the day.
get_display_options()
  Returns the current calendar display options.
mark_day()
  Places a visual marker on the given day.
select_day()
  Determines the day to be selected.
select_month()
  Determines the month and year to be selected.
set_display_options()
  Sets the display options of the calendar.
thaw()
  Thaws the display following freeze.
unmark_day()
  Removes the visual marker set on a given day.

Signals

"day-selected"
  Emitted when the given day is selected.
"day-selected-double-click"
  Emitted when the given day is clicked on twice.
"month-changed"
  Emitted when the user attempts to change the current month.
"next-month"
  Emitted when the user chooses to go forward by one month.
"next-year"
  Emitted when the user chooses to go forward by one year.
"prev-month"
  Emitted when the user chooses to go backward by one month.
"prev-year"
  Emitted when the user chooses to go backward by one year.