MxAction

## MxAction MxAction — Represents a user action |

## Synopsis

    struct              MxAction;
    MxAction *          mx_action_new                       (void);
    MxAction *          mx_action_new_full                  (const gchar *name,
                                                             const gchar *display_name,
                                                             GCallback activated_cb,
                                                             gpointer user_data);
    const gchar *       mx_action_get_name                  (MxAction *action);
    void                mx_action_set_name                  (MxAction *action,
                                                             const gchar *name);
    const gchar *       mx_action_get_display_name          (MxAction *action);
    void                mx_action_set_display_name          (MxAction *action,
                                                             const gchar *name);
    const gchar *       mx_action_get_icon                  (MxAction *action);
    void                mx_action_set_icon                  (MxAction *action,
                                                             const gchar *name);
    gboolean            mx_action_get_active                (MxAction *action);
    void                mx_action_set_active                (MxAction *action,
                                                             gboolean active);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----MxAction

## Properties

      "active"                   gboolean              : Read / Write
      "display-name"             gchar*                : Read / Write
      "icon"                     gchar*                : Read / Write
      "name"                     gchar*                : Read / Write

## Signals

      "activated"                                      : Run Last

## Description

Actions represent operations that the user can perform, such as items in a menu or toolbar.

## Details

### struct MxAction

    struct MxAction;

The contents of this structure are private and should only be accessed through the public API.

### mx_action_new ()

    MxAction *          mx_action_new                       (void);

Create a new, blank, MxAction

Returns : | a newly allocated MxAction

### mx_action_new_full ()

    MxAction *          mx_action_new_full                  (const gchar *name,
                                                             const gchar *display_name,
                                                             GCallback activated_cb,
                                                             gpointer user_data);

Create a new MxAction with the name and callback set

`name` : | name of the action
`display_name` : | name of the action to display to the user
`activated_cb` : | callback to connect to the activated signal
`user_data` : | user data to be passed to the callback
Returns : | a newly allocation MxAction

### mx_action_get_name ()

    const gchar *       mx_action_get_name                  (MxAction *action);

Get the name of the action

`action` : | A MxAction
Returns : | name of the action, owned by MxAction

### mx_action_set_name ()

    void                mx_action_set_name                  (MxAction *action,
                                                             const gchar *name);

Set the name of the action

`action` : | A MxAction
`name` : | new name to set

### mx_action_get_display_name ()

    const gchar *       mx_action_get_display_name          (MxAction *action);

Get the display name of the action

`action` : | A MxAction
Returns : | display-name of the action, owned by MxAction

### mx_action_set_display_name ()

    void                mx_action_set_display_name          (MxAction *action,
                                                             const gchar *name);

Set the name of the action to display to the user

`action` : | A MxAction
`name` : | new display name to set

### mx_action_get_icon ()

    const gchar *       mx_action_get_icon                  (MxAction *action);

Get the icon of the action

`action` : | A MxAction
Returns : | icon of the action, owned by MxAction

### mx_action_set_icon ()

    void                mx_action_set_icon                  (MxAction *action,
                                                             const gchar *name);

The icon to be used in a visual representation of an action.

`action` : | A MxAction
`name` : | new icon to set

### mx_action_get_active ()

    gboolean            mx_action_get_active                (MxAction *action);

Get the value of the active property

`action` : | A MxAction
Returns : | TRUE if the action is active

### mx_action_set_active ()

    void                mx_action_set_active                (MxAction *action,
                                                             gboolean active);

Set the value of the active property

`action` : | A MxAction
`active` : | the value to set

## Property Details

### The `"active"` property

      "active"                   gboolean              : Read / Write

Whether the action is active.

Default value: TRUE

### The `"display-name"` property

      "display-name"             gchar*                : Read / Write

Localised name to use for display.

Default value: NULL

### The `"icon"` property

      "icon"                     gchar*                : Read / Write

Icon name or path to to be used if this action is displayed.

Default value: NULL

### The `"name"` property

      "name"                     gchar*                : Read / Write

Action name.

Default value: NULL

## Signal Details

### The `"activated"` signal

    void                user_function                      (MxAction *action,
                                                            gpointer  user_data)      : Run Last

Emitted when the MxAction is activated.

`action` : | the object that received the signal
`user_data` : | user data set when the signal handler was connected.