atk 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (95) hide show
  1. checksums.yaml +7 -0
  2. data/README +2 -2
  3. data/Rakefile +2 -1
  4. data/ext/atk/extconf.rb +1 -1
  5. data/ext/atk/rbatkcomponent.c +0 -4
  6. data/ext/atk/rbatkdocument.c +0 -4
  7. data/ext/atk/rbatkrelation.c +0 -4
  8. data/ext/atk/rbatkrelationset.c +0 -4
  9. data/ext/atk/rbatkutil.c +0 -4
  10. data/lib/1.9/atk.so +0 -0
  11. data/lib/2.0/atk.so +0 -0
  12. data/vendor/local/bin/libatk-1.0-0.dll +0 -0
  13. data/vendor/local/include/atk-1.0/atk/atk-enum-types.h +2 -0
  14. data/vendor/local/include/atk-1.0/atk/atkaction.h +0 -1
  15. data/vendor/local/include/atk-1.0/atk/atkcomponent.h +38 -2
  16. data/vendor/local/include/atk-1.0/atk/atkdocument.h +7 -7
  17. data/vendor/local/include/atk-1.0/atk/atkeditabletext.h +0 -3
  18. data/vendor/local/include/atk-1.0/atk/atkhyperlink.h +1 -2
  19. data/vendor/local/include/atk-1.0/atk/atkhyperlinkimpl.h +10 -19
  20. data/vendor/local/include/atk-1.0/atk/atkhypertext.h +0 -4
  21. data/vendor/local/include/atk-1.0/atk/atkimage.h +0 -3
  22. data/vendor/local/include/atk-1.0/atk/atkobject.h +40 -78
  23. data/vendor/local/include/atk-1.0/atk/atkregistry.h +15 -0
  24. data/vendor/local/include/atk-1.0/atk/atkselection.h +0 -3
  25. data/vendor/local/include/atk-1.0/atk/atktable.h +0 -5
  26. data/vendor/local/include/atk-1.0/atk/atktext.h +72 -11
  27. data/vendor/local/include/atk-1.0/atk/atkutil.h +4 -0
  28. data/vendor/local/include/atk-1.0/atk/atkvalue.h +0 -1
  29. data/vendor/local/include/atk-1.0/atk/atkversion.h +2 -2
  30. data/vendor/local/include/atk-1.0/atk/atkwindow.h +0 -2
  31. data/vendor/local/lib/atk-1.0.def +2 -0
  32. data/vendor/local/lib/girepository-1.0/Atk-1.0.typelib +0 -0
  33. data/vendor/local/lib/libatk-1.0.dll.a +0 -0
  34. data/vendor/local/lib/libatk-1.0.la +2 -2
  35. data/vendor/local/lib/pkgconfig/atk.pc +1 -1
  36. data/vendor/local/share/gir-1.0/Atk-1.0.gir +2497 -2086
  37. data/vendor/local/share/gtk-doc/html/atk/AtkAction.html +80 -43
  38. data/vendor/local/share/gtk-doc/html/atk/AtkComponent.html +246 -33
  39. data/vendor/local/share/gtk-doc/html/atk/AtkDocument.html +94 -39
  40. data/vendor/local/share/gtk-doc/html/atk/AtkEditableText.html +22 -27
  41. data/vendor/local/share/gtk-doc/html/atk/AtkGObjectAccessible.html +17 -21
  42. data/vendor/local/share/gtk-doc/html/atk/AtkHyperlink.html +34 -25
  43. data/vendor/local/share/gtk-doc/html/atk/AtkHypertext.html +25 -30
  44. data/vendor/local/share/gtk-doc/html/atk/AtkImage.html +26 -26
  45. data/vendor/local/share/gtk-doc/html/atk/AtkNoOpObject.html +15 -18
  46. data/vendor/local/share/gtk-doc/html/atk/AtkNoOpObjectFactory.html +14 -18
  47. data/vendor/local/share/gtk-doc/html/atk/AtkObject.html +119 -77
  48. data/vendor/local/share/gtk-doc/html/atk/AtkObjectFactory.html +15 -25
  49. data/vendor/local/share/gtk-doc/html/atk/AtkRegistry.html +12 -22
  50. data/vendor/local/share/gtk-doc/html/atk/AtkRelation.html +17 -20
  51. data/vendor/local/share/gtk-doc/html/atk/AtkRelationSet.html +21 -22
  52. data/vendor/local/share/gtk-doc/html/atk/AtkSelection.html +24 -33
  53. data/vendor/local/share/gtk-doc/html/atk/AtkStateSet.html +13 -16
  54. data/vendor/local/share/gtk-doc/html/atk/AtkStreamableContent.html +28 -29
  55. data/vendor/local/share/gtk-doc/html/atk/AtkTable.html +47 -54
  56. data/vendor/local/share/gtk-doc/html/atk/AtkText.html +451 -191
  57. data/vendor/local/share/gtk-doc/html/atk/AtkUtil.html +43 -20
  58. data/vendor/local/share/gtk-doc/html/atk/AtkValue.html +21 -24
  59. data/vendor/local/share/gtk-doc/html/atk/AtkWindow.html +12 -15
  60. data/vendor/local/share/gtk-doc/html/atk/api-index-1-12.html +8 -8
  61. data/vendor/local/share/gtk-doc/html/atk/api-index-1-13.html +8 -8
  62. data/vendor/local/share/gtk-doc/html/atk/api-index-1-18.html +8 -8
  63. data/vendor/local/share/gtk-doc/html/atk/api-index-1-20.html +8 -8
  64. data/vendor/local/share/gtk-doc/html/atk/api-index-1-22.html +8 -8
  65. data/vendor/local/share/gtk-doc/html/atk/api-index-1-24.html +8 -8
  66. data/vendor/local/share/gtk-doc/html/atk/api-index-1-26.html +8 -8
  67. data/vendor/local/share/gtk-doc/html/atk/api-index-1-28.html +8 -8
  68. data/vendor/local/share/gtk-doc/html/atk/api-index-1-3.html +8 -8
  69. data/vendor/local/share/gtk-doc/html/atk/api-index-1-30.html +10 -8
  70. data/vendor/local/share/gtk-doc/html/atk/api-index-1-32.html +8 -8
  71. data/vendor/local/share/gtk-doc/html/atk/api-index-1-4.html +8 -8
  72. data/vendor/local/share/gtk-doc/html/atk/api-index-1-6.html +8 -8
  73. data/vendor/local/share/gtk-doc/html/atk/api-index-deprecated.html +34 -8
  74. data/vendor/local/share/gtk-doc/html/atk/api-index-full.html +26 -10
  75. data/vendor/local/share/gtk-doc/html/atk/atk-AtkHyperlinkImpl.html +50 -37
  76. data/vendor/local/share/gtk-doc/html/atk/atk-AtkPlug.html +34 -15
  77. data/vendor/local/share/gtk-doc/html/atk/atk-AtkSocket.html +51 -22
  78. data/vendor/local/share/gtk-doc/html/atk/atk-AtkState.html +14 -17
  79. data/vendor/local/share/gtk-doc/html/atk/atk-Versioning-Utilities.html +14 -17
  80. data/vendor/local/share/gtk-doc/html/atk/atk.devhelp2 +27 -14
  81. data/vendor/local/share/gtk-doc/html/atk/atk.html +114 -15
  82. data/vendor/local/share/gtk-doc/html/atk/home.png +0 -0
  83. data/vendor/local/share/gtk-doc/html/atk/index.html +43 -35
  84. data/vendor/local/share/gtk-doc/html/atk/index.sgml +16 -7
  85. data/vendor/local/share/gtk-doc/html/atk/left-insensitive.png +0 -0
  86. data/vendor/local/share/gtk-doc/html/atk/left.png +0 -0
  87. data/vendor/local/share/gtk-doc/html/atk/right-insensitive.png +0 -0
  88. data/vendor/local/share/gtk-doc/html/atk/right.png +0 -0
  89. data/vendor/local/share/gtk-doc/html/atk/style.css +71 -16
  90. data/vendor/local/share/gtk-doc/html/atk/up-insensitive.png +0 -0
  91. data/vendor/local/share/gtk-doc/html/atk/up.png +0 -0
  92. data/vendor/local/share/gtk-doc/html/atk/utilities.html +33 -0
  93. data/vendor/local/share/locale/an/LC_MESSAGES/atk10.mo +0 -0
  94. data/vendor/local/share/locale/ja/LC_MESSAGES/atk10.mo +0 -0
  95. metadata +15 -14
data/vendor/local/share/gtk-doc/html/atk/AtkAction.html CHANGED
@@ -8,41 +8,39 @@
8
8
  <link rel="up" href="atk.html" title="ATK Library">
9
9
  <link rel="prev" href="atk.html" title="ATK Library">
10
10
  <link rel="next" href="AtkComponent.html" title="AtkComponent">
11
- <meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
12
12
  <link rel="stylesheet" href="style.css" type="text/css">
13
13
  </head>
14
14
  <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="atk.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="atk.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">ATK - Accessibility Toolkit</th>
21
- <td><a accesskey="n" href="AtkComponent.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
- </tr>
23
- <tr><td colspan="5" class="shortcuts">
24
- <a href="#AtkAction.synopsis" class="shortcut">Top</a>
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
+ <td width="100%" align="left">
17
+ <a href="#" class="shortcut">Top</a>
25
18
   | 
26
19
  <a href="#AtkAction.description" class="shortcut">Description</a>
27
20
   | 
28
21
  <a href="#AtkAction.object-hierarchy" class="shortcut">Object Hierarchy</a>
29
22
   | 
30
23
  <a href="#AtkAction.implementations" class="shortcut">Known Implementations</a>
31
- </td></tr>
32
- </table>
24
+ </td>
25
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
26
+ <td><a accesskey="u" href="atk.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
27
+ <td><a accesskey="p" href="atk.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
28
+ <td><a accesskey="n" href="AtkComponent.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
29
+ </tr></table>
33
30
  <div class="refentry">
34
31
  <a name="AtkAction"></a><div class="titlepage"></div>
35
32
  <div class="refnamediv"><table width="100%"><tr>
36
33
  <td valign="top">
37
34
  <h2><span class="refentrytitle"><a name="AtkAction.top_of_page"></a>AtkAction</span></h2>
38
- <p>AtkAction — The ATK interface provided by UI components which the user can
39
- activate/interact with,</p>
35
+ <p>AtkAction — The ATK interface provided by UI components
36
+ which the user can activate/interact with.</p>
40
37
  </td>
41
38
  <td valign="top" align="right"></td>
42
39
  </tr></table></div>
43
40
  <div class="refsynopsisdiv">
44
41
  <a name="AtkAction.synopsis"></a><h2>Synopsis</h2>
45
42
  <pre class="synopsis"> <a class="link" href="AtkAction.html#AtkAction-struct" title="AtkAction">AtkAction</a>;
43
+ struct <a class="link" href="AtkAction.html#AtkActionIface" title="struct AtkActionIface">AtkActionIface</a>;
46
44
  <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
45
  <em class="parameter"><code><span class="type">gint</span> i</code></em>);
48
46
  <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>);
@@ -75,33 +73,25 @@ AtkAction is implemented by
75
73
  <div class="refsect1">
76
74
  <a name="AtkAction.description"></a><h2>Description</h2>
77
75
  <p>
78
- <a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> should be implemented by instances of <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> classes with
79
- which the user can interact directly, i.e. buttons, checkboxes,
80
- scrollbars, e.g. components which are not "passive"
76
+ <a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> should be implemented by instances of <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> classes
77
+ with which the user can interact directly, i.e. buttons,
78
+ checkboxes, scrollbars, e.g. components which are not "passive"
81
79
  providers of UI information.
82
80
  </p>
83
81
  <p>
84
- Exceptions: when the user interaction is already covered by
85
- another appropriate interface such as <a class="link" href="AtkEditableText.html" title="AtkEditableText"><span class="type">AtkEditableText</span></a> (insert/delete
86
- text, etc.) or <a class="link" href="AtkValue.html" title="AtkValue"><span class="type">AtkValue</span></a> (set value) then these actions should not be
82
+ Exceptions: when the user interaction is already covered by another
83
+ appropriate interface such as <a class="link" href="AtkEditableText.html" title="AtkEditableText"><span class="type">AtkEditableText</span></a> (insert/delete text,
84
+ etc.) or <a class="link" href="AtkValue.html" title="AtkValue"><span class="type">AtkValue</span></a> (set value) then these actions should not be
87
85
  exposed by <a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> as well.
88
86
  </p>
89
87
  <p>
90
- Also note that the <a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> API is limited in that parameters may not
91
- be passed to the object being activated; thus the action must be
92
- self-contained and specifiable via only a single "verb". Concrete
93
- examples include "press", "release", "click" for buttons, "drag"
94
- (meaning initiate drag) and "drop" for drag sources and drop targets,
95
- etc.
96
- </p>
97
- <p>
98
88
  Though most UI interactions on components should be invocable via
99
89
  keyboard as well as mouse, there will generally be a close mapping
100
90
  between "mouse actions" that are possible on a component and the
101
- AtkActions. Where mouse and keyboard actions are redundant in effect,
102
- <a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> should expose only one action rather than exposing redundant
103
- actions if possible. By convention we have been using "mouse centric"
104
- terminology for <a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> names.
91
+ AtkActions. Where mouse and keyboard actions are redundant in
92
+ effect, <a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> should expose only one action rather than
93
+ exposing redundant actions if possible. By convention we have been
94
+ using "mouse centric" terminology for <a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a> names.
105
95
  </p>
106
96
  </div>
107
97
  <div class="refsect1">
@@ -110,7 +100,31 @@ terminology for <a class="link" href="AtkAction.html" title="AtkAction"><span cl
110
100
  <a name="AtkAction-struct"></a><h3>AtkAction</h3>
111
101
  <pre class="programlisting">typedef struct _AtkAction AtkAction;</pre>
112
102
  <p>
113
- The AtkAction structure does not contain any fields.
103
+ </p>
104
+ </div>
105
+ <hr>
106
+ <div class="refsect2">
107
+ <a name="AtkActionIface"></a><h3>struct AtkActionIface</h3>
108
+ <pre class="programlisting">struct AtkActionIface {
109
+ GTypeInterface parent;
110
+
111
+ gboolean (*do_action) (AtkAction *action,
112
+ gint i);
113
+ gint (*get_n_actions) (AtkAction *action);
114
+ const gchar* (*get_description) (AtkAction *action,
115
+ gint i);
116
+ const gchar* (*get_name) (AtkAction *action,
117
+ gint i);
118
+ const gchar* (*get_keybinding) (AtkAction *action,
119
+ gint i);
120
+ gboolean (*set_description) (AtkAction *action,
121
+ gint i,
122
+ const gchar *desc);
123
+ const gchar* (*get_localized_name)(AtkAction *action,
124
+ gint i);
125
+ };
126
+ </pre>
127
+ <p>
114
128
  </p>
115
129
  </div>
116
130
  <hr>
@@ -169,6 +183,9 @@ implement this interface.</td>
169
183
  <a name="atk-action-get-description"></a><h3>atk_action_get_description ()</h3>
170
184
  <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
185
  <em class="parameter"><code><span class="type">gint</span> i</code></em>);</pre>
186
+ <p>
187
+ Returns a description of the specified action of the object.
188
+ </p>
172
189
  <div class="variablelist"><table border="0">
173
190
  <col align="left" valign="top">
174
191
  <tbody>
@@ -182,8 +199,8 @@ implement this interface.</td>
182
199
  </tr>
183
200
  <tr>
184
201
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
185
- <td>a description string, or <code class="literal">NULL</code>
186
- if <em class="parameter"><code>action</code></em> does not implement this interface.</td>
202
+ <td>a description string, or <code class="literal">NULL</code> if <em class="parameter"><code>action</code></em> does not
203
+ implement this interface.</td>
187
204
  </tr>
188
205
  </tbody>
189
206
  </table></div>
@@ -193,6 +210,23 @@ if <em class="parameter"><code>action</code></em> does not implement this interf
193
210
  <a name="atk-action-get-name"></a><h3>atk_action_get_name ()</h3>
194
211
  <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
212
  <em class="parameter"><code><span class="type">gint</span> i</code></em>);</pre>
213
+ <p>
214
+ Returns a non-localized string naming the specified action of the
215
+ object. This name is generally not descriptive of the end result
216
+ of the action, but instead names the 'interaction type' which the
217
+ object supports. By convention, the above strings should be used to
218
+ represent the actions which correspond to the common point-and-click
219
+ interaction techniques of the same name: i.e.
220
+ "click", "press", "release", "drag", "drop", "popup", etc.
221
+ The "popup" action should be used to pop up a context menu for the
222
+ object, if one exists.
223
+ </p>
224
+ <p>
225
+ For technical reasons, some toolkits cannot guarantee that the
226
+ reported action is actually 'bound' to a nontrivial user event;
227
+ 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
228
+ NIL.
229
+ </p>
196
230
  <div class="variablelist"><table border="0">
197
231
  <col align="left" valign="top">
198
232
  <tbody>
@@ -206,8 +240,8 @@ if <em class="parameter"><code>action</code></em> does not implement this interf
206
240
  </tr>
207
241
  <tr>
208
242
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
209
- <td>a name string, or <code class="literal">NULL</code>
210
- if <em class="parameter"><code>action</code></em> does not implement this interface.</td>
243
+ <td>a name string, or <code class="literal">NULL</code> if <em class="parameter"><code>action</code></em> does not implement this
244
+ interface.</td>
211
245
  </tr>
212
246
  </tbody>
213
247
  </table></div>
@@ -217,6 +251,9 @@ if <em class="parameter"><code>action</code></em> does not implement this interf
217
251
  <a name="atk-action-get-localized-name"></a><h3>atk_action_get_localized_name ()</h3>
218
252
  <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
253
  <em class="parameter"><code><span class="type">gint</span> i</code></em>);</pre>
254
+ <p>
255
+ Returns the localized name of the specified action of the object.
256
+ </p>
220
257
  <div class="variablelist"><table border="0">
221
258
  <col align="left" valign="top">
222
259
  <tbody>
@@ -230,8 +267,8 @@ if <em class="parameter"><code>action</code></em> does not implement this interf
230
267
  </tr>
231
268
  <tr>
232
269
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
233
- <td>a name string, or <code class="literal">NULL</code>
234
- if <em class="parameter"><code>action</code></em> does not implement this interface.</td>
270
+ <td>a name string, or <code class="literal">NULL</code> if <em class="parameter"><code>action</code></em> does not implement this
271
+ interface.</td>
235
272
  </tr>
236
273
  </tbody>
237
274
  </table></div>
@@ -284,8 +321,8 @@ it would be represented by ";;Ctrl+N" and ";;Strg+N" respectively.
284
321
  </tr>
285
322
  <tr>
286
323
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
287
- <td>the keybinding which can be used to activate this action, or <code class="literal">NULL</code>
288
- if there is no keybinding for this action.</td>
324
+ <td>the keybinding which can be used to activate this action,
325
+ or <code class="literal">NULL</code> if there is no keybinding for this action.</td>
289
326
  </tr>
290
327
  </tbody>
291
328
  </table></div>
@@ -325,6 +362,6 @@ Sets a description of the specified action of the object.
325
362
  </div>
326
363
  <div class="footer">
327
364
  <hr>
328
- Generated by GTK-Doc V1.18.1</div>
365
+ Generated by GTK-Doc V1.19.1</div>
329
366
  </body>
330
367
  </html>
data/vendor/local/share/gtk-doc/html/atk/AtkComponent.html CHANGED
@@ -8,20 +8,13 @@
8
8
  <link rel="up" href="atk.html" title="ATK Library">
9
9
  <link rel="prev" href="AtkAction.html" title="AtkAction">
10
10
  <link rel="next" href="AtkDocument.html" title="AtkDocument">
11
- <meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
12
12
  <link rel="stylesheet" href="style.css" type="text/css">
13
13
  </head>
14
14
  <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="AtkAction.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="atk.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">ATK - Accessibility Toolkit</th>
21
- <td><a accesskey="n" href="AtkDocument.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
- </tr>
23
- <tr><td colspan="5" class="shortcuts">
24
- <a href="#AtkComponent.synopsis" class="shortcut">Top</a>
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
+ <td width="100%" align="left">
17
+ <a href="#" class="shortcut">Top</a>
25
18
   | 
26
19
  <a href="#AtkComponent.description" class="shortcut">Description</a>
27
20
   | 
@@ -30,23 +23,32 @@
30
23
  <a href="#AtkComponent.implementations" class="shortcut">Known Implementations</a>
31
24
   | 
32
25
  <a href="#AtkComponent.signals" class="shortcut">Signals</a>
33
- </td></tr>
34
- </table>
26
+ </td>
27
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
28
+ <td><a accesskey="u" href="atk.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
29
+ <td><a accesskey="p" href="AtkAction.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
30
+ <td><a accesskey="n" href="AtkDocument.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
31
+ </tr></table>
35
32
  <div class="refentry">
36
33
  <a name="AtkComponent"></a><div class="titlepage"></div>
37
34
  <div class="refnamediv"><table width="100%"><tr>
38
35
  <td valign="top">
39
36
  <h2><span class="refentrytitle"><a name="AtkComponent.top_of_page"></a>AtkComponent</span></h2>
40
- <p>AtkComponent — The ATK interface provided by UI components which occupy a physical area on
41
- the screen.</p>
37
+ <p>AtkComponent — The ATK interface provided by UI components
38
+ which occupy a physical area on the screen.
39
+ which the user can activate/interact with.</p>
42
40
  </td>
43
41
  <td valign="top" align="right"></td>
44
42
  </tr></table></div>
45
43
  <div class="refsynopsisdiv">
46
44
  <a name="AtkComponent.synopsis"></a><h2>Synopsis</h2>
47
45
  <pre class="synopsis"> <a class="link" href="AtkComponent.html#AtkComponent-struct" title="AtkComponent">AtkComponent</a>;
46
+ struct <a class="link" href="AtkComponent.html#AtkComponentIface" title="struct AtkComponentIface">AtkComponentIface</a>;
47
+ <span class="returnvalue">void</span> (<a class="link" href="AtkComponent.html#AtkFocusHandler" title="AtkFocusHandler ()">*AtkFocusHandler</a>) (<em class="parameter"><code><a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> *object</code></em>,
48
+ <em class="parameter"><code><span class="type">gboolean</span> focus_in</code></em>);
49
+ struct <a class="link" href="AtkComponent.html#AtkRectangle" title="struct AtkRectangle">AtkRectangle</a>;
48
50
  <span class="returnvalue">guint</span> <a class="link" href="AtkComponent.html#atk-component-add-focus-handler" title="atk_component_add_focus_handler ()">atk_component_add_focus_handler</a> (<em class="parameter"><code><a class="link" href="AtkComponent.html" title="AtkComponent"><span class="type">AtkComponent</span></a> *component</code></em>,
49
- <em class="parameter"><code><span class="type">AtkFocusHandler</span> handler</code></em>);
51
+ <em class="parameter"><code><a class="link" href="AtkComponent.html#AtkFocusHandler" title="AtkFocusHandler ()"><span class="type">AtkFocusHandler</span></a> handler</code></em>);
50
52
  <span class="returnvalue">gboolean</span> <a class="link" href="AtkComponent.html#atk-component-contains" title="atk_component_contains ()">atk_component_contains</a> (<em class="parameter"><code><a class="link" href="AtkComponent.html" title="AtkComponent"><span class="type">AtkComponent</span></a> *component</code></em>,
51
53
  <em class="parameter"><code><span class="type">gint</span> x</code></em>,
52
54
  <em class="parameter"><code><span class="type">gint</span> y</code></em>,
@@ -112,17 +114,17 @@ AtkComponent is implemented by
112
114
  <div class="refsect1">
113
115
  <a name="AtkComponent.description"></a><h2>Description</h2>
114
116
  <p>
115
- <a class="link" href="AtkComponent.html" title="AtkComponent"><span class="type">AtkComponent</span></a> should be implemented by most if not all UI elements with
116
- an actual on-screen presence, i.e. components which can be said to have
117
- a screen-coordinate bounding box. Virtually all widgets will need to
118
- have <a class="link" href="AtkComponent.html" title="AtkComponent"><span class="type">AtkComponent</span></a> implementations provided for their corresponding
119
- <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> class. In short, only UI elements which are *not* GUI
120
- elements will omit this ATK interface.
117
+ <a class="link" href="AtkComponent.html" title="AtkComponent"><span class="type">AtkComponent</span></a> should be implemented by most if not all UI elements
118
+ with an actual on-screen presence, i.e. components which can be
119
+ said to have a screen-coordinate bounding box. Virtually all
120
+ widgets will need to have <a class="link" href="AtkComponent.html" title="AtkComponent"><span class="type">AtkComponent</span></a> implementations provided
121
+ for their corresponding <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> class. In short, only UI
122
+ elements which are *not* GUI elements will omit this ATK interface.
121
123
  </p>
122
124
  <p>
123
- A possible exception might be textual information with a transparent
124
- background, in which case text glyph bounding box information is
125
- provided by <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>.
125
+ A possible exception might be textual information with a
126
+ transparent background, in which case text glyph bounding box
127
+ information is provided by <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>.
126
128
  </p>
127
129
  </div>
128
130
  <div class="refsect1">
@@ -131,14 +133,219 @@ provided by <a class="link" href="AtkText.html" title="AtkText"><span class="typ
131
133
  <a name="AtkComponent-struct"></a><h3>AtkComponent</h3>
132
134
  <pre class="programlisting">typedef struct _AtkComponent AtkComponent;</pre>
133
135
  <p>
134
- The AtkComponent structure does not contain any fields.
135
136
  </p>
136
137
  </div>
137
138
  <hr>
138
139
  <div class="refsect2">
140
+ <a name="AtkComponentIface"></a><h3>struct AtkComponentIface</h3>
141
+ <pre class="programlisting">struct AtkComponentIface {
142
+ GTypeInterface parent;
143
+
144
+ guint (* add_focus_handler) (AtkComponent *component,
145
+ AtkFocusHandler handler);
146
+
147
+ gboolean (* contains) (AtkComponent *component,
148
+ gint x,
149
+ gint y,
150
+ AtkCoordType coord_type);
151
+
152
+ AtkObject* (* ref_accessible_at_point) (AtkComponent *component,
153
+ gint x,
154
+ gint y,
155
+ AtkCoordType coord_type);
156
+ void (* get_extents) (AtkComponent *component,
157
+ gint *x,
158
+ gint *y,
159
+ gint *width,
160
+ gint *height,
161
+ AtkCoordType coord_type);
162
+ void (* get_position) (AtkComponent *component,
163
+ gint *x,
164
+ gint *y,
165
+ AtkCoordType coord_type);
166
+ void (* get_size) (AtkComponent *component,
167
+ gint *width,
168
+ gint *height);
169
+ gboolean (* grab_focus) (AtkComponent *component);
170
+ void (* remove_focus_handler) (AtkComponent *component,
171
+ guint handler_id);
172
+ gboolean (* set_extents) (AtkComponent *component,
173
+ gint x,
174
+ gint y,
175
+ gint width,
176
+ gint height,
177
+ AtkCoordType coord_type);
178
+ gboolean (* set_position) (AtkComponent *component,
179
+ gint x,
180
+ gint y,
181
+ AtkCoordType coord_type);
182
+ gboolean (* set_size) (AtkComponent *component,
183
+ gint width,
184
+ gint height);
185
+
186
+ AtkLayer (* get_layer) (AtkComponent *component);
187
+ gint (* get_mdi_zorder) (AtkComponent *component);
188
+
189
+ /*
190
+ * signal handlers
191
+ */
192
+ void (* bounds_changed) (AtkComponent *component,
193
+ AtkRectangle *bounds);
194
+ gdouble (* get_alpha) (AtkComponent *component);
195
+ };
196
+ </pre>
197
+ <div class="variablelist"><table border="0">
198
+ <col align="left" valign="top">
199
+ <tbody>
200
+ <tr>
201
+ <td><p><span class="term"><span class="type">GTypeInterface</span> <em class="structfield"><code><a name="AtkComponentIface.parent"></a>parent</code></em>;</span></p></td>
202
+ <td></td>
203
+ </tr>
204
+ <tr>
205
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.add-focus-handler"></a>add_focus_handler</code></em> ()</span></p></td>
206
+ <td>This virtual function is deprecated since 2.9.4
207
+ and it should not be overriden. See
208
+ <a class="link" href="AtkComponent.html#atk-component-add-focus-handler" title="atk_component_add_focus_handler ()"><code class="function">atk_component_add_focus_handler()</code></a> for more information.</td>
209
+ </tr>
210
+ <tr>
211
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.contains"></a>contains</code></em> ()</span></p></td>
212
+ <td></td>
213
+ </tr>
214
+ <tr>
215
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.ref-accessible-at-point"></a>ref_accessible_at_point</code></em> ()</span></p></td>
216
+ <td></td>
217
+ </tr>
218
+ <tr>
219
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.get-extents"></a>get_extents</code></em> ()</span></p></td>
220
+ <td></td>
221
+ </tr>
222
+ <tr>
223
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.get-position"></a>get_position</code></em> ()</span></p></td>
224
+ <td></td>
225
+ </tr>
226
+ <tr>
227
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.get-size"></a>get_size</code></em> ()</span></p></td>
228
+ <td></td>
229
+ </tr>
230
+ <tr>
231
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.grab-focus"></a>grab_focus</code></em> ()</span></p></td>
232
+ <td></td>
233
+ </tr>
234
+ <tr>
235
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.remove-focus-handler"></a>remove_focus_handler</code></em> ()</span></p></td>
236
+ <td>This virtual function is deprecated since
237
+ 2.9.4 and it should not be overriden. See
238
+ <a class="link" href="AtkComponent.html#atk-component-remove-focus-handler" title="atk_component_remove_focus_handler ()"><code class="function">atk_component_remove_focus_handler()</code></a> for more information.</td>
239
+ </tr>
240
+ <tr>
241
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.set-extents"></a>set_extents</code></em> ()</span></p></td>
242
+ <td></td>
243
+ </tr>
244
+ <tr>
245
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.set-position"></a>set_position</code></em> ()</span></p></td>
246
+ <td></td>
247
+ </tr>
248
+ <tr>
249
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.set-size"></a>set_size</code></em> ()</span></p></td>
250
+ <td></td>
251
+ </tr>
252
+ <tr>
253
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.get-layer"></a>get_layer</code></em> ()</span></p></td>
254
+ <td></td>
255
+ </tr>
256
+ <tr>
257
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.get-mdi-zorder"></a>get_mdi_zorder</code></em> ()</span></p></td>
258
+ <td></td>
259
+ </tr>
260
+ <tr>
261
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.bounds-changed"></a>bounds_changed</code></em> ()</span></p></td>
262
+ <td></td>
263
+ </tr>
264
+ <tr>
265
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkComponentIface.get-alpha"></a>get_alpha</code></em> ()</span></p></td>
266
+ <td></td>
267
+ </tr>
268
+ </tbody>
269
+ </table></div>
270
+ </div>
271
+ <hr>
272
+ <div class="refsect2">
273
+ <a name="AtkFocusHandler"></a><h3>AtkFocusHandler ()</h3>
274
+ <pre class="programlisting"><span class="returnvalue">void</span> (*AtkFocusHandler) (<em class="parameter"><code><a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> *object</code></em>,
275
+ <em class="parameter"><code><span class="type">gboolean</span> focus_in</code></em>);</pre>
276
+ <div class="warning">
277
+ <h3 class="title">Warning</h3>
278
+ <p><code class="literal">AtkFocusHandler</code> is deprecated and should not be used in newly-written code. This type is deprecated since ATK version 2.9.4. as
279
+ <a class="link" href="AtkComponent.html#atk-component-add-focus-handler" title="atk_component_add_focus_handler ()"><code class="function">atk_component_add_focus_handler()</code></a> and
280
+ <a class="link" href="AtkComponent.html#atk-component-remove-focus-handler" title="atk_component_remove_focus_handler ()"><code class="function">atk_component_remove_focus_handler()</code></a> are deprecated. See those
281
+ methods for more information.</p>
282
+ </div>
283
+ <p>
284
+ The type of callback function used for
285
+ <a class="link" href="AtkComponent.html#atk-component-add-focus-handler" title="atk_component_add_focus_handler ()"><code class="function">atk_component_add_focus_handler()</code></a> and
286
+ <a class="link" href="AtkComponent.html#atk-component-remove-focus-handler" title="atk_component_remove_focus_handler ()"><code class="function">atk_component_remove_focus_handler()</code></a>
287
+ </p>
288
+ <div class="variablelist"><table border="0">
289
+ <col align="left" valign="top">
290
+ <tbody>
291
+ <tr>
292
+ <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
293
+ <td>the <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> that receives/lose the focus</td>
294
+ </tr>
295
+ <tr>
296
+ <td><p><span class="term"><em class="parameter"><code>focus_in</code></em> :</span></p></td>
297
+ <td>TRUE if the object receives the focus</td>
298
+ </tr>
299
+ </tbody>
300
+ </table></div>
301
+ </div>
302
+ <hr>
303
+ <div class="refsect2">
304
+ <a name="AtkRectangle"></a><h3>struct AtkRectangle</h3>
305
+ <pre class="programlisting">struct AtkRectangle {
306
+ gint x;
307
+ gint y;
308
+ gint width;
309
+ gint height;
310
+ };
311
+ </pre>
312
+ <p>
313
+ A data structure for holding a rectangle. Those coordinates are
314
+ relative to the component top-level parent.
315
+ </p>
316
+ <div class="variablelist"><table border="0">
317
+ <col align="left" valign="top">
318
+ <tbody>
319
+ <tr>
320
+ <td><p><span class="term"><span class="type">gint</span> <em class="structfield"><code><a name="AtkRectangle.x"></a>x</code></em>;</span></p></td>
321
+ <td>X coordinate of the left side of the rectangle.</td>
322
+ </tr>
323
+ <tr>
324
+ <td><p><span class="term"><span class="type">gint</span> <em class="structfield"><code><a name="AtkRectangle.y"></a>y</code></em>;</span></p></td>
325
+ <td>Y coordinate of the top side of the rectangle.</td>
326
+ </tr>
327
+ <tr>
328
+ <td><p><span class="term"><span class="type">gint</span> <em class="structfield"><code><a name="AtkRectangle.width"></a>width</code></em>;</span></p></td>
329
+ <td>width of the rectangle.</td>
330
+ </tr>
331
+ <tr>
332
+ <td><p><span class="term"><span class="type">gint</span> <em class="structfield"><code><a name="AtkRectangle.height"></a>height</code></em>;</span></p></td>
333
+ <td>height of the rectangle.</td>
334
+ </tr>
335
+ </tbody>
336
+ </table></div>
337
+ </div>
338
+ <hr>
339
+ <div class="refsect2">
139
340
  <a name="atk-component-add-focus-handler"></a><h3>atk_component_add_focus_handler ()</h3>
140
341
  <pre class="programlisting"><span class="returnvalue">guint</span> atk_component_add_focus_handler (<em class="parameter"><code><a class="link" href="AtkComponent.html" title="AtkComponent"><span class="type">AtkComponent</span></a> *component</code></em>,
141
- <em class="parameter"><code><span class="type">AtkFocusHandler</span> handler</code></em>);</pre>
342
+ <em class="parameter"><code><a class="link" href="AtkComponent.html#AtkFocusHandler" title="AtkFocusHandler ()"><span class="type">AtkFocusHandler</span></a> handler</code></em>);</pre>
343
+ <div class="warning">
344
+ <h3 class="title">Warning</h3>
345
+ <p><code class="literal">atk_component_add_focus_handler</code> is deprecated and should not be used in newly-written code. This method is deprecated since ATK version 2.9.4. If
346
+ you need to track when an object gains or lose the focus, use
347
+ state-changed:focused notification instead.</p>
348
+ </div>
142
349
  <p>
143
350
  Add the specified handler to the set of functions to be called
144
351
  when this object receives focus events (in or out). If the handler is
@@ -153,12 +360,12 @@ already added it is not added again
153
360
  </tr>
154
361
  <tr>
155
362
  <td><p><span class="term"><em class="parameter"><code>handler</code></em> :</span></p></td>
156
- <td>The <span class="type">AtkFocusHandler</span> to be attached to <em class="parameter"><code>component</code></em>
363
+ <td>The <a class="link" href="AtkComponent.html#AtkFocusHandler" title="AtkFocusHandler ()"><span class="type">AtkFocusHandler</span></a> to be attached to <em class="parameter"><code>component</code></em>
157
364
  </td>
158
365
  </tr>
159
366
  <tr>
160
367
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
161
- <td>a handler id which can be used in atk_component_remove_focus_handler
368
+ <td>a handler id which can be used in <a class="link" href="AtkComponent.html#atk-component-remove-focus-handler" title="atk_component_remove_focus_handler ()"><code class="function">atk_component_remove_focus_handler()</code></a>
162
369
  or zero if the handler was already added.</td>
163
370
  </tr>
164
371
  </tbody>
@@ -429,6 +636,12 @@ or to the components top level window</td>
429
636
  <a name="atk-component-remove-focus-handler"></a><h3>atk_component_remove_focus_handler ()</h3>
430
637
  <pre class="programlisting"><span class="returnvalue">void</span> atk_component_remove_focus_handler (<em class="parameter"><code><a class="link" href="AtkComponent.html" title="AtkComponent"><span class="type">AtkComponent</span></a> *component</code></em>,
431
638
  <em class="parameter"><code><span class="type">guint</span> handler_id</code></em>);</pre>
639
+ <div class="warning">
640
+ <h3 class="title">Warning</h3>
641
+ <p><code class="literal">atk_component_remove_focus_handler</code> is deprecated and should not be used in newly-written code. This method is deprecated since ATK version 2.9.4. If
642
+ you need to track when an object gains or lose the focus, use
643
+ state-changed:focused notification instead.</p>
644
+ </div>
432
645
  <p>
433
646
  Remove the handler specified by <em class="parameter"><code>handler_id</code></em> from the list of
434
647
  functions to be executed when this object receives focus events
@@ -606,11 +819,11 @@ Returns the alpha value (i.e. the opacity) for this
606
819
  <div class="refsect2">
607
820
  <a name="AtkComponent-bounds-changed"></a><h3>The <code class="literal">"bounds-changed"</code> signal</h3>
608
821
  <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkComponent.html" title="AtkComponent"><span class="type">AtkComponent</span></a> *atkcomponent,
609
- <span class="type">AtkRectangle</span> *arg1,
822
+ <a class="link" href="AtkComponent.html#AtkRectangle" title="struct AtkRectangle"><span class="type">AtkRectangle</span></a> *arg1,
610
823
  <span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
611
824
  <p>
612
- The 'bounds-changed" signal is emitted when the bposition or size of the
613
- a component changes.
825
+ The 'bounds-changed" signal is emitted when the bposition or
826
+ size of the component changes.
614
827
  </p>
615
828
  <div class="variablelist"><table border="0">
616
829
  <col align="left" valign="top">
@@ -634,6 +847,6 @@ a component changes.
634
847
  </div>
635
848
  <div class="footer">
636
849
  <hr>
637
- Generated by GTK-Doc V1.18.1</div>
850
+ Generated by GTK-Doc V1.19.1</div>
638
851
  </body>
639
852
  </html>