краткое описание

#include <gtk/gtk.h>


            gtkcalendar;
enum        gtkcalendardisplayoptions;
gtkwidget*  gtk_calendar_new                (void);

gboolean    gtk_calendar_select_month       (gtkcalendar *calendar,
                                             guint month,
                                             guint year);
void        gtk_calendar_select_day         (gtkcalendar *calendar,
                                             guint day);

gboolean    gtk_calendar_mark_day           (gtkcalendar *calendar,
                                             guint day);
gboolean    gtk_calendar_unmark_day         (gtkcalendar *calendar,
                                             guint day);
void        gtk_calendar_clear_marks        (gtkcalendar *calendar);

gtkcalendardisplayoptions gtk_calendar_get_display_options
                                            (gtkcalendar *calendar);
void        gtk_calendar_set_display_options
                                            (gtkcalendar *calendar,
                                             gtkcalendardisplayoptions flags);
void        gtk_calendar_display_options    (gtkcalendar *calendar,
                                             gtkcalendardisplayoptions flags);
void        gtk_calendar_get_date           (gtkcalendar *calendar,
                                             guint *year,
                                             guint *month,
                                             guint *day);
void        gtk_calendar_freeze             (gtkcalendar *calendar);
void        gtk_calendar_thaw               (gtkcalendar *calendar);

иерархия объектов

  gobject
   +----ginitiallyunowned
         +----gtkobject

               +----gtkwidget
                     +----gtkcalendar

реализуемые интерфейсы

gtkcalendar реализует atkimplementoriface.

свойства

  "day"                  gint                  : read / write
  "month"                gint                  : read / write
  "no-month-change"      gboolean              : read / write
  "show-day-names"       gboolean              : read / write
  "show-heading"         gboolean              : read / write
  "show-week-numbers"    gboolean              : read / write
  "year"                 gint                  : read / write

сигналы

"day-selected"
            void        user_function      (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first
"day-selected-double-click"
            void        user_function      (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first
"month-changed"
            void        user_function      (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first
"next-month"
            void        user_function      (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first
"next-year" void        user_function      (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first
"prev-month"
            void        user_function      (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first
"prev-year" void        user_function      (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first

описание

gtkcalendar это виджет отображающий календарь, один месяц за один раз. он может быть создан с помощью gtk_calendar_new().

текущий отображаемый месяц и год может быть выбран с помощью gtk_calendar_select_month(). точный день в отображаемом месяце может быть выбран с помощью gtk_calendar_select_day().

для размещения визуальной метки на соответствующем дне, используйте gtk_calendar_mark_day(), а для удаления метки, gtk_calendar_unmark_day(). альтернативно, все метки могут быть удалены с помощью gtk_calendar_clear_marks().

способ отображения самого календаря может изменяться с помощью gtk_calendar_set_display_options().

выбранная дата в календаре gtkcalendar может быть найдена при помощи gtk_calendar_get_date().

детали

gtkcalendar

typedef struct _gtkcalendar gtkcalendar;

num_marked_dates – число содержащее количество дней которые имеют маркировку.

marked_date – массив содержащий номера дней которые в текущий момент маркированы.

month, year, и selected_day содержат текущий видимый месяц, год, и выбранный день соответственно.

все эти поля должны рассматриваться только для чтения, а изменение данных в этой структуре может производиться только функциями описанными ниже.

примечание

помните что month начинается с 0 (zero-based) (то есть допустимы значения в пределах 0-11), в то время как selected_day соответствует общепринятому счёту (то есть допустимые значения в пределах 1-31).

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;

эти опции могут использоваться для влияния на поведение и отображение gtkcalendar.

gtk_calendar_new ()

gtkwidget*  gtk_calendar_new                (void);

создаёт новый календарь, с текущемй выбранной датой.

gtk_calendar_select_month ()

gboolean    gtk_calendar_select_month       (gtkcalendar *calendar,
                                             guint month,
                                             guint year);

сдвигает календарь к другому месяцу.

gtk_calendar_select_day ()

void        gtk_calendar_select_day         (gtkcalendar *calendar,
                                             guint day);

выбирает день в текущемм месяце.

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 ()

void        gtk_calendar_clear_marks        (gtkcalendar *calendar);

удаляет все визуальные метки.

gtk_calendar_get_display_options ()

gtkcalendardisplayoptions gtk_calendar_get_display_options
                                            (gtkcalendar *calendar);

возвращает текущие опции отображения calendar.

начиная с версии 2.4

gtk_calendar_set_display_options ()

void        gtk_calendar_set_display_options
                                            (gtkcalendar *calendar,
                                             gtkcalendardisplayoptions flags);

устанавливает опции отображения (отображать ли заголовок и заголовки месяца).

начиная с версии 2.4

gtk_calendar_display_options ()

void        gtk_calendar_display_options    (gtkcalendar *calendar,
                                             gtkcalendardisplayoptions flags);

внимание

gtk_calendar_display_options устарела и не должна использоваться во вновь создаваемом коде.

устанавливает опции отображения.

gtk_calendar_get_date ()

void        gtk_calendar_get_date           (gtkcalendar *calendar,
                                             guint *year,
                                             guint *month,
                                             guint *day);

определяет выбранную дату в gtkcalendar.

gtk_calendar_freeze ()

void        gtk_calendar_freeze             (gtkcalendar *calendar);

внимание

gtk_calendar_freeze начиная с версии 2.8 устарела и не должна использоваться во вновь создаваемом коде.

ничего не делать. предварительная блокировка отображения календаря до тех пор пока её не снимут с помощью gtk_calendar_thaw().

gtk_calendar_thaw ()

void        gtk_calendar_thaw               (gtkcalendar *calendar);

внимание

gtk_calendar_thaw начиная с версии 2.8 устарела и не должна использоваться во вновь создаваемом коде.

ничего не делает. предварительная разморозка календаря; все изменения сделанные начиная с последнего gtk_calendar_freeze() будут отображены.

детали свойств

свойство "day"

  "day"                  gint                  : read / write

выбранный день (как номер между 1 и 31, или 0 для отмены текущемго выбранного дня).

допустимые значения: [0,31]

значение по умолчанию: 0

свойство "month"

  "month"                gint                  : read / write

выбранный месяц (как число между 0 и 11).

допустимые значения: [0,11]

значение по умолчанию: 0

свойство "no-month-change"

  "no-month-change"      gboolean              : read / write

определяет может ли изменяться месяц.

значение по умолчанию: false

начиная с версии 2.4

свойство "show-day-names"

  "show-day-names"       gboolean              : read / write

определяет отображаются ли имена дней.

значение по умолчанию: true

начиная с версии 2.4

свойство "show-heading"

  "show-heading"         gboolean              : read / write

определяет отображается ли заголовок.

значение по умолчанию: true

начиная с версии 2.4

свойство "show-week-numbers"

  "show-week-numbers"    gboolean              : read / write

определяет отображаются ли номера недель.

значение по умолчанию: false

начиная с версии 2.4

свойство "year"

  "year"                 gint                  : read / write

выбранный код.

допустимые значения: >= 0

значение по умолчанию: 0

детали сигналов

сигнал "day-selected"

void        user_function                  (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first

издаётся когда пользователь выбирает день.

сигнал "day-selected-double-click"

void        user_function                  (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first

сигнал "month-changed"

void        user_function                  (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first

издаётся при нажатии пользователем кнопки для изменения месяца в календаре.

сигнал "next-month"

void        user_function                  (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first

сигнал "next-year"

void        user_function                  (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first

сигнал "prev-month"

void        user_function                  (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first

сигнал "prev-year"

void        user_function                  (gtkcalendar *calendar,
                                            gpointer     user_data)      : run first