| |
GTK+ Reference Manual |
||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals |
GtkCalendarGtkCalendar Отображает календарь позволяющий пользователю выбирать дату |
#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()
.
typedef struct _GtkCalendar GtkCalendar;
num_marked_dates
число содержащее
количество дней которые имеют маркировку.
marked_date
массив содержащий
номера дней которые в текущий момент
маркированы.
month
, year
, и
selected_day
содержат текущий
видимый месяц, год, и выбранный день
соответственно.
Все эти поля должны рассматриваться только для чтения, а изменение данных в этой структуре может производиться только функциями описанными ниже.
Помните
что month
начинается с 0
(zero-based) (то есть допустимы значения в
пределах 0-11), в то время как selected_day
соответствует общепринятому счёту (то
есть допустимые значения в пределах
1-31).
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+ 2.4, эта опция устарела и игнорируется GTK+. Информация с какого дня недели начинается неделя, определяется в зависимости от настроек локализации. |
GtkWidget* gtk_calendar_new (void);
Создаёт новый календарь, с текущемй выбранной датой.
Возвращает : |
Новый виджет GtkCalendar |
gboolean gtk_calendar_select_month (GtkCalendar *calendar, guint month, guint year);
Сдвигает календарь к другому месяцу.
|
|
|
Номер месяца между 0 и 11. |
|
Год месяца. |
Возвращает : |
|
void gtk_calendar_select_day (GtkCalendar *calendar, guint day);
Выбирает день в текущемм месяце.
|
|
|
Номер дня в пределах от 1 до 31, или 0 для отмены текущемго выбора. |
gboolean gtk_calendar_mark_day (GtkCalendar *calendar, guint day);
Размещает визуальную метку на определённом дне.
|
|
|
Номер отмечаемого дня от 1 до 31. |
Возвращает : |
|
gboolean gtk_calendar_unmark_day (GtkCalendar *calendar, guint day);
Снимает текущую визуальную метку определённого дня.
|
|
|
Номер дня для снятия метки, от 1 до 31. |
Возвращает : |
|
void gtk_calendar_clear_marks (GtkCalendar *calendar);
Удаляет все визуальные метки.
|
GtkCalendarDisplayOptions gtk_calendar_get_display_options (GtkCalendar *calendar);
Возвращает текущие опции отображения
calendar
.
|
|
Возвращает : |
Опции отображения. |
Начиная с версии 2.4
void gtk_calendar_set_display_options (GtkCalendar *calendar, GtkCalendarDisplayOptions flags);
Устанавливает опции отображения (отображать ли заголовок и заголовки месяца).
|
|
|
Опции отображения для установки |
Начиная с версии 2.4
void gtk_calendar_display_options (GtkCalendar *calendar, GtkCalendarDisplayOptions flags);
gtk_calendar_display_options
устарела и не должна использоваться во
вновь создаваемом коде.
Устанавливает опции отображения.
|
|
|
Опции отображения для установки. |
void gtk_calendar_get_date (GtkCalendar *calendar, guint *year, guint *month, guint *day);
Определяет выбранную дату в GtkCalendar.
|
|
|
Номер года, или |
|
Номер месяца (между 0 и 11), или |
|
Номер дня (между 1 и 31), или |
void gtk_calendar_freeze (GtkCalendar *calendar);
gtk_calendar_freeze
начиная с версии 2.8 устарела и не должна
использоваться во вновь создаваемом
коде.
Ничего не делать. Предварительная
блокировка отображения календаря до
тех пор пока её не снимут с помощью
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
void user_function (GtkCalendar *calendar, gpointer user_data) : Run first
Издаётся когда пользователь выбирает день.
|
Объект получающий сигнал. |
|
Данные помещаемые при подключении обработчика сигнала. |
void user_function (GtkCalendar *calendar, gpointer user_data) : Run first
|
Объект получающий сигнал. |
|
Данные помещаемые при подключении обработчика сигнала. |
void user_function (GtkCalendar *calendar, gpointer user_data) : Run first
Издаётся при нажатии пользователем кнопки для изменения месяца в календаре.
|
Объект получающий сигнал. |
|
Данные помещаемые при подключении обработчика сигнала. |
void user_function (GtkCalendar *calendar, gpointer user_data) : Run first
|
Объект получающий сигнал. |
|
Данные помещаемые при подключении обработчика сигнала. |
void user_function (GtkCalendar *calendar, gpointer user_data) : Run first
|
Объект получающий сигнал. |
|
Данные помещаемые при подключении обработчика сигнала. |
void user_function (GtkCalendar *calendar, gpointer user_data) : Run first
|
Объект получающий сигнал. |
|
Данные помещаемые при подключении обработчика сигнала. |
void user_function (GtkCalendar *calendar, gpointer user_data) : Run first
|
Объект получающий сигнал. |
|
Данные помещаемые при подключении обработчика сигнала. |
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |