docs/tmpl/atkaction.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 AtkAction
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 The ATK interface provided by UI components which the user can
   6 activate/interact with,
   7
   8 <!-- ##### SECTION Long_Description ##### -->
   9 <para>
  10 #AtkAction should be implemented by instances of #AtkObject classes with
  11 which the user can interact directly, i.e. buttons, checkboxes,
  12 scrollbars,  e.g. components which are not "passive"
  13 providers of UI information.
  14 </para>
  15 <para>
  16 Exceptions: when the user interaction is already covered by
  17 another appropriate interface such as #AtkEditableText (insert/delete
  18 test, etc.) or #AtkValue (set value) then these actions should not be
  19 exposed by #AtkAction as well.
  20 </para>
  21 <para>
  22 Also note that the #AtkAction API is limited in that parameters may not
  23 be passed to the object being activated; thus the action must be
  24 self-contained and specifiable via only a single "verb".  Concrete
  25 examples include "press", "release", "click" for buttons, "drag"
  26 (meaning initiate drag) and "drop" for drag sources and drop targets,
  27 etc.
  28 </para>
  29 <para>
  30 Though most UI interactions on components should be invocable via
  31 keyboard as well as mouse, there will generally be a close mapping
  32 between "mouse actions" that are possible on a component and the
  33 AtkActions.  Where mouse and keyboard actions are redundant in effect,
  34 #AtkAction should expose only one action rather than exposing redundant
  35 actions if possible.  By convention we have been using "mouse centric"
  36 terminology for #AtkAction names.
  37 </para>
  38
  39 <!-- ##### SECTION See_Also ##### -->
  40 <para>
  41
  42 </para>
  43
  44 <!-- ##### SECTION Stability_Level ##### -->
  45
  46
  47 <!-- ##### STRUCT AtkAction ##### -->
  48 <para>
  49 The AtkAction structure does not contain any fields.
  50 </para>
  51
  52
  53 <!-- ##### FUNCTION atk_action_do_action ##### -->
  54 <para>
  55
  56 </para>
  57
  58 @action:
  59 @i:
  60 @Returns:
  61
  62
  63 <!-- ##### FUNCTION atk_action_get_n_actions ##### -->
  64 <para>
  65
  66 </para>
  67
  68 @action:
  69 @Returns:
  70
  71
  72 <!-- ##### FUNCTION atk_action_get_description ##### -->
  73 <para>
  74
  75 </para>
  76
  77 @action:
  78 @i:
  79 @Returns:
  80
  81
  82 <!-- ##### FUNCTION atk_action_get_name ##### -->
  83 <para>
  84
  85 </para>
  86
  87 @action:
  88 @i:
  89 @Returns:
  90
  91
  92 <!-- ##### FUNCTION atk_action_get_localized_name ##### -->
  93 <para>
  94
  95 </para>
  96
  97 @action:
  98 @i:
  99 @Returns:
 100
 101
 102 <!-- ##### FUNCTION atk_action_get_keybinding ##### -->
 103 <para>
 104
 105 </para>
 106
 107 @action:
 108 @i:
 109 @Returns:
 110
 111
 112 <!-- ##### FUNCTION atk_action_set_description ##### -->
 113 <para>
 114
 115 </para>
 116
 117 @action:
 118 @i:
 119 @desc:
 120 @Returns:
 121
 122