An action which can be triggered by a menu or toolbar item.
Actions are basically some operation that you want the user to perform.
Hence, actions are usually linked to some event that triggers it. Each
action provides methods to create icons, menu items and toolbar items that
GtkAction allows you to create such actions, use
methods to represent it, and actually perform that action when the event
occurs. The following may be associated with an action:
The action will also have certain state information attached to it:
- A name (This is not transalated and is for internal use of the
- A label (Translated and displayed on the screen)
- An accelerator (The "shortcut-key" that triggers the action)
- Whether or not the label indicates a stock ID
- A tooltip (Translated and displyed on mouse over)
- A toolbar label (Translated and shorter than a label)
- The Callback (Function that specifies the action to be
- Visible (Show or Hide the action)
- Sensitive (Enable or Disable the action)
Each action may have one or more proxies, such as menu items, toolbar
buttons or other such proxy widgets. Proxies basically mirror the state
of the action (text label, tooltip, icon, visible etc.) and should change
when the action's state changes. When the proxy is activated, it should
activate its action (through the associated callback).
Creates an action associated to the various parameters.
, string label
, string tooltip
, string stock_id
Emitted when the action is triggered (or activated!)