Functions
GtkCalendarDetailFunc ()
gchar *
(*GtkCalendarDetailFunc) (GtkCalendar *calendar,
guint year,
guint month,
guint day,
gpointer user_data);
This kind of functions provide Pango markup with detail information for the
specified day. Examples for such details are holidays or appointments. The
function returns NULL when no information is available.
Returns
Newly allocated string with Pango markup
with details for the specified day or NULL.
[nullable][transfer full]
Since: 2.14
gtk_calendar_new ()
GtkWidget *
gtk_calendar_new (void);
Creates a new calendar, with the current date being selected.
gtk_calendar_select_month ()
void
gtk_calendar_select_month (GtkCalendar *calendar,
guint month,
guint year);
Shifts the calendar to a different month.
gtk_calendar_select_day ()
void
gtk_calendar_select_day (GtkCalendar *calendar,
guint day);
Selects a day from the current month.
gtk_calendar_mark_day ()
void
gtk_calendar_mark_day (GtkCalendar *calendar,
guint day);
Places a visual marker on a particular day.
gtk_calendar_unmark_day ()
void
gtk_calendar_unmark_day (GtkCalendar *calendar,
guint day);
Removes the visual marker from a particular day.
gtk_calendar_get_day_is_marked ()
gboolean
gtk_calendar_get_day_is_marked (GtkCalendar *calendar,
guint day);
Returns if the day
of the calendar
is already marked.
Returns
whether the day is marked.
Since: 3.0
gtk_calendar_clear_marks ()
void
gtk_calendar_clear_marks (GtkCalendar *calendar);
Remove all visual markers.
gtk_calendar_get_display_options ()
GtkCalendarDisplayOptions
gtk_calendar_get_display_options (GtkCalendar *calendar);
Returns the current display options of calendar
.
Returns
the display options.
Since: 2.4
gtk_calendar_set_display_options ()
void
gtk_calendar_set_display_options (GtkCalendar *calendar,
GtkCalendarDisplayOptions flags);
Sets display options (whether to display the heading and the month
headings).
Since: 2.4
gtk_calendar_set_detail_func ()
void
gtk_calendar_set_detail_func (GtkCalendar *calendar,
GtkCalendarDetailFunc func,
gpointer data,
GDestroyNotify destroy);
Installs a function which provides Pango markup with detail information
for each day. Examples for such details are holidays or appointments. That
information is shown below each day when “show-details” is set.
A tooltip containing with full detail information is provided, if the entire
text should not fit into the details area, or if “show-details”
is not set.
The size of the details area can be restricted by setting the
“detail-width-chars” and “detail-height-rows”
properties.
Since: 2.14
gtk_calendar_get_detail_width_chars ()
gint
gtk_calendar_get_detail_width_chars (GtkCalendar *calendar);
Queries the width of detail cells, in characters.
See “detail-width-chars”.
Returns
The width of detail cells, in characters.
Since: 2.14
gtk_calendar_set_detail_width_chars ()
void
gtk_calendar_set_detail_width_chars (GtkCalendar *calendar,
gint chars);
Updates the width of detail cells.
See “detail-width-chars”.
Since: 2.14
gtk_calendar_get_detail_height_rows ()
gint
gtk_calendar_get_detail_height_rows (GtkCalendar *calendar);
Queries the height of detail cells, in rows.
See “detail-width-chars”.
Returns
The height of detail cells, in rows.
Since: 2.14
gtk_calendar_set_detail_height_rows ()
void
gtk_calendar_set_detail_height_rows (GtkCalendar *calendar,
gint rows);
Updates the height of detail cells.
See “detail-height-rows”.
Since: 2.14
Property Details
The “day” property
“day” gint
The selected day (as a number between 1 and 31, or 0
to unselect the currently selected day).
This property gets initially set to the current day.
Owner: GtkCalendar
Flags: Read / Write
Allowed values: [0,31]
Default value: 0
The “detail-height-rows” property
“detail-height-rows” gint
Height of a detail cell, in rows.
A value of 0 allows any width. See gtk_calendar_set_detail_func().
Owner: GtkCalendar
Flags: Read / Write
Allowed values: [0,127]
Default value: 0
Since: 2.14
The “detail-width-chars” property
“detail-width-chars” gint
Width of a detail cell, in characters.
A value of 0 allows any width. See gtk_calendar_set_detail_func().
Owner: GtkCalendar
Flags: Read / Write
Allowed values: [0,127]
Default value: 0
Since: 2.14
The “month” property
“month” gint
The selected month (as a number between 0 and 11).
This property gets initially set to the current month.
Owner: GtkCalendar
Flags: Read / Write
Allowed values: [0,11]
Default value: 0
The “no-month-change” property
“no-month-change” gboolean
Determines whether the selected month can be changed.
Owner: GtkCalendar
Flags: Read / Write
Default value: FALSE
Since: 2.4
The “show-day-names” property
“show-day-names” gboolean
Determines whether day names are displayed.
Owner: GtkCalendar
Flags: Read / Write
Default value: TRUE
Since: 2.4
The “show-details” property
“show-details” gboolean
Determines whether details are shown directly in the widget, or if they are
available only as tooltip. When this property is set days with details are
marked.
Owner: GtkCalendar
Flags: Read / Write
Default value: TRUE
Since: 2.14
The “show-heading” property
“show-heading” gboolean
Determines whether a heading is displayed.
Owner: GtkCalendar
Flags: Read / Write
Default value: TRUE
Since: 2.4
The “show-week-numbers” property
“show-week-numbers” gboolean
Determines whether week numbers are displayed.
Owner: GtkCalendar
Flags: Read / Write
Default value: FALSE
Since: 2.4
The “year” property
“year” gint
The selected year.
This property gets initially set to the current year.
Owner: GtkCalendar
Flags: Read / Write
Allowed values: [0,4194303]
Default value: 0
Signal Details
The “day-selected” signal
void
user_function (GtkCalendar *calendar,
gpointer user_data)
Emitted when the user selects a day.
Flags: Run First
The “day-selected-double-click” signal
void
user_function (GtkCalendar *calendar,
gpointer user_data)
Emitted when the user double-clicks a day.
Flags: Run First
The “month-changed” signal
void
user_function (GtkCalendar *calendar,
gpointer user_data)
Emitted when the user clicks a button to change the selected month on a
calendar.
Flags: Run First
The “next-month” signal
void
user_function (GtkCalendar *calendar,
gpointer user_data)
Emitted when the user switched to the next month.
Flags: Run First
The “next-year” signal
void
user_function (GtkCalendar *calendar,
gpointer user_data)
Emitted when user switched to the next year.
Flags: Run First
The “prev-month” signal
void
user_function (GtkCalendar *calendar,
gpointer user_data)
Emitted when the user switched to the previous month.
Flags: Run First
The “prev-year” signal
void
user_function (GtkCalendar *calendar,
gpointer user_data)
Emitted when user switched to the previous year.
Flags: Run First