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 <!-- ##### STRUCT AtkAction ##### -->
  45 <para>
  46 The AtkAction structure does not contain any fields.
  47 </para>
  48
  49
  50 <!-- ##### FUNCTION atk_action_do_action ##### -->
  51 <para>
  52
  53 </para>
  54
  55 @action:
  56 @i:
  57 @Returns:
  58
  59
  60 <!-- ##### FUNCTION atk_action_get_n_actions ##### -->
  61 <para>
  62
  63 </para>
  64
  65 @action:
  66 @Returns:
  67
  68
  69 <!-- ##### FUNCTION atk_action_get_description ##### -->
  70 <para>
  71
  72 </para>
  73
  74 @action:
  75 @i:
  76 @Returns:
  77
  78
  79 <!-- ##### FUNCTION atk_action_get_name ##### -->
  80 <para>
  81
  82 </para>
  83
  84 @action:
  85 @i:
  86 @Returns:
  87
  88
  89 <!-- ##### FUNCTION atk_action_get_localized_name ##### -->
  90 <para>
  91
  92 </para>
  93
  94 @action:
  95 @i:
  96 @Returns:
  97
  98
  99 <!-- ##### FUNCTION atk_action_get_keybinding ##### -->
 100 <para>
 101
 102 </para>
 103
 104 @action:
 105 @i:
 106 @Returns:
 107
 108
 109 <!-- ##### FUNCTION atk_action_set_description ##### -->
 110 <para>
 111
 112 </para>
 113
 114 @action:
 115 @i:
 116 @desc:
 117 @Returns:
 118
 119