Method
AtspiActionget_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 aNULL
GError*
.The argument will be 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.