Spec-Zone.ru › GTK 3.24

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 активный Чтение / Запись
gboolean отображать_как_радиокнопку Чтение / Запись
gboolean несогласованный Чтение / Запись

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

int размер_указателя Чтение

Сигналы

void переключен Выполняется первым

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

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 с меткой.

Параметры

метка

строка, используемая в качестве метки.

Возвращаемое значение

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

Параметры

метка

Текст кнопки, с подчёркнутой буквой

Возвращаемое значение

новый GtkCheckMenuItem

gtk_check_menu_item_get_active ()

gboolean
gtk_check_menu_item_get_active (GtkCheckMenuItem *check_menu_item);

Возвращает, активен ли элемент меню. См. gtk_check_menu_item_set_active().

Параметры

элемент_меню

элемент GtkCheckMenuItem

Возвращаемое значение

TRUE , если пункт меню выбран.

gtk_check_menu_item_set_active ()

void
gtk_check_menu_item_set_active (GtkCheckMenuItem *check_menu_item,
                                gboolean is_active);

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

Параметры

элемент_меню

элемент GtkCheckMenuItem.

активно

логическое значение, указывающее, активен ли флажок.

gtk_check_menu_item_toggled ()

void
gtk_check_menu_item_toggled (GtkCheckMenuItem *check_menu_item);

Вызывает сигнал «toggled».

Параметры

элемент_меню

элемент GtkCheckMenuItem.

gtk_check_menu_item_get_inconsistent ()

gboolean
gtk_check_menu_item_get_inconsistent (GtkCheckMenuItem *check_menu_item);

Возвращает значение, установленное функцией gtk_check_menu_item_set_inconsistent().

Параметры

элемент_меню

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

Параметры

элемент_меню

элемент GtkCheckMenuItem

значение

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.

Параметры

элемент_меню

элемент GtkCheckMenuItem

отображать_как_радио

отображать ли 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

Параметры

элемент_меню

элемент GtkCheckMenuItem

Возвращаемое значение

Отображается ли check_menu_item как элемент GtkRadioMenuItem

С: 2.4

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

структура GtkCheckMenuItem

struct GtkCheckMenuItem;

структура 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

Выбран ли пункт меню.

Владелец: GtkCheckMenuItem

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

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

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

  “draw-as-radio”            gboolean

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

Владелец: GtkCheckMenuItem

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

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

Свойство “inconsistent”

  “inconsistent”             gboolean

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

Владелец: GtkCheckMenuItem

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

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

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

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

  “indicator-size”           int

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

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

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

Владелец: GtkCheckMenuItem

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

Допустимые значения: >= 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.24/GtkCheckMenuItem.html

Spec-Zone.ru

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