Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Implemented Interfaces  |  Properties  |  Signals

GtkRadioMenuItem

GtkRadioMenuItem выбор из группы объединенных пунктов

Краткое описание

#include <gtk/gtk.h> GtkRadioMenuItem; GtkWidget* gtk_radio_menu_item_new (GSList *group); GtkWidget* gtk_radio_menu_item_new_with_label (GSList *group, const gchar *label); GtkWidget* gtk_radio_menu_item_new_with_mnemonic (GSList *group, const gchar *label); GtkWidget* gtk_radio_menu_item_new_from_widget (GtkRadioMenuItem *group); GtkWidget* gtk_radio_menu_item_new_with_label_from_widget (GtkRadioMenuItem *group, const gchar *label); GtkWidget* gtk_radio_menu_item_new_with_mnemonic_from_widget (GtkRadioMenuItem *group, const gchar *label); #define gtk_radio_menu_item_group void gtk_radio_menu_item_set_group (GtkRadioMenuItem *radio_menu_item, GSList *group); GSList* gtk_radio_menu_item_get_group (GtkRadioMenuItem *radio_menu_item);

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

GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkItem +----GtkMenuItem +----GtkCheckMenuItem +----GtkRadioMenuItem

Осуществляемые интерфейсы

GtkRadioMenuItem осуществляет AtkImplementorIface.

Свойства

  "group"                GtkRadioMenuItem      : Write

Сигналы

"group-changed" void user_function (GtkRadioMenuItem *radiomenuitem, gpointer user_data) : Run first

Описание

Радио пункты меню это пункты меню объединенные в группу. Единовременно может быть выбран только один пункт из группы.

Список группы не должен освобождаться, так как каждый GtkRadioMenuItem удаляется непосредственно и его список пунктов когда он разрушается.

Корректный способ создания группы радио пунктов меню примерно такой:

Пример 3. Как создать группу радио пунктов меню.

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); }

Детали

GtkRadioMenuItem

typedef struct _GtkRadioMenuItem GtkRadioMenuItem;

Структура содержит только закрытые данные доступ к которым может производиться через функции интерфейса.


gtk_radio_menu_item_new ()

GtkWidget*  gtk_radio_menu_item_new         (GSList *group);

Создаёт новый GtkRadioMenuItem.

group :

Группа к которой прикрепляется радио пункт меню

Возвращает :

новый GtkRadioMenuItem


gtk_radio_menu_item_new_with_label ()

GtkWidget* gtk_radio_menu_item_new_with_label (GSList *group, const gchar *label);

Создаёт новый GtkRadioMenuItem с дочерним виджетом GtkLabel.

group :

Группа к которой прикрепляется радио пункт меню

label :

Текст ярлыка

Возвращает :

новый GtkRadioMenuItem


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 :

Группа в которую вставляется радио пункт меню

label :

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

Возвращает :

новый GtkRadioMenuItem


gtk_radio_menu_item_new_from_widget ()

GtkWidget* gtk_radio_menu_item_new_from_widget (GtkRadioMenuItem *group);

Создаёт новый GtkRadioMenuItem добавляя его к некоторой группе определенной как group.

group :

Существующий GtkRadioMenuItem

Возвращает :

новый GtkRadioMenuItem

Начиная с версии 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.

group :

существующий GtkRadioMenuItem

label :

Текст ярлыка

Возвращает :

новый GtkRadioMenuItem

Начиная с версии 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.

group :

существующий GtkRadioMenuItem

label :

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

Возвращает :

новый GtkRadioMenuItem

Начиная с версии 2.4


gtk_radio_menu_item_group

#define gtk_radio_menu_item_group gtk_radio_menu_item_get_group

Внимание

gtk_radio_menu_item_group устарел и не должен использоваться во вновь создаваемом коде.

Устаревший макрос совместимости. Вместо него используйте gtk_radio_menu_item_get_group().


gtk_radio_menu_item_set_group ()

void gtk_radio_menu_item_set_group (GtkRadioMenuItem *radio_menu_item, GSList *group);

Устанавливает группу радио пунктов меню, или изменяет её.

radio_menu_item :

GtkRadioMenuItem.

group :

Новая группа.


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.

Детали свойств

Свойство "group"

  "group"                GtkRadioMenuItem      : Write

Группа которой принадлежит радио пункт меню.

Начиная с версии 2.8

Детали сигналов

Сигнал "group-changed"

void user_function (GtkRadioMenuItem *radiomenuitem, gpointer user_data) : Run first

radiomenuitem :

Объект получающий сигнал.

user_data :

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

Смотрите также

GtkMenuItem

Потомучто радио пункт меню это пункт меню.

GtkCheckMenuItem

Как обрабатывается контроль.