![]() |
![]() |
![]() |
AT-SPI C Bindings Reference Manual | ![]() |
---|---|---|---|---|
AccessibleAction InterfaceAccessibleAction Interface — The interface implemented by interface elements which are 'actionable' by the user. |
void AccessibleAction_ref (AccessibleAction *obj); void AccessibleAction_unref (AccessibleAction *obj); long AccessibleAction_getNActions (AccessibleAction *obj); SPIBoolean AccessibleAction_doAction (AccessibleAction *obj, long int i); char* AccessibleAction_getKeyBinding (AccessibleAction *obj, long int i); char* AccessibleAction_getName (AccessibleAction *obj, long int i); char* AccessibleAction_getDescription (AccessibleAction *obj, long int i);
The Action interface is implemented by objects with which the user may interact using common graphical-user-interface metaphors such as "click", "toggle", "activate", and other gestures which are usually invoked via interaction with the system pointer or keyboard. The Action interface allows clients and/or assistive technologies to expose these actions to the end user for invocation via alternative mechanisms, and to inform the end user or assistive technology client that the implementing Accessible object is reactive to user input.
void AccessibleAction_ref (AccessibleAction *obj);
Increment the reference count for an AccessibleAction.
obj : |
a pointer to the AccessibleAction on which to operate. |
void AccessibleAction_unref (AccessibleAction *obj);
Decrement the reference count for an AccessibleAction.
obj : |
a pointer to the AccessibleAction on which to operate. |
long AccessibleAction_getNActions (AccessibleAction *obj);
Get the number of actions invokable on an AccessibleAction implementor.
obj : |
a pointer to the AccessibleAction to query. |
Returns : | a long integer indicatin the number of invokable actions. |
SPIBoolean AccessibleAction_doAction (AccessibleAction *obj, long int i);
Invoke the action indicated by index.
char* AccessibleAction_getKeyBinding (AccessibleAction *obj, long int i);
Get the keybindings for the i
-th action invokable on an
object implementing AccessibleAction, 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.
obj : |
a pointer to the AccessibleAction implementor to query. |
i : |
a long integer indicating which action to query. |
Returns : | a UTF-8 string which can be parsed to determine the i -th
invokable action's keybindings.
|
char* AccessibleAction_getName (AccessibleAction *obj, long int i);
Get the name of the 'i
-th' action invokable on an
object implementing AccessibleAction.
obj : |
a pointer to the AccessibleAction implementor to query. |
i : |
a long integer indicating which action to query. |
Returns : | the 'event type' name of the action, as a UTF-8 string. |
char* AccessibleAction_getDescription (AccessibleAction *obj, long int i);
Get the description of 'i
-th' action invokable on an
object implementing AccessibleAction.
obj : |
a pointer to the AccessibleAction implementor to query. |
i : |
a long integer indicating which action to query. |
Returns : | a UTF-8 string describing the 'i -th' invokable action.
|