GtkRadioMenuItem
GtkRadioMenuItem — Элемент радиокнопки меню
Функции
Свойства
| GtkRadioMenuItem * | группа | Запись |
Сигналы
Типы и значения
| struct | GtkRadioMenuItem |
Иерархия объектов
GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkMenuItem ╰── GtkCheckMenuItem ╰── GtkRadioMenuItem
Реализованные интерфейсы
GtkRadioMenuItem реализует AtkImplementorIface, GtkBuildable, GtkActivatable и GtkActionable.
Включаемые файлы
#include <gtk/gtk.h>
Описание
Элемент радиокнопки меню — это элемент меню, который относится к группе. В каждый момент времени ровно один из элементов радиокнопок меню в группе выбран.
Список группы не нужно освобождать, так как каждый GtkRadioMenuItem удалит себя и свой элемент списка при уничтожении.
Правильный способ создания группы элементов радиокнопок меню примерно такой:
Как создать группу элементов радиокнопок меню.
Узлы CSS
GtkRadioMenuItem имеет основной узел CSS с именем menuitem и подузлом с именем radio, который получает класс стиля .left или .right.
Функции
gtk_radio_menu_item_new ()
GtkWidget *
gtk_radio_menu_item_new (GSList *group); Создаёт новый GtkRadioMenuItem.
Параметры
group | группа, к которой следует присоединить элемент радио-меню, или | [element-type GtkRadioMenuItem][allow-none] |
Возвращает
новый GtkRadioMenuItem
gtk_radio_menu_item_new_with_label ()
GtkWidget * gtk_radio_menu_item_new_with_label (GSList *group,const gchar *label);
Создаёт новый GtkRadioMenuItem, чьим дочерним элементом является обычная метка GtkLabel.
Параметры
group | группа, в которой находится элемент радио-меню, или | [element-type GtkRadioMenuItem][allow-none] |
label | текст метки |
gtk_radio_menu_item_new_with_mnemonic ()
GtkWidget * gtk_radio_menu_item_new_with_mnemonic (GSList *group,const gchar *label);
Создаёт новый GtkRadioMenuItem содержащий метку. Метка будет создана с помощью gtk_label_new_with_mnemonic(), поэтому нижние подчёркивания в label обозначают мнемонические символы для элемента меню.
Параметры
group | группа, в которой находится элемент радио-меню, или | [element-type GtkRadioMenuItem][allow-none] |
label | текст элемента с нижним подчеркиванием перед мнемоническим символом |
Возвращает
новый GtkRadioMenuItem
gtk_radio_menu_item_new_from_widget ()
GtkWidget *
gtk_radio_menu_item_new_from_widget (GtkRadioMenuItem *group); Создаёт новый GtkRadioMenuItem, добавляя его в ту же группу, что и group .
[constructor]
Параметры
group | Существующий GtkRadioMenuItem. | [allow-none] |
С: 2.4
gtk_radio_menu_item_new_with_label_from_widget ()
GtkWidget * gtk_radio_menu_item_new_with_label_from_widget (GtkRadioMenuItem *group,const gchar *label);
Создаёт новый GtkRadioMenuItem, чьим дочерним элементом является обычная метка GtkLabel. Новый GtkRadioMenuItem добавляется в ту же группу, что и group .
[constructor]
Параметры
group | существующий GtkRadioMenuItem. | [allow-none] |
label | текст метки. | [allow-none] |
С: 2.4
gtk_radio_menu_item_new_with_mnemonic_from_widget ()
GtkWidget * gtk_radio_menu_item_new_with_mnemonic_from_widget (GtkRadioMenuItem *group,const gchar *label);
Создаёт новый GtkRadioMenuItem, содержащий метку. Метка создаётся с помощью gtk_label_new_with_mnemonic(), поэтому нижние подчеркивания в метке обозначают мнемонические символы для элемента меню.
Новый GtkRadioMenuItem добавляется в ту же группу, что и group .
[constructor]
Параметры
group | Существующий GtkRadioMenuItem. | [allow-none] |
label | Текст элемента с нижним подчеркиванием перед мнемоническим символом. | [allow-none] |
С: 2.4
gtk_radio_menu_item_set_group ()
void gtk_radio_menu_item_set_group (GtkRadioMenuItem *radio_menu_item,GSList *group);
Устанавливает группу для элемента радио-меню или изменяет её.
Параметры
radio_menu_item | элемент GtkRadioMenuItem. | |
group | новая группа, или | [element-type GtkRadioMenuItem][allow-none] |
gtk_radio_menu_item_get_group ()
GSList *
gtk_radio_menu_item_get_group (GtkRadioMenuItem *radio_menu_item); Возвращает группу, к которой принадлежит элемент радиоменю, в виде списка GList элементов GtkRadioMenuItem. Список принадлежит GTK+ и не должен освобождаться.
Параметры
radio_menu_item | элемент GtkRadioMenuItem |
Возвращает
группу radio_menu_item .
[element-type GtkRadioMenuItem][transfer none]
gtk_radio_menu_item_join_group ()
void gtk_radio_menu_item_join_group (GtkRadioMenuItem *radio_menu_item,GtkRadioMenuItem *group_source);
Подключает объект GtkRadioMenuItem к группе другого объекта GtkRadioMenuItem.
Эта функция должна использоваться языковыми связями для избежания управления памятью неявного GSList элементов gtk_radio_menu_item_get_group() и gtk_radio_menu_item_set_group().
Типичный способ создания группы элементов GtkRadioMenuItem:
GSList*group = NULL; GtkWidget*item; gint i; for(i =0; i <5; i++) { item =gtk_radio_menu_item_new_with_label(group,"This is an example"); group =gtk_radio_menu_item_get_group(GTK_RADIO_MENU_ITEM(item)); if(i ==1) gtk_check_menu_item_set_active(GTK_CHECK_MENU_ITEM(item), TRUE); }
Параметры
radio_menu_item | элемент GtkRadioMenuItem | |
group_source | элемент GtkRadioMenuItem, к группе которого мы присоединяемся, или | [allow-none] |
С: 3.18
Типы и значения
struct GtkRadioMenuItem
struct GtkRadioMenuItem;
Подробное описание свойств
Свойство “group”
“group” GtkRadioMenuItem *
Элемент радиоменю, группа которого принадлежит данному элементу.
Флаги: Запись
С: 2.8
Подробное описание сигналов
Сигнал “group-changed”
void user_function (GtkRadioMenuItem *radiomenuitem, gpointer user_data)
Флаги: Run First
См. также
© 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/GtkRadioMenuItem.html
