Поиск (ключи):    ПРОГРАММЫ СТАТЬИ СОВЕТЫ ФОРУМ   WIKI НОВОСТИ (+) MAN'ы ДОКУМЕНТАЦИЯ

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

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

#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.

gtk_radio_menu_item_new_with_label ()

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

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

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

gtk_radio_menu_item_new_from_widget ()

GtkWidget*  gtk_radio_menu_item_new_from_widget
                                            (GtkRadioMenuItem *group);

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

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

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

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

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

gtk_radio_menu_item_get_group ()

GSList*     gtk_radio_menu_item_get_group   (GtkRadioMenuItem *radio_menu_item);

Возвращает группу к которой принадлежит радио пункт меню, как GList GtkRadioMenuItem. Список принадлежит GTK+ и не должен освобождаться.

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

Свойство "group"

  "group"                GtkRadioMenuItem      : Write

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

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

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

Сигнал "group-changed"

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

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

ПОДПИШИСЬ НА ЖУРНАЛ Linux Format 2012! Журнал "Linux Format" (Линукс Формат)- Единственный в России и странах СНГ журнал на русском языке, посвящённый Linux и свободному ПО. Журнал для IT-директоров, IT-менеджеров, программистов, системных администраторов, учителей школ и преподавателей ВУЗов и всех пользователей ПК. В каждом выпуске: Новости индустрии OpenSource, обзоры новинок свободного ПО, обучающие и методические статьи. Каждый, кто оформит подписку, получает бонусы и подарки- объёмные наклейки на системный блок, диск с архивом номеров за 2005-2011 г.г. и ежемесячно электронную версию журнала в pdf-формате. Оформить подписку на год