| Top |  |
 |
 |
 |
Object Hierarchy
GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkToolItem ╰── GtkToolButton ╰── GtkToggleToolButton ╰── GtkRadioToolButton
Implemented Interfaces
GtkToggleToolButton implements AtkImplementorIface, GtkBuildable, GtkActivatable and GtkActionable.
Description
A GtkToggleToolButton is a GtkToolItem that contains a toggle button.
Use gtk_toggle_tool_button_new() to create a new
GtkToggleToolButton.
Functions
gtk_toggle_tool_button_new ()
GtkToolItem *
gtk_toggle_tool_button_new (void);
Returns a new GtkToggleToolButton
Since 2.4
gtk_toggle_tool_button_new_from_stock ()
GtkToolItem *
gtk_toggle_tool_button_new_from_stock (const gchar *stock_id);
gtk_toggle_tool_button_new_from_stock has been deprecated since version 3.10 and should not be used in newly-written code.
Use gtk_toggle_tool_button_new() instead.
Creates a new GtkToggleToolButton containing the image and text from a stock item. Some stock ids have preprocessor macros like GTK_STOCK_OK and GTK_STOCK_APPLY.
It is an error if stock_id
is not a name of a stock item.
Since 2.4
gtk_toggle_tool_button_set_active ()
void gtk_toggle_tool_button_set_active (GtkToggleToolButton *button,gboolean is_active);
Sets the status of the toggle tool button. Set to TRUE if you
want the GtkToggleButton to be “pressed in”, and FALSE to raise it.
This action causes the toggled signal to be emitted.
Since 2.4
gtk_toggle_tool_button_get_active ()
gboolean
gtk_toggle_tool_button_get_active (GtkToggleToolButton *button);
Queries a GtkToggleToolButton and returns its current state.
Returns TRUE if the toggle button is pressed in and FALSE if it is raised.
Since 2.4
Types and Values
struct GtkToggleToolButtonClass
struct GtkToggleToolButtonClass {
GtkToolButtonClass parent_class;
/* signal */
void (* toggled) (GtkToggleToolButton *button);
};
Members
GtkToolButtonClass |
The parent class. |
|
Signal emitted whenever the toggle tool button changes state. |
Property Details
The “active” property
“active” gboolean
If the toggle tool button should be pressed in.
Flags: Read / Write
Default value: FALSE
Since 2.8
Signal Details
The “toggled” signal
void user_function (GtkToggleToolButton *toggle_tool_button, gpointer user_data)
Emitted whenever the toggle tool button changes state.
Parameters
toggle_tool_button |
the object that emitted the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First