GTK+ Reference Manual |
---|
GtkRadioToolButtonGtkRadioToolButton — A toolbar item that contains a radio button |
#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);
GObject +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkToolItem +----GtkToolButton +----GtkToggleToolButton +----GtkRadioToolButton
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.
typedef struct _GtkRadioToolButton GtkRadioToolButton;
The GtkRadioToolButton contains only private data and should only be accessed through the functions described below.
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
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
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
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
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
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
"group" GtkRadioToolButton : Write
Sets a new group for a radio tool button.
Since 2.4
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. |
<< GtkToggleToolButton | Action-based menus and toolbars >> |