GTK+ 3 Reference Manual: GtkRadioToolButton

## GtkRadioToolButton GtkRadioToolButton — A toolbar item that contains a radio button |

## Synopsis

    #include <gtk/gtk.h>

    struct              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
             +----GtkWidget
                   +----GtkContainer
                         +----GtkBin
                               +----GtkToolItem
                                     +----GtkToolButton
                                           +----GtkToggleToolButton
                                                 +----GtkRadioToolButton

## Implemented Interfaces

GtkRadioToolButton implements AtkImplementorIface, GtkBuildable, GtkActivatable and GtkActionable.

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

## Details

### struct GtkRadioToolButton

    struct GtkRadioToolButton;

### 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. [allow-none][transfer none][element-type GtkRadioButton]
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);

### Warning

`gtk_radio_tool_button_new_from_stock` has been deprecated since version 3.10 and should not be used in newly-written code. Use `gtk_radio_tool_button_new()` instead.

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. [allow-none][element-type GtkRadioButton]
`stock_id` : | the name of a stock item
Returns : | The new GtkRadioToolButton

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, or `NULL`. [allow-none]
Returns : | The new GtkRadioToolButton. [transfer none]

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);

### Warning

`gtk_radio_tool_button_new_with_stock_from_widget` has been deprecated since version 3.10 and should not be used in newly-written code. gtk_radio_tool_button_new_from_widget

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. [allow-none]
`stock_id` : | the name of a stock item
Returns : | A new GtkRadioToolButton. [transfer none]

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. [transfer none][element-type GtkRadioButton]

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. [transfer none][element-type GtkRadioButton]

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, GtkToolButton