![]() |
![]() |
This is a widget that displays a calendar, one month at a time.
The month and year currently displayed can be altered with select_month(). The exact day can be selected from the displayed month using select_day().
The way in which the calendar itself is displayed can be altered using set_display_options().
The selected date can be retrieved from a GtkCalendar using get_date().
If performing many 'mark' operations, the calendar can be frozen to prevent flicker, using freeze(), and 'thawed' again using thaw().
Public Member Functions | ||||
Calendar () | ||||
void | clear_marks () | |||
Remove all visual markers. | ||||
void | display_options (CalendarDisplayOptions flags) | |||
Sets display options (whether to display the heading and the month headings). | ||||
void | freeze () | |||
Does nothing. | ||||
void | get_date (guint& year, guint& month, guint& day) const | |||
Obtains the selected date from a Gtk::Calendar. | ||||
CalendarDisplayOptions | get_display_options () const | |||
Returns the current display options of calendar . | ||||
const GtkCalendar* | gobj () const | |||
Provides access to the underlying C GtkObject. | ||||
GtkCalendar* | gobj () | |||
Provides access to the underlying C GtkObject. | ||||
int | mark_day (guint day) | |||
Places a visual marker on a particular day. | ||||
void | select_day (guint day) | |||
Selects a day from the current month. | ||||
int | select_month (guint month, guint year) | |||
Shifts the calendar to a different month. | ||||
void | set_display_options (CalendarDisplayOptions flags) | |||
Sets display options (whether to display the heading and the month headings). | ||||
Glib::SignalProxy0<void> | signal_day_selected () | |||
| ||||
Glib::SignalProxy0<void> | signal_day_selected_double_click () | |||
| ||||
Glib::SignalProxy0<void> | signal_month_changed () | |||
| ||||
Glib::SignalProxy0<void> | signal_next_month () | |||
| ||||
Glib::SignalProxy0<void> | signal_next_year () | |||
| ||||
Glib::SignalProxy0<void> | signal_prev_month () | |||
| ||||
Glib::SignalProxy0<void> | signal_prev_year () | |||
| ||||
void | thaw () | |||
Does nothing. | ||||
int | unmark_day (guint day) | |||
Removes the visual marker from a particular day. | ||||
virtual | ~Calendar () | |||
Protected Member Functions | ||||
virtual void | on_day_selected () | |||
virtual void | on_day_selected_double_click () | |||
virtual void | on_month_changed () | |||
virtual void | on_next_month () | |||
virtual void | on_next_year () | |||
virtual void | on_prev_month () | |||
virtual void | on_prev_year () | |||
Related Functions | ||||
(Note that these are not member functions.) | ||||
Gtk::Calendar* | wrap (GtkCalendar* object, bool take_copy=false) | |||
|
virtual Gtk::Calendar::~Calendar | ( | ) | [virtual] |
Gtk::Calendar::Calendar | ( | ) |
void Gtk::Calendar::clear_marks | ( | ) |
Remove all visual markers.
void Gtk::Calendar::display_options | ( | CalendarDisplayOptions | flags | ) |
Sets display options (whether to display the heading and the month headings).
Deprecated: Use set_display_options() instead
flags | The display options to set. |
void Gtk::Calendar::freeze | ( | ) |
Does nothing.
Previously locked the display of the calendar until it was thawed with thaw().
void Gtk::Calendar::get_date | ( | guint & | year, | |
guint & | month, | |||
guint & | day | |||
) | const |
Obtains the selected date from a Gtk::Calendar.
year | Location to store the year number, or 0 . | |
month | Location to store the month number (between 0 and 11), or 0 . | |
day | Location to store the day number (between 1 and 31), or 0 . |
CalendarDisplayOptions Gtk::Calendar::get_display_options | ( | ) | const |
const GtkCalendar* Gtk::Calendar::gobj | ( | ) | const [inline] |
GtkCalendar* Gtk::Calendar::gobj | ( | ) | [inline] |
int Gtk::Calendar::mark_day | ( | guint | day | ) |
Places a visual marker on a particular day.
day | The day number to mark between 1 and 31. |
true
, always. virtual void Gtk::Calendar::on_day_selected | ( | ) | [protected, virtual] |
virtual void Gtk::Calendar::on_day_selected_double_click | ( | ) | [protected, virtual] |
virtual void Gtk::Calendar::on_month_changed | ( | ) | [protected, virtual] |
virtual void Gtk::Calendar::on_next_month | ( | ) | [protected, virtual] |
virtual void Gtk::Calendar::on_next_year | ( | ) | [protected, virtual] |
virtual void Gtk::Calendar::on_prev_month | ( | ) | [protected, virtual] |
virtual void Gtk::Calendar::on_prev_year | ( | ) | [protected, virtual] |
void Gtk::Calendar::select_day | ( | guint | day | ) |
Selects a day from the current month.
day | The day number between 1 and 31, or 0 to unselect the currently selected day. |
int Gtk::Calendar::select_month | ( | guint | month, | |
guint | year | |||
) |
Shifts the calendar to a different month.
month | A month number between 0 and 11. | |
year | The year the month is in. |
true
, always. void Gtk::Calendar::set_display_options | ( | CalendarDisplayOptions | flags | ) |
Sets display options (whether to display the heading and the month headings).
flags | The display options to set. |
Glib::SignalProxy0< void > Gtk::Calendar::signal_day_selected | ( | ) |
void day_selected()
Glib::SignalProxy0< void > Gtk::Calendar::signal_day_selected_double_click | ( | ) |
void day_selected_double_click()
Glib::SignalProxy0< void > Gtk::Calendar::signal_month_changed | ( | ) |
void month_changed()
Glib::SignalProxy0< void > Gtk::Calendar::signal_next_month | ( | ) |
void next_month()
Glib::SignalProxy0< void > Gtk::Calendar::signal_next_year | ( | ) |
void next_year()
Glib::SignalProxy0< void > Gtk::Calendar::signal_prev_month | ( | ) |
void prev_month()
Glib::SignalProxy0< void > Gtk::Calendar::signal_prev_year | ( | ) |
void prev_year()
void Gtk::Calendar::thaw | ( | ) |
Does nothing.
Previously defrosted a calendar; all the changes made since the last freeze() were displayed.
int Gtk::Calendar::unmark_day | ( | guint | day | ) |
Removes the visual marker from a particular day.
day | The day number to unmark between 1 and 31. |
true
, always.
Gtk::Calendar* wrap | ( | GtkCalendar * | object, | |
bool | take_copy = false | |||
) | [related] |
object | The C instance |
take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |