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

#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

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