GtkToggleToolButton

CSS nodes

GtkToggleToolButton has a single CSS node with name togglebutton.

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

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

struct GtkToggleToolButton

struct GtkToggleToolButton;

struct GtkToggleToolButtonClass

struct GtkToggleToolButtonClass {
  GtkToolButtonClass parent_class;

  /* signal */
  void (* toggled) (GtkToggleToolButton *button);
};

The “active” property

  “active”                   gboolean

If the toggle tool button should be pressed in.

Owner: GtkToggleToolButton

Flags: Read / Write

Default value: FALSE

Since: 2.8

The “toggled” signal

void
user_function (GtkToggleToolButton *toggle_tool_button,
               gpointer             user_data)

Emitted whenever the toggle tool button changes state.

Flags: Run First