| | | GTK+ Reference Manual | |
|---|
GtkRadioMenuItem — A choice from multiple check menu items.
#include <gtk/gtk.h> struct 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); #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 +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkItem +----GtkMenuItem +----GtkCheckMenuItem +----GtkRadioMenuItem
GtkRadioMenuItem implements AtkImplementorIface.
A radio menu item is a check menu item that belongs to a group. At each instant exactly one of the radio menu items from a group is selected.
The group list does not need to be freed, as each GtkRadioMenuItem will remove itself and its list item when it is destroyed.
The correct way to create a group of radio menu items is approximatively this:
Example 5. How to create a group of radio menu items.
GList *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);
}
struct GtkRadioMenuItem;
The structure contains only private data that must be accessed through the interface functions.
GtkWidget* gtk_radio_menu_item_new (GSList *group);
Creates a new GtkRadioMenuItem.
| group : | the group to which the radio menu item is to be attached |
| Returns : | a new GtkRadioMenuItem |
GtkWidget* gtk_radio_menu_item_new_with_label (GSList *group, const gchar *label);
Creates a new GtkRadioMenuItem whose child is a simple GtkLabel.
| group : | the group to which the radio menu item is to be attached |
| label : | the text for the label |
| Returns : | a new GtkRadioMenuItem |
GtkWidget* gtk_radio_menu_item_new_with_mnemonic (GSList *group, const gchar *label);
Creates a new GtkRadioMenuItem containing a label. The label will be created using gtk_label_new_with_mnemonic(), so underscores in label indicate the mnemonic for the menu item.
| group : | group the radio menu item is inside |
| label : | the text of the button, with an underscore in front of the mnemonic character |
| Returns : | a new GtkRadioMenuItem |
#define gtk_radio_menu_item_group gtk_radio_menu_item_get_group
Deprecated compatibility macro. Use gtk_radio_menu_item_get_group() instead.
void gtk_radio_menu_item_set_group (GtkRadioMenuItem *radio_menu_item, GSList *group);
Sets the group of a radio menu item, or changes it.
| radio_menu_item : | a GtkRadioMenuItem. |
| group : | the new group. |
GSList* gtk_radio_menu_item_get_group (GtkRadioMenuItem *radio_menu_item);
Returns the group to which the radio menu item belongs, as a GList of GtkRadioMenuItem. The list belongs to GTK+ and should not be freed.
| radio_menu_item : | a GtkRadioMenuItem. |
| Returns : | the group of radio_menu_item. |
| GtkMenuItem | because a radio menu item is a menu item. |
| GtkCheckMenuItem | to know how to handle the check. |
| << GtkImageMenuItem | GtkCheckMenuItem >> |