The OpenNET Project / Index page

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

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

Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Implemented Interfaces  |  Properties  |  Style Properties  |  Signals

GtkCheckMenuItem

GtkCheckMenuItem Пункт меню с флажком (check box)

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

#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 структура содержит нижеследующие поля. (Эти поля должны рассматриваться только для чтения. Они никогда не должны устанавливаться приложением.)

guint active;

TRUE если флажок ативен.


gtk_check_menu_item_new ()

GtkWidget*  gtk_check_menu_item_new         (void);

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

Возвращает :

новый GtkCheckMenuItem.


gtk_check_menu_item_new_with_label ()

GtkWidget*  gtk_check_menu_item_new_with_label
                                            (const gchar *label);

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

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 указывает на мнемоник для пункта меню.

label :

Текст кнопки, с подчеркиванием спереди для мнемонического символа

Возвращает :

новый GtkCheckMenuItem


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

check_menu_item :

GtkCheckMenuItem

Возвращает :

TRUE если пункт меню активен.


gtk_check_menu_item_set_active ()

void        gtk_check_menu_item_set_active  (GtkCheckMenuItem *check_menu_item,
                                             gboolean is_active);

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

check_menu_item :

GtkCheckMenuItem.

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 устарела и не должна использоваться во вновь создаваемом коде.

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

menu_item :

GtkCheckMenuItem.

always :

Булево значение указывающее должен ли флажок отображаться всё время.


gtk_check_menu_item_toggled ()

void        gtk_check_menu_item_toggled     (GtkCheckMenuItem *check_menu_item);

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

check_menu_item :

GtkCheckMenuItem.


gtk_check_menu_item_get_inconsistent ()

gboolean    gtk_check_menu_item_get_inconsistent
                                            (GtkCheckMenuItem *check_menu_item);

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

check_menu_item :

GtkCheckMenuItem

Возвращает :

TRUE если противоречивы


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() затрагивает только внешний вид, она не влияет на семантику виджета.

check_menu_item :

GtkCheckMenuItem

setting :

TRUE для отображения промежуточного "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

check_menu_item :

GtkCheckMenuItem

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

check_menu_item :

GtkCheckMenuItem

Возвращает :

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

checkmenuitem :

Объект получающий сигнал.

user_data :

Пользовательские данные устанавливаемые при подключении обработчика сигнала.






Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру