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

Run First

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

struct	GtkCheckMenuItem
struct	GtkCheckMenuItemClass

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

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

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

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

Включаемые файлы

#include <gtk/gtk.h>

Описание

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

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

Узлы CSS

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

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

Функции

GtkWidget *
gtk_check_menu_item_new (void);

Создаёт новый элемент GtkCheckMenuItem.

Возвращает

новый GtkCheckMenuItem.

GtkWidget *
gtk_check_menu_item_new_with_label (const gchar *label);

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

Параметры

label

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

Возвращает

новый GtkCheckMenuItem.

GtkWidget *
gtk_check_menu_item_new_with_mnemonic (const gchar *label);

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

Параметры

label

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

Возвращает

новый GtkCheckMenuItem

gboolean
gtk_check_menu_item_get_active (GtkCheckMenuItem *check_menu_item);

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

Параметры

check_menu_item

элемент GtkCheckMenuItem

Возвращает

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

void
gtk_check_menu_item_set_active (GtkCheckMenuItem *check_menu_item,
                                gboolean is_active);

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

Параметры

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

void
gtk_check_menu_item_toggled (GtkCheckMenuItem *check_menu_item);

Вызывает сигнал “toggled”.

Параметры

check_menu_item

элемент GtkCheckMenuItem.

gboolean
gtk_check_menu_item_get_inconsistent (GtkCheckMenuItem *check_menu_item);

Возвращает значение, установленное с помощью gtk_check_menu_item_set_inconsistent().

Параметры

check_menu_item

элемент GtkCheckMenuItem

Возвращает

TRUE, если несогласованно

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` для отображения флажка "несогласованного" третьего состояния

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

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.22/GtkCheckMenuItem.html

GtkCheckMenuItem

Функции

Свойства

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

Сигналы

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

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

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

Включаемые файлы

Описание

Узлы CSS

Функции