Atspi.Action.get_key_binding

### Method

# Atspi Actionget_key_binding

#### Declaration [src]

    gchar*
    atspi_action_get_key_binding (
      AtspiAction* obj,
      gint i,
      GError** error
    )

#### Description [src]

Get the keybindings for the `i`-th action invocable on an object implementing `AtspiAction`, if any are defined. The keybindings string format is as follows: there are multiple parts to a keybinding string (typically 3). They are delimited with “;”. The first is the action’s keybinding which is usable if the object implementing the action is currently posted to the screen, e.g. if a menu is posted then these keybindings for the corresponding menu-items are available. The second keybinding substring is the full key sequence necessary to post the action’s widget and activate it, e.g. for a menu item such as “File->Open” it would both post the menu and activate the item. Thus the second keybinding string is available during the lifetime of the containing toplevel window as a whole, whereas the first keybinding string only works while the object implementing AtkAction is posted. The third (and optional) keybinding string is the “keyboard shortcut” which invokes the action without posting any menus. Meta-keys are indicated by the conventional strings “<Control>”, “<Alt>”, “<Shift>”, “<Mod2>”, etc. (we use the same string as `gtk_accelerator_name()` in gtk+-2.X.

#### Parameters

`i`

  Type: `gint`

  An integer indicating which action to query.

`error`

  Type: `GError **`

  The return location for a recoverable error.

  The argument can be `NULL`.
  If the return location is not `NULL`, then you must initialize it to a `NULL` `GError*`.
  The argument will left initialized to `NULL` by the method if there are no errors.
  In case of error, the argument will be set to a newly allocated `GError`; the caller will take ownership of the data, and be responsible for freeing it.

#### Return value

Type: `gchar*`

A UTF-8 string which can be parsed to determine the `i`-th invocable action’s keybindings.

The caller of the method takes ownership of the data, and is responsible for freeing it.
The value is a NUL terminated UTF-8 string.