ctk_action_new ()

CtkAction *
ctk_action_new (const gchar *name,
                const gchar *label,
                const gchar *tooltip,
                const gchar *stock_id);

Creates a new CtkAction object. To add the action to a CtkActionGroup and set the accelerator for the action, call ctk_action_group_add_action_with_accel(). See the UI Definition section for information on allowed action names.

Since: 2.4

ctk_action_get_name ()

const gchar *
ctk_action_get_name (CtkAction *action);

Returns the name of the action.

Since: 2.4

ctk_action_is_sensitive ()

gboolean
ctk_action_is_sensitive (CtkAction *action);

Returns whether the action is effectively sensitive.

Since: 2.4

ctk_action_get_sensitive ()

gboolean
ctk_action_get_sensitive (CtkAction *action);

Returns whether the action itself is sensitive. Note that this doesn’t necessarily mean effective sensitivity. See ctk_action_is_sensitive() for that.

Since: 2.4

ctk_action_set_sensitive ()

void
ctk_action_set_sensitive (CtkAction *action,
                          gboolean sensitive);

Sets the :sensitive property of the action to sensitive . Note that this doesn’t necessarily mean effective sensitivity. See ctk_action_is_sensitive() for that.

Since: 2.6

ctk_action_is_visible ()

gboolean
ctk_action_is_visible (CtkAction *action);

Returns whether the action is effectively visible.

Since: 2.4

ctk_action_get_visible ()

gboolean
ctk_action_get_visible (CtkAction *action);

Returns whether the action itself is visible. Note that this doesn’t necessarily mean effective visibility. See ctk_action_is_sensitive() for that.

Since: 2.4

ctk_action_set_visible ()

void
ctk_action_set_visible (CtkAction *action,
                        gboolean visible);

Sets the :visible property of the action to visible . Note that this doesn’t necessarily mean effective visibility. See ctk_action_is_visible() for that.

Since: 2.6

ctk_action_activate ()

void
ctk_action_activate (CtkAction *action);

Emits the “activate” signal on the specified action, if it isn't insensitive. This gets called by the proxy widgets when they get activated.

It can also be used to manually activate an action.

Since: 2.4

ctk_action_create_icon ()

CtkWidget *
ctk_action_create_icon (CtkAction *action,
                        CtkIconSize icon_size);

This function is intended for use by action implementations to create icons displayed in the proxy widgets.

Since: 2.4

ctk_action_create_menu_item ()

CtkWidget *
ctk_action_create_menu_item (CtkAction *action);

Creates a menu item widget that proxies for the given action.

Since: 2.4

ctk_action_create_tool_item ()

CtkWidget *
ctk_action_create_tool_item (CtkAction *action);

Creates a toolbar item widget that proxies for the given action.

Since: 2.4

ctk_action_create_menu ()

CtkWidget *
ctk_action_create_menu (CtkAction *action);

If action provides a CtkMenu widget as a submenu for the menu item or the toolbar item it creates, this function returns an instance of that menu.

Since: 2.12

ctk_action_get_proxies ()

GSList *
ctk_action_get_proxies (CtkAction *action);

Returns the proxy widgets for an action. See also ctk_activatable_get_related_action().

Since: 2.4

ctk_action_connect_accelerator ()

void
ctk_action_connect_accelerator (CtkAction *action);

Installs the accelerator for action if action has an accel path and group. See ctk_action_set_accel_path() and ctk_action_set_accel_group()

Since multiple proxies may independently trigger the installation of the accelerator, the action counts the number of times this function has been called and doesn’t remove the accelerator until ctk_action_disconnect_accelerator() has been called as many times.

Since: 2.4

ctk_action_disconnect_accelerator ()

void
ctk_action_disconnect_accelerator (CtkAction *action);

Undoes the effect of one call to ctk_action_connect_accelerator().

Since: 2.4

ctk_action_block_activate ()

void
ctk_action_block_activate (CtkAction *action);

Disable activation signals from the action

This is needed when updating the state of your proxy CtkActivatable widget could result in calling ctk_action_activate(), this is a convenience function to avoid recursing in those cases (updating toggle state for instance).

Since: 2.16

ctk_action_unblock_activate ()

void
ctk_action_unblock_activate (CtkAction *action);

Reenable activation signals from the action

Since: 2.16

ctk_action_get_always_show_image ()

gboolean
ctk_action_get_always_show_image (CtkAction *action);

Returns whether action 's menu item proxies will always show their image, if available.

Since: 2.20

ctk_action_set_always_show_image ()

void
ctk_action_set_always_show_image (CtkAction *action,
                                  gboolean always_show);

Sets whether action 's menu item proxies will ignore the “ctk-menu-images” setting and always show their image, if available.

Use this if the menu item would be useless or hard to use without their image.

Since: 2.20

ctk_action_get_accel_path ()

const gchar *
ctk_action_get_accel_path (CtkAction *action);

Returns the accel path for this action.

Since: 2.6

ctk_action_set_accel_path ()

void
ctk_action_set_accel_path (CtkAction *action,
                           const gchar *accel_path);

Sets the accel path for this action. All proxy widgets associated with the action will have this accel path, so that their accelerators are consistent.

Note that accel_path string will be stored in a GQuark. Therefore, if you pass a static string, you can save some memory by interning it first with g_intern_static_string().

Since: 2.4

ctk_action_get_accel_closure ()

GClosure *
ctk_action_get_accel_closure (CtkAction *action);

Returns the accel closure for this action.

Since: 2.8

ctk_action_set_accel_group ()

void
ctk_action_set_accel_group (CtkAction *action,
                            CtkAccelGroup *accel_group);

Sets the CtkAccelGroup in which the accelerator for this action will be installed.

Since: 2.4

ctk_action_set_label ()

void
ctk_action_set_label (CtkAction *action,
                      const gchar *label);

Sets the label of action .

Since: 2.16

ctk_action_get_label ()

const gchar *
ctk_action_get_label (CtkAction *action);

Gets the label text of action .

Since: 2.16

ctk_action_set_short_label ()

void
ctk_action_set_short_label (CtkAction *action,
                            const gchar *short_label);

Sets a shorter label text on action .

Since: 2.16

ctk_action_get_short_label ()

const gchar *
ctk_action_get_short_label (CtkAction *action);

Gets the short label text of action .

Since: 2.16

ctk_action_set_tooltip ()

void
ctk_action_set_tooltip (CtkAction *action,
                        const gchar *tooltip);

Sets the tooltip text on action

Since: 2.16

ctk_action_get_tooltip ()

const gchar *
ctk_action_get_tooltip (CtkAction *action);

Gets the tooltip text of action .

Since: 2.16

ctk_action_set_stock_id ()

void
ctk_action_set_stock_id (CtkAction *action,
                         const gchar *stock_id);

Sets the stock id on action

Since: 2.16

ctk_action_get_stock_id ()

const gchar *
ctk_action_get_stock_id (CtkAction *action);

Gets the stock id of action .

Since: 2.16

ctk_action_set_gicon ()

void
ctk_action_set_gicon (CtkAction *action,
                      GIcon *icon);

Sets the icon of action .

Since: 2.16

ctk_action_get_gicon ()

GIcon *
ctk_action_get_gicon (CtkAction *action);

Gets the gicon of action .

Since: 2.16

ctk_action_set_icon_name ()

void
ctk_action_set_icon_name (CtkAction *action,
                          const gchar *icon_name);

Sets the icon name on action

Since: 2.16

ctk_action_get_icon_name ()

const gchar *
ctk_action_get_icon_name (CtkAction *action);

Gets the icon name of action .

Since: 2.16

ctk_action_set_visible_horizontal ()

void
ctk_action_set_visible_horizontal (CtkAction *action,
                                   gboolean visible_horizontal);

Sets whether action is visible when horizontal

Since: 2.16

ctk_action_get_visible_horizontal ()

gboolean
ctk_action_get_visible_horizontal (CtkAction *action);

Checks whether action is visible when horizontal

Since: 2.16

ctk_action_set_visible_vertical ()

void
ctk_action_set_visible_vertical (CtkAction *action,
                                 gboolean visible_vertical);

Sets whether action is visible when vertical

Since: 2.16

ctk_action_get_visible_vertical ()

gboolean
ctk_action_get_visible_vertical (CtkAction *action);

Checks whether action is visible when horizontal

Since: 2.16

ctk_action_set_is_important ()

void
ctk_action_set_is_important (CtkAction *action,
                             gboolean is_important);

Sets whether the action is important, this attribute is used primarily by toolbar items to decide whether to show a label or not.

Since: 2.16

ctk_action_get_is_important ()

gboolean
ctk_action_get_is_important (CtkAction *action);

Checks whether action is important or not

Since: 2.16

struct CtkAction

struct CtkAction;

struct CtkActionClass

struct CtkActionClass {
  GObjectClass parent_class;

  /* activation signal */
  void       (* activate)           (CtkAction    *action);
};

The “action-group” property

  “action-group”             CtkActionGroup *

The CtkActionGroup this CtkAction is associated with, or NULL (for internal use).

Owner: CtkAction

Flags: Read / Write

The “always-show-image” property

  “always-show-image”        gboolean

If TRUE, the action's menu item proxies will ignore the “ctk-menu-images” setting and always show their image, if available.

Use this property if the menu item would be useless or hard to use without their image.

Owner: CtkAction

Flags: Read / Write / Construct

Default value: FALSE

Since: 2.20

The “gicon” property

  “gicon”                    GIcon *

The GIcon displayed in the CtkAction.

Note that the stock icon is preferred, if the “stock-id” property holds the id of an existing stock icon.

This is an appearance property and thus only applies if “use-action-appearance” is TRUE.

Owner: CtkAction

Flags: Read / Write

Since: 2.16

The “hide-if-empty” property

  “hide-if-empty”            gboolean

When TRUE, empty menu proxies for this action are hidden.

Owner: CtkAction

Flags: Read / Write

Default value: TRUE

The “icon-name” property

  “icon-name”                char *

The name of the icon from the icon theme.

Note that the stock icon is preferred, if the “stock-id” property holds the id of an existing stock icon, and the GIcon is preferred if the “gicon” property is set.

This is an appearance property and thus only applies if “use-action-appearance” is TRUE.

Owner: CtkAction

Flags: Read / Write

Default value: NULL

Since: 2.10

The “is-important” property

  “is-important”             gboolean

Whether the action is considered important. When TRUE, toolitem proxies for this action show text in CTK_TOOLBAR_BOTH_HORIZ mode.

Owner: CtkAction

Flags: Read / Write

Default value: FALSE

The “label” property

  “label”                    char *

The label used for menu items and buttons that activate this action. If the label is NULL, CTK+ uses the stock label specified via the stock-id property.

This is an appearance property and thus only applies if “use-action-appearance” is TRUE.

Owner: CtkAction

Flags: Read / Write

Default value: NULL

The “name” property

  “name”                     char *

A unique name for the action.

Owner: CtkAction

Flags: Read / Write / Construct Only

Default value: NULL

The “sensitive” property

  “sensitive”                gboolean

Whether the action is enabled.

Owner: CtkAction

Flags: Read / Write

Default value: TRUE

The “short-label” property

  “short-label”              char *

A shorter label that may be used on toolbar buttons.

This is an appearance property and thus only applies if “use-action-appearance” is TRUE.

Owner: CtkAction

Flags: Read / Write

Default value: NULL

The “stock-id” property

  “stock-id”                 char *

The stock icon displayed in widgets representing this action.

This is an appearance property and thus only applies if “use-action-appearance” is TRUE.

Owner: CtkAction

Flags: Read / Write

Default value: NULL

The “tooltip” property

  “tooltip”                  char *

A tooltip for this action.

Owner: CtkAction

Flags: Read / Write

Default value: NULL

The “visible” property

  “visible”                  gboolean

Whether the action is visible.

Owner: CtkAction

Flags: Read / Write

Default value: TRUE

The “visible-horizontal” property

  “visible-horizontal”       gboolean

Whether the toolbar item is visible when the toolbar is in a horizontal orientation.

Owner: CtkAction

Flags: Read / Write

Default value: TRUE

The “visible-overflown” property

  “visible-overflown”        gboolean

When TRUE, toolitem proxies for this action are represented in the toolbar overflow menu.

Owner: CtkAction

Flags: Read / Write

Default value: TRUE

Since: 2.6

The “visible-vertical” property

  “visible-vertical”         gboolean

Whether the toolbar item is visible when the toolbar is in a vertical orientation.

Owner: CtkAction

Flags: Read / Write

Default value: TRUE

The “activate” signal

void
user_function (CtkAction *action,
               gpointer   user_data)

The "activate" signal is emitted when the action is activated.

Flags: No Recursion

Since: 2.4