| GTK+ Reference Manual | |||
|---|---|---|---|
| <<< Previous Page | Home | Up | Next Page >>> | 
| #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 | 
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 correct way to create a group of radio menu items is aproximativly this:
Example 1. 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 : | |
| 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 : | |
| 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. |