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. Use gtk_radio_tool_button_new_from_stock() or gtk_radio_tool_button_new_with_stock_from_widget() create a new GtkRadioToolButton containing a stock item.

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

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

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