GtkRadioToolButton: GTK+ 3 Reference Manual

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

## Functions

GtkToolItem * | gtk_radio_tool_button_new ()
GtkToolItem * | gtk_radio_tool_button_new_from_stock ()
GtkToolItem * | gtk_radio_tool_button_new_from_widget ()
GtkToolItem * | gtk_radio_tool_button_new_with_stock_from_widget ()
GSList * | gtk_radio_tool_button_get_group ()
void | gtk_radio_tool_button_set_group ()

## Properties

GtkRadioToolButton * | group | Write

## Types and Values

struct | GtkRadioToolButton

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBin
                        ╰── GtkToolItem
                            ╰── GtkToolButton
                                ╰── GtkToggleToolButton
                                    ╰── GtkRadioToolButton

## Implemented Interfaces

GtkRadioToolButton implements AtkImplementorIface, GtkBuildable, GtkActivatable and GtkActionable.

## Includes

    #include <gtk/gtk.h>

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

### CSS nodes

GtkRadioToolButton has a single CSS node with name toolbutton.

## Functions

### gtk_radio_tool_button_new ()

    GtkToolItem *
    gtk_radio_tool_button_new (GSList *group);

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

#### Parameters

group | An existing radio button group, or `NULL` if you are creating a new group. | [allow-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);

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

#### Parameters

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`

[constructor]

#### Parameters

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

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

[constructor]

#### Parameters

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.

#### Parameters

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.

#### Parameters

button | a GtkRadioToolButton |
group | an existing radio button group, or `NULL`. | [element-type GtkRadioButton][allow-none]

Since: 2.4

## Types and Values

### struct GtkRadioToolButton

    struct GtkRadioToolButton;

## Property Details

### The `“group”` property

      “group”                    GtkRadioToolButton *

Sets a new group for a radio tool button.

Flags: Write

Since: 2.4

## See Also

GtkToolbar, GtkToolButton