<< Back to man.ChinaUnix.net

<< Back to man.ChinaUnix.net

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

Implemented Interfaces

GtkRadioToolButton implements AtkImplementorIface.

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

Properties

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.