[ новости /+++ | форум | теги | ]

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

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

#include <gtk/gtk.h>


            GtkCheckMenuItem;
GtkWidget*  gtk_check_menu_item_new         (void);

GtkWidget*  gtk_check_menu_item_new_with_label
                                            (const gchar *label);
GtkWidget*  gtk_check_menu_item_new_with_mnemonic
                                            (const gchar *label);
#define     gtk_check_menu_item_set_state

gboolean    gtk_check_menu_item_get_active  (GtkCheckMenuItem *check_menu_item);
void        gtk_check_menu_item_set_active  (GtkCheckMenuItem *check_menu_item,
                                             gboolean is_active);
void        gtk_check_menu_item_set_show_toggle

                                            (GtkCheckMenuItem *menu_item,
                                             gboolean always);
void        gtk_check_menu_item_toggled     (GtkCheckMenuItem *check_menu_item);
gboolean    gtk_check_menu_item_get_inconsistent

                                            (GtkCheckMenuItem *check_menu_item);
void        gtk_check_menu_item_set_inconsistent
                                            (GtkCheckMenuItem *check_menu_item,
                                             gboolean setting);
void        gtk_check_menu_item_set_draw_as_radio

                                            (GtkCheckMenuItem *check_menu_item,
                                             gboolean draw_as_radio);
gboolean    gtk_check_menu_item_get_draw_as_radio
                                            (GtkCheckMenuItem *check_menu_item);

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

  GObject
   +----GInitiallyUnowned
         +----GtkObject

               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkItem
                                       +----GtkMenuItem

                                             +----GtkCheckMenuItem
                                                   +----GtkRadioMenuItem

Осуществляемые интерфейсы

GtkCheckMenuItem осуществляет AtkImplementorIface.

Свойства

  "active"               gboolean              : Read / Write
  "draw-as-radio"        gboolean              : Read / Write
  "inconsistent"         gboolean              : Read / Write

Свойства стиля

  "indicator-size"       gint                  : Read

Сигналы

"toggled"   void        user_function      (GtkCheckMenuItem *checkmenuitem,
                                            gpointer          user_data)          : Run first

Описание

GtkCheckMenuItem это пункт меню поддерживающий состояние булево значения в дополнение к обычной роли GtkMenuItem's в активируемом коде приложения.

Флажок (check box) указывающий булево значение состояния, отображается с левой стороны GtkMenuItem. Активизация GtkMenuItem переключает состояние.

Детали

GtkCheckMenuItem

typedef struct _GtkCheckMenuItem GtkCheckMenuItem;

GtkCheckMenuItem структура содержит нижеследующие поля. (Эти поля должны рассматриваться только для чтения. Они никогда не должны устанавливаться приложением.)

gtk_check_menu_item_new ()

GtkWidget*  gtk_check_menu_item_new         (void);

Создаёт новый GtkCheckMenuItem.

gtk_check_menu_item_new_with_label ()

GtkWidget*  gtk_check_menu_item_new_with_label
                                            (const gchar *label);

Создаёт новый GtkCheckMenuItem с ярлыком.

gtk_check_menu_item_new_with_mnemonic ()

GtkWidget*  gtk_check_menu_item_new_with_mnemonic
                                            (const gchar *label);

Создаёт новый GtkCheckMenuItem содержащий ярлык. Ярлык должен быть создан с помощью gtk_label_new_with_mnemonic(), таким образом подчеркивание в label указывает на мнемоник для пункта меню.

gtk_check_menu_item_set_state

#define gtk_check_menu_item_set_state           gtk_check_menu_item_set_active

Внимание

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

Этот макрос обеспечивает совместимость с устаревшим кодом. Новый код должен использовать gtk_check_menu_item_set_active() вместо него.

gtk_check_menu_item_get_active ()

gboolean    gtk_check_menu_item_get_active  (GtkCheckMenuItem *check_menu_item);

Определяет активен ли флажок пункта меню. Смотрите gtk_check_menu_item_set_active().

gtk_check_menu_item_set_active ()

void        gtk_check_menu_item_set_active  (GtkCheckMenuItem *check_menu_item,
                                             gboolean is_active);

Устанавливает активное состояние флажка пункта меню.

gtk_check_menu_item_set_show_toggle ()

void        gtk_check_menu_item_set_show_toggle
                                            (GtkCheckMenuItem *menu_item,
                                             gboolean always);

Внимание

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

Контролирует должен ли флажок отображаться всё время. Обычно флажок отображается только когда он активен или во время выделения пункта меню.

gtk_check_menu_item_toggled ()

void        gtk_check_menu_item_toggled     (GtkCheckMenuItem *check_menu_item);

Издаёт сигнал GtkCheckMenuItem::toggled.

gtk_check_menu_item_get_inconsistent ()

gboolean    gtk_check_menu_item_get_inconsistent
                                            (GtkCheckMenuItem *check_menu_item);

Находит значение установленное с помощью gtk_check_menu_item_set_inconsistent().

gtk_check_menu_item_set_inconsistent ()

void        gtk_check_menu_item_set_inconsistent
                                            (GtkCheckMenuItem *check_menu_item,
                                             gboolean setting);

Если пользователь выбрал диапазон элементов (таких как некоторый текст или ячейки таблицы) которые задевают булево настройки и текущие значения в диапазоне противоречивы, вам может понадобиться отобразить состояние флажка в промежуточном состоянии "in between". Эта функция включает промежуточное состояние "in between". Обычно промежуточное состояние выключается когда пользователь выбирает настройку. Это выполняется вручную, gtk_check_menu_item_set_inconsistent() затрагивает только внешний вид, она не влияет на семантику виджета.

gtk_check_menu_item_set_draw_as_radio ()

void        gtk_check_menu_item_set_draw_as_radio
                                            (GtkCheckMenuItem *check_menu_item,
                                             gboolean draw_as_radio);

Устанавливает должен ли check_menu_item выглядеть как GtkRadioMenuItem

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

gtk_check_menu_item_get_draw_as_radio ()

gboolean    gtk_check_menu_item_get_draw_as_radio
                                            (GtkCheckMenuItem *check_menu_item);

Определяет выглядит ли check_menu_item как GtkRadioMenuItem

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

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

Свойство "active"

  "active"               gboolean              : Read / Write

Активен ли пункт меню.

Значение по умолчанию: FALSE

Свойство "draw-as-radio"

  "draw-as-radio"        gboolean              : Read / Write

Выглядит ли пункт меню как радио-пункт меню.

Значение по умолчанию: FALSE

Свойство "inconsistent"

  "inconsistent"         gboolean              : Read / Write

Отображается ли промежуточное состояние "inconsistent".

Значение по умолчанию: FALSE

Детали свойств стиля

Свойство стиля "indicator-size"

  "indicator-size"       gint                  : Read

Размер флажка или радио-индикатора.

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

Значение по умолчанию: 12

Детали сигнала

Сигнал "toggled"

void        user_function                  (GtkCheckMenuItem *checkmenuitem,
                                            gpointer          user_data)          : Run first

Этот сигнал издаётся когда состояние флажка меняется.

Обработчик сигнала проверяет active поле в структуре GtkCheckMenuItem для выявления нового состояния.

Партнёры:

Хостинг: