Spec-Zone.ru › GTK 3.20

GtkCheckMenuItem

GtkCheckMenuItem — Элемент меню с флажком

Функции

GtkWidget * gtk_check_menu_item_new ()
GtkWidget * gtk_check_menu_item_new_with_label ()
GtkWidget * gtk_check_menu_item_new_with_mnemonic ()
gboolean gtk_check_menu_item_get_active ()
void gtk_check_menu_item_set_active ()
void gtk_check_menu_item_toggled ()
gboolean gtk_check_menu_item_get_inconsistent ()
void gtk_check_menu_item_set_inconsistent ()
void gtk_check_menu_item_set_draw_as_radio ()
gboolean gtk_check_menu_item_get_draw_as_radio ()

Свойства

gboolean active Чтение / Запись
gboolean draw-as-radio Чтение / Запись
gboolean inconsistent Чтение / Запись

Стилизованные свойства

gint indicator-size Чтение

Сигналы

void toggled Первое выполнение

Типы и значения

struct GtkCheckMenuItem
struct GtkCheckMenuItemClass

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkMenuItem
                        ╰── GtkCheckMenuItem
                            ╰── GtkRadioMenuItem

Реализованные интерфейсы

GtkCheckMenuItem реализует AtkImplementorIface, GtkBuildable, GtkActivatable и GtkActionable.

Файлы

#include <gtk/gtk.h>

Описание

GtkCheckMenuItem — элемент меню, который поддерживает состояние булевого значения помимо обычной роли GtkMenuItem в активизации кода приложения.

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

Узлы CSS

menuitem
├── check.left
╰── <child>

GtkCheckMenuItem имеет основной узел CSS с именем menuitem и под-узел с именем check, который получает класс стиля .left или .right.

Функции

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

void
gtk_check_menu_item_toggled (GtkCheckMenuItem *check_menu_item);

Вызывает сигнал «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);

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

Параметры

check_menu_item

элемент GtkCheckMenuItem

setting

TRUE для отображения «несогласованного» промежуточного состояния флажка

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

Типы и значения

struct GtkCheckMenuItem

struct GtkCheckMenuItem;

struct GtkCheckMenuItemClass

struct GtkCheckMenuItemClass {
  GtkMenuItemClass parent_class;


  void (* toggled)	  (GtkCheckMenuItem *check_menu_item);
  void (* draw_indicator) (GtkCheckMenuItem *check_menu_item,
			   cairo_t          *cr);
};

Члены

toggled ()

Сигнал, который генерируется при изменении состояния флажка.

draw_indicator ()

Вызывается для отрисовки индикатора флажка.

Подробное описание свойств

Свойство “active”

  “active”                   gboolean

Отмечен ли элемент меню.

Флаги: Чтение/Запись

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

Свойство “draw-as-radio”

  “draw-as-radio”            gboolean

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

Флаги: Чтение/Запись

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

Свойство “inconsistent”

  “inconsistent”             gboolean

Отображать ли состояние «несогласованность».

Флаги: Чтение/Запись

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

Подробное описание свойств стиля

Свойство “indicator-size”

  “indicator-size”           gint

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

GtkCheckMenuItem:indicator-size устарел с версии 3.20 и не должен использоваться в новом коде.

Используйте стандартное свойство CSS min-width для узлов флажка или радиокнопки; значение этого свойства стиля игнорируется.

Флаги: Чтение

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

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

Подробное описание сигналов

Сигнал “toggled”

void
user_function (GtkCheckMenuItem *checkmenuitem,
               gpointer          user_data)

Этот сигнал генерируется при изменении состояния флажка.

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

Параметры

checkmenuitem

объект, получивший сигнал.

user_data

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

Флаги: Выполняется первым

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.20/GtkCheckMenuItem.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API