GtkRadioMenuItem
GtkRadioMenuItem — Элемент меню выбора из группы элементов
Функции
Свойства
| GtkRadioMenuItem * | group | Запись |
Сигналы
| void | group-changed | Выполняется первым |
Типы и значения
| 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] |
Since: 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] |
Since: 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] |
Since: 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 *
Элемент меню радио, к чьей группе принадлежит данный виджет.
Владелец: GtkRadioMenuItem
Флаги: Запись
С версии: 2.8
Подробное описание сигналов
Сигнал “group-changed”
void user_function (GtkRadioMenuItem *radiomenuitem, gpointer 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/GtkRadioMenuItem.html
