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

#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 для выявления нового состояния.