Name
GtkCalendar -- display a calendar and/or allow the user to select a date.
Details
struct GtkCalendar
num_marked_dates is an integer containing the
number of days that have a mark over them.
marked_date is an array containing the day numbers
that currently have a mark over them.
month, year, and
selected_day contain the currently visible month,
year, and selected day respectively.
All of these fields should be considered read only, and everything in this
struct should only be modified using the functions provided below.
enum GtkCalendarDisplayOptions
typedef enum
{
GTK_CALENDAR_SHOW_HEADING = 1 << 0,
GTK_CALENDAR_SHOW_DAY_NAMES = 1 << 1,
GTK_CALENDAR_NO_MONTH_CHANGE = 1 << 2,
GTK_CALENDAR_SHOW_WEEK_NUMBERS = 1 << 3,
GTK_CALENDAR_WEEK_START_MONDAY = 1 << 4
} GtkCalendarDisplayOptions; |
gtk_calendar_new ()
Creates a new calendar. FIXME:default date.
gtk_calendar_select_month ()
gboolean 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 ()
gboolean gtk_calendar_mark_day (GtkCalendar *calendar,
guint day); |
gtk_calendar_unmark_day ()
gboolean gtk_calendar_unmark_day (GtkCalendar *calendar,
guint day); |
gtk_calendar_clear_marks ()
gtk_calendar_display_options ()
gtk_calendar_get_date ()
void gtk_calendar_get_date (GtkCalendar *calendar,
guint *year,
guint *month,
guint *day); |
gtk_calendar_freeze ()
Locks the display of the calendar until it is thawed with gtk_calendar_thaw().
gtk_calendar_thaw ()
Defrosts a calendar; all the changes made since the last
gtk_calendar_freeze() are displayed.
Signals
The "day-selected" signal
void user_function (GtkCalendar *calendar,
gpointer user_data); |
Emitted when the user selects a day.
The "day-selected-double-click" signal
void user_function (GtkCalendar *calendar,
gpointer user_data); |
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.
The "next-month" signal
void user_function (GtkCalendar *calendar,
gpointer user_data); |
The "next-year" signal
void user_function (GtkCalendar *calendar,
gpointer user_data); |
The "prev-month" signal
void user_function (GtkCalendar *calendar,
gpointer user_data); |
The "prev-year" signal
void user_function (GtkCalendar *calendar,
gpointer user_data); |