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

Sign up to get free protection for your applications and to get access to all the features.
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
@@ -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>
@@ -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>