AtkAction: AtkAction

Description Methods and Functions Hierarchy Implementations Detailed Description Structures Author(s) References

Description

The ATK interface provided by UI components which the user can activate/interact with,

Methods and Functions

atkActionDoAction(object, i)
atkActionGetNActions(object)
atkActionGetDescription(object, i)
atkActionGetName(object, i)
atkActionGetLocalizedName(object, i)
atkActionGetKeybinding(object, i)
atkActionSetDescription(object, i, desc)

Hierarchy

1
2
GInterface
   +----AtkAction

Implementations

AtkAction is implemented by AtkHyperlink and AtkNoOpObject.

Detailed Description

AtkAction should be implemented by instances of AtkObject classes with which the user can interact directly, i.e. buttons, checkboxes, scrollbars, e.g. components which are not "passive" providers of UI information.

Exceptions: when the user interaction is already covered by another appropriate interface such as AtkEditableText (insert/delete test, etc.) or AtkValue (set value) then these actions should not be exposed by AtkAction as well.

Also note that the AtkAction API is limited in that parameters may not be passed to the object being activated; thus the action must be self-contained and specifiable via only a single "verb". Concrete examples include "press", "release", "click" for buttons, "drag" (meaning initiate drag) and "drop" for drag sources and drop targets, etc.

Though most UI interactions on components should be invocable via keyboard as well as mouse, there will generally be a close mapping between "mouse actions" that are possible on a component and the AtkActions. Where mouse and keyboard actions are redundant in effect, AtkAction should expose only one action rather than exposing redundant actions if possible. By convention we have been using "mouse centric" terminology for AtkAction names.

Structures

AtkAction

The AtkAction structure does not contain any fields.

Author(s)

Derived by RGtkGen from GTK+ documentation

References

https://developer.gnome.org/atk/stable/AtkAction.html


RGtk2 documentation built on Oct. 14, 2021, 5:08 p.m.

Related to AtkAction in RGtk2...