## GtkRadioToolButton

GtkRadioToolButton — A toolbar item that contains a radio button

## Synopsis

    #include <gtk/gtk.h>

                        GtkRadioToolButton;
    GtkToolItem*        gtk_radio_tool_button_new           (GSList *group);
    GtkToolItem*        gtk_radio_tool_button_new_from_stock
                                                            (GSList *group,
                                                             const gchar *stock_id);
    GtkToolItem*        gtk_radio_tool_button_new_from_widget
                                                            (GtkRadioToolButton *group);
    GtkToolItem*        gtk_radio_tool_button_new_with_stock_from_widget
                                                            (GtkRadioToolButton *group,
                                                             const gchar *stock_id);
    GSList*             gtk_radio_tool_button_get_group     (GtkRadioToolButton *button);
    void                gtk_radio_tool_button_set_group     (GtkRadioToolButton *button,
                                                             GSList *group);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkToolItem
                                           +----GtkToolButton
                                                 +----GtkToggleToolButton
                                                       +----GtkRadioToolButton

## Implemented Interfaces

GtkRadioToolButton implements AtkImplementorIface and GtkBuildable.

## Properties

      "group"                    GtkRadioToolButton*   : Write

## Description

A GtkRadioToolButton is a GtkToolItem that contains a radio button, that is, a button that is part of a group of toggle buttons where only one button can be active at a time.

Use `gtk_radio_tool_button_new()` to create a new GtkRadioToolButton. use `gtk_radio_tool_button_new_from_widget()` to create a new GtkRadioToolButton that is part of the same group as an existing GtkRadioToolButton. Use `gtk_radio_tool_button_new_from_stock()` or `gtk_radio_tool_button_new_from_widget_with_stock()` to create a new GtkRAdioToolButton containing a stock item.

## Details

### GtkRadioToolButton

    typedef struct _GtkRadioToolButton GtkRadioToolButton;

The GtkRadioToolButton contains only private data and should only be accessed through the functions described below.

### gtk_radio_tool_button_new ()

    GtkToolItem*        gtk_radio_tool_button_new           (GSList *group);

Creates a new GtkRadioToolButton, adding it to `group`.

`group` : | An existing radio button group, or `NULL` if you are creating a new group
Returns : | The new GtkRadioToolButton

Since 2.4

### gtk_radio_tool_button_new_from_stock ()

    GtkToolItem*        gtk_radio_tool_button_new_from_stock
                                                            (GSList *group,
                                                             const gchar *stock_id);

Creates a new GtkRadioToolButton, adding it to `group`. The new GtkRadioToolButton will contain an icon and label from the stock item indicated by `stock_id`.

`group` : | an existing radio button group, or `NULL` if you are creating a new group
`stock_id` : | the name of a stock item
Returns : | The new GtkRadioToolItem

Since 2.4

### gtk_radio_tool_button_new_from_widget ()

    GtkToolItem*        gtk_radio_tool_button_new_from_widget
                                                            (GtkRadioToolButton *group);

Creates a new GtkRadioToolButton adding it to the same group as `gruup`

`group` : | An existing GtkRadioToolButton
Returns : | The new GtkRadioToolButton

Since 2.4

### gtk_radio_tool_button_new_with_stock_from_widget ()

    GtkToolItem*        gtk_radio_tool_button_new_with_stock_from_widget
                                                            (GtkRadioToolButton *group,
                                                             const gchar *stock_id);

Creates a new GtkRadioToolButton adding it to the same group as `group`. The new GtkRadioToolButton will contain an icon and label from the stock item indicated by `stock_id`.

`group` : | An existing GtkRadioToolButton.
`stock_id` : | the name of a stock item
Returns : | A new GtkRadioToolButton

Since 2.4

### gtk_radio_tool_button_get_group ()

    GSList*             gtk_radio_tool_button_get_group     (GtkRadioToolButton *button);

Returns the radio button group `button` belongs to.

`button` : | a GtkRadioToolButton
Returns : | The group `button` belongs to.

Since 2.4

### gtk_radio_tool_button_set_group ()

    void                gtk_radio_tool_button_set_group     (GtkRadioToolButton *button,
                                                             GSList *group);

Adds `button` to `group`, removing it from the group it belonged to before.

`button` : | a GtkRadioToolButton
`group` : | an existing radio button group

Since 2.4

## Property Details

### The `"group"` property

      "group"                    GtkRadioToolButton*   : Write

Sets a new group for a radio tool button.

Since 2.4

## See Also

GtkToolbar | The toolbar widget
GtkToolButton | An ancestor class of GtkRadioToolButton. The properties "label_widget", "label", "icon_widget", and "stock_id" on GtkToolButton determine the label and icon used on a GtkRadioToolButton.
GtkSeparatorToolItem | A subclass of GtkToolItem that separates groups of items on a toolbar. It is usually a good idea to put a separator before and after a group of GtkRadioToolButtons on a GtkToolbar.