43
43
<div class="refsynopsisdiv">
44
44
<a name="AtkAction.synopsis"></a><h2>Synopsis</h2>
45
45
<pre class="synopsis"> <a class="link" href="AtkAction.html#AtkAction-struct" title="AtkAction">AtkAction</a>;
46
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="AtkAction.html#atk-action-do-action" title="atk_action_do_action ()">atk_action_do_action</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
47
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> i</code></em>);
48
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="AtkAction.html#atk-action-get-n-actions" title="atk_action_get_n_actions ()">atk_action_get_n_actions</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>);
49
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="AtkAction.html#atk-action-get-description" title="atk_action_get_description ()">atk_action_get_description</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
50
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> i</code></em>);
51
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="AtkAction.html#atk-action-get-name" title="atk_action_get_name ()">atk_action_get_name</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
52
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> i</code></em>);
53
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="AtkAction.html#atk-action-get-localized-name" title="atk_action_get_localized_name ()">atk_action_get_localized_name</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
54
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> i</code></em>);
55
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="AtkAction.html#atk-action-get-keybinding" title="atk_action_get_keybinding ()">atk_action_get_keybinding</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
56
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> i</code></em>);
57
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="AtkAction.html#atk-action-set-description" title="atk_action_set_description ()">atk_action_set_description</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
58
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> i</code></em>,
59
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *desc</code></em>);
46
<span class="returnvalue">gboolean</span> <a class="link" href="AtkAction.html#atk-action-do-action" title="atk_action_do_action ()">atk_action_do_action</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
47
<em class="parameter"><code><span class="type">gint</span> i</code></em>);
48
<span class="returnvalue">gint</span> <a class="link" href="AtkAction.html#atk-action-get-n-actions" title="atk_action_get_n_actions ()">atk_action_get_n_actions</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>);
49
const <span class="returnvalue">gchar</span> * <a class="link" href="AtkAction.html#atk-action-get-description" title="atk_action_get_description ()">atk_action_get_description</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
50
<em class="parameter"><code><span class="type">gint</span> i</code></em>);
51
const <span class="returnvalue">gchar</span> * <a class="link" href="AtkAction.html#atk-action-get-name" title="atk_action_get_name ()">atk_action_get_name</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
52
<em class="parameter"><code><span class="type">gint</span> i</code></em>);
53
const <span class="returnvalue">gchar</span> * <a class="link" href="AtkAction.html#atk-action-get-localized-name" title="atk_action_get_localized_name ()">atk_action_get_localized_name</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
54
<em class="parameter"><code><span class="type">gint</span> i</code></em>);
55
const <span class="returnvalue">gchar</span> * <a class="link" href="AtkAction.html#atk-action-get-keybinding" title="atk_action_get_keybinding ()">atk_action_get_keybinding</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
56
<em class="parameter"><code><span class="type">gint</span> i</code></em>);
57
<span class="returnvalue">gboolean</span> <a class="link" href="AtkAction.html#atk-action-set-description" title="atk_action_set_description ()">atk_action_set_description</a> (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
58
<em class="parameter"><code><span class="type">gint</span> i</code></em>,
59
<em class="parameter"><code>const <span class="type">gchar</span> *desc</code></em>);
62
62
<div class="refsect1">
117
117
<div class="refsect2">
118
118
<a name="atk-action-do-action"></a><h3>atk_action_do_action ()</h3>
119
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> atk_action_do_action (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
120
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> i</code></em>);</pre>
119
<pre class="programlisting"><span class="returnvalue">gboolean</span> atk_action_do_action (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
120
<em class="parameter"><code><span class="type">gint</span> i</code></em>);</pre>
122
122
Perform the specified action on the object.
168
168
<div class="refsect2">
169
169
<a name="atk-action-get-description"></a><h3>atk_action_get_description ()</h3>
170
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * atk_action_get_description (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
171
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> i</code></em>);</pre>
173
Returns a description of the specified action of the object.
170
<pre class="programlisting">const <span class="returnvalue">gchar</span> * atk_action_get_description (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
171
<em class="parameter"><code><span class="type">gint</span> i</code></em>);</pre>
175
172
<div class="variablelist"><table border="0">
176
173
<col align="left" valign="top">
179
176
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
180
<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> instance that implements AtkActionIface</td>
177
<td>a <span class="type">GObject</span> instance that implements AtkActionIface</td>
183
180
<td><p><span class="term"><em class="parameter"><code>i</code></em> :</span></p></td>
195
192
<div class="refsect2">
196
193
<a name="atk-action-get-name"></a><h3>atk_action_get_name ()</h3>
197
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * atk_action_get_name (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
198
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> i</code></em>);</pre>
200
Returns a non-localized string naming the specified action of the
201
object. This name is generally not descriptive of the end result
202
of the action, but instead names the 'interaction type' which the
203
object supports. By convention, the above strings should be used to
204
represent the actions which correspond to the common point-and-click
205
interaction techniques of the same name: i.e.
206
"click", "press", "release", "drag", "drop", "popup", etc.
207
The "popup" action should be used to pop up a context menu for the
208
object, if one exists.
211
For technical reasons, some toolkits cannot guarantee that the
212
reported action is actually 'bound' to a nontrivial user event;
213
i.e. the result of some actions via <a class="link" href="AtkAction.html#atk-action-do-action" title="atk_action_do_action ()"><code class="function">atk_action_do_action()</code></a> may be
194
<pre class="programlisting">const <span class="returnvalue">gchar</span> * atk_action_get_name (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
195
<em class="parameter"><code><span class="type">gint</span> i</code></em>);</pre>
216
196
<div class="variablelist"><table border="0">
217
197
<col align="left" valign="top">
220
200
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
221
<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> instance that implements AtkActionIface</td>
201
<td>a <span class="type">GObject</span> instance that implements AtkActionIface</td>
224
204
<td><p><span class="term"><em class="parameter"><code>i</code></em> :</span></p></td>
236
216
<div class="refsect2">
237
217
<a name="atk-action-get-localized-name"></a><h3>atk_action_get_localized_name ()</h3>
238
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * atk_action_get_localized_name (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
239
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> i</code></em>);</pre>
241
Returns the localized name of the specified action of the object.
218
<pre class="programlisting">const <span class="returnvalue">gchar</span> * atk_action_get_localized_name (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
219
<em class="parameter"><code><span class="type">gint</span> i</code></em>);</pre>
243
220
<div class="variablelist"><table border="0">
244
221
<col align="left" valign="top">
247
224
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
248
<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> instance that implements AtkActionIface</td>
225
<td>a <span class="type">GObject</span> instance that implements AtkActionIface</td>
251
228
<td><p><span class="term"><em class="parameter"><code>i</code></em> :</span></p></td>
263
240
<div class="refsect2">
264
241
<a name="atk-action-get-keybinding"></a><h3>atk_action_get_keybinding ()</h3>
265
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * atk_action_get_keybinding (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
266
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> i</code></em>);</pre>
268
Returns a keybinding associated with this action, if one exists.
269
The returned string is in the format "<a>;<b>;<c>"
270
(i.e. semicolon-delimited), where <a> is the keybinding which
271
activates the object if it is presently enabled onscreen,
272
<b> corresponds to the keybinding or sequence of keys
273
which invokes the action even if the relevant element is not
274
currently posted on screen (for instance, for a menu item it
275
posts the parent menus before invoking). The last token in the
276
above string, if non-empty, represents a keyboard shortcut which
277
invokes the same action without posting the component or its
278
enclosing menus or dialogs.
242
<pre class="programlisting">const <span class="returnvalue">gchar</span> * atk_action_get_keybinding (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
243
<em class="parameter"><code><span class="type">gint</span> i</code></em>);</pre>
245
Gets the keybinding which can be used to activate this action, if one
246
exists. The string returned should contain localized, human-readable,
247
key sequences as they would appear when displayed on screen. It must
248
be in the format "mnemonic;sequence;shortcut".
252
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
253
<li class="listitem"><p>The mnemonic key activates the object if it is presently enabled onscreen.
254
This typically corresponds to the underlined letter within the widget.
255
Example: "n" in a traditional "New..." menu item or the "a" in "Apply" for
257
<li class="listitem"><p>The sequence is the full list of keys which invoke the action even if the
258
relevant element is not currently shown on screen. For instance, for a menu
259
item the sequence is the keybindings used to open the parent menus before
260
invoking. The sequence string is colon-delimited. Example: "Alt+F:N" in a
261
traditional "New..." menu item.</p></li>
262
<li class="listitem"><p>The shortcut, if it exists, will invoke the same action without showing
263
the component or its enclosing menus or dialogs. Example: "Ctrl+N" in a
264
traditional "New..." menu item.</p></li>
269
Example: For a traditional "New..." menu item, the expected return value
270
would be: "N;Alt+F:N;Ctrl+N" for the English locale and "N;Alt+D:N;Strg+N"
271
for the German locale. If, hypothetically, this menu item lacked a mnemonic,
272
it would be represented by ";;Ctrl+N" and ";;Strg+N" respectively.
280
274
<div class="variablelist"><table border="0">
281
275
<col align="left" valign="top">
284
278
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
285
<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> instance that implements AtkActionIface</td>
279
<td>a <span class="type">GObject</span> instance that implements AtkActionIface</td>
288
282
<td><p><span class="term"><em class="parameter"><code>i</code></em> :</span></p></td>
300
294
<div class="refsect2">
301
295
<a name="atk-action-set-description"></a><h3>atk_action_set_description ()</h3>
302
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> atk_action_set_description (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
303
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> i</code></em>,
304
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *desc</code></em>);</pre>
296
<pre class="programlisting"><span class="returnvalue">gboolean</span> atk_action_set_description (<em class="parameter"><code><a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> *action</code></em>,
297
<em class="parameter"><code><span class="type">gint</span> i</code></em>,
298
<em class="parameter"><code>const <span class="type">gchar</span> *desc</code></em>);</pre>
306
300
Sets a description of the specified action of the object.