xml/Accessibility_Action.xml

   1 <node name="/node" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
   2
   3 <tp:title>AT-SPI - Assistive Technology Service Provider Interface </tp:title>
   4 <tp:copyright>Copyright 2008 Novell, Inc.</tp:copyright>
   5 <tp:copyright>Copyright 2001 Sun Microsystems, Inc.</tp:copyright>
   6 <tp:license xmlns="http://www.w3.org/1999/xhtml">
   7   <p>This library is free software; you can redistribute it and/or
   8     modify it under the terms of the GNU Library General Public
   9     License as published by the Free Software Foundation; either
  10     version 2 of the License, or (at your option) any later version.</p>
  11
  12   <p>This library is distributed in the hope that it will be useful,
  13     but WITHOUT ANY WARRANTY; without even the implied warranty of
  14     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15     Library General Public License for more details.</p>
  16
  17   <p>You should have received a copy of the GNU Library General Public
  18     License along with this library; if not, write to the
  19     Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  20     Boston, MA 02111-1307, USA.</p>
  21 </tp:license>
  22 <interface name="org.freedesktop.accessibility.Action">
  23   <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
  24     <p>An interface through which a user-actionable user interface
  25       component can be manipulated.  Components which react to mouse or
  26       keyboard input from the user, (with the exception of pure text entry
  27       fields with no other function), should implement this interface.
  28       Typical actions include &quot;click&quot;, &quot;press&quot;, &quot;release&quot; (for instance for
  29       buttons), &quot;menu&quot; (for objects which have context menus invokable from
  30       mouse or keyboard), &quot;open&quot; for icons representing files folders, and others.</p>
  31   </tp:docstring>
  32   <tp:property name="nActions" type="i" access="read">
  33   <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
  34     <p>nActions: a \c long containing the number of actions this object supports.  </p>
  35   </tp:docstring>
  36   </tp:property>
  37   <method name="getDescription">
  38     <tp:docstring>
  39       getDescription:
  40     </tp:docstring>
  41     <arg direction="in" name="index" type="i">
  42     <tp:docstring>
  43       the index of the action for which a description is desired.Get the description of the specified action.  The description of an actionmay provide information about the result of action invocation, unlike theaction name.@see getName.
  44     </tp:docstring>
  45     </arg>
  46     <arg direction="out" type="s">
  47     <tp:docstring>
  48       a \c string containing the description of the specified action.
  49     </tp:docstring>
  50     </arg>
  51   </method>
  52   <method name="getName">
  53     <tp:docstring>
  54       getName:
  55     </tp:docstring>
  56     <arg direction="in" name="index" type="i">
  57     <tp:docstring>
  58       the index of the action whose name is requested.Get the name of the specified action.  Action names generally describethe user action, i.e. &quot;click&quot; or &quot;press&quot;, rather then the result of invoking the action.
  59     </tp:docstring>
  60     </arg>
  61     <arg direction="out" type="s">
  62     <tp:docstring>
  63       a \c string containing the name of the specified action.
  64     </tp:docstring>
  65     </arg>
  66   </method>
  67   <method name="doAction">
  68     <tp:docstring>
  69       doAction:
  70     </tp:docstring>
  71     <arg direction="in" name="index" type="i">
  72     <tp:docstring>
  73       the 0-based index of the action to perform.Causes the object to perform the specified action.
  74     </tp:docstring>
  75     </arg>
  76     <arg direction="out" type="b" tp:type="boolean">
  77     <tp:docstring>
  78       a \c boolean indicating success or failure.
  79     </tp:docstring>
  80     </arg>
  81   </method>
  82   <method name="getKeyBinding">
  83     <tp:docstring>
  84       getKeyBinding:
  85     </tp:docstring>
  86     <arg direction="in" name="index" type="i">
  87     <tp:docstring>
  88       the 0-based index of the action for which a key binding is requested.Get the key binding associated with a specific action.
  89     </tp:docstring>
  90     </arg>
  91     <arg direction="out" type="s">
  92     <tp:docstring>
  93       a \c string containing the key binding for the specified action,or an empty string (&quot;&quot;) if none exists.
  94     </tp:docstring>
  95     </arg>
  96   </method>
  97   <method name="unImplemented">
  98     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
  99       <p>\cond
 100         unImplemented:    </p>
 101
 102       <p>placeholders for future expansion.</p>
 103     </tp:docstring>
 104   </method>
 105   <method name="unImplemented2">
 106   </method>
 107   <method name="unImplemented3">
 108   </method>
 109   <method name="unImplemented4">
 110   </method>
 111 </interface>
 112 </node>