atk 2.2.0-x86-mingw32 → 2.2.1-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 (143) hide show
  1. checksums.yaml +4 -4
  2. data/Rakefile +1 -1
  3. data/lib/2.0/atk.so +0 -0
  4. data/vendor/local/bin/libatk-1.0-0.dll +0 -0
  5. data/vendor/local/include/atk-1.0/atk/atk-enum-types.h +16 -0
  6. data/vendor/local/include/atk-1.0/atk/atk.h +3 -0
  7. data/vendor/local/include/atk-1.0/atk/atkaction.h +8 -1
  8. data/vendor/local/include/atk-1.0/atk/atkcomponent.h +20 -2
  9. data/vendor/local/include/atk-1.0/atk/atkdocument.h +29 -2
  10. data/vendor/local/include/atk-1.0/atk/atkeditabletext.h +8 -0
  11. data/vendor/local/include/atk-1.0/atk/atkgobjectaccessible.h +3 -0
  12. data/vendor/local/include/atk-1.0/atk/atkhyperlink.h +9 -1
  13. data/vendor/local/include/atk-1.0/atk/atkhyperlinkimpl.h +2 -0
  14. data/vendor/local/include/atk-1.0/atk/atkhypertext.h +4 -0
  15. data/vendor/local/include/atk-1.0/atk/atkimage.h +6 -0
  16. data/vendor/local/include/atk-1.0/atk/atkmisc.h +19 -19
  17. data/vendor/local/include/atk-1.0/atk/atknoopobject.h +4 -0
  18. data/vendor/local/include/atk-1.0/atk/atknoopobjectfactory.h +2 -0
  19. data/vendor/local/include/atk-1.0/atk/atkobject.h +133 -26
  20. data/vendor/local/include/atk-1.0/atk/atkobjectfactory.h +5 -0
  21. data/vendor/local/include/atk-1.0/atk/atkplug.h +5 -0
  22. data/vendor/local/include/atk-1.0/atk/atkrange.h +59 -0
  23. data/vendor/local/include/atk-1.0/atk/atkregistry.h +5 -15
  24. data/vendor/local/include/atk-1.0/atk/atkrelation.h +10 -0
  25. data/vendor/local/include/atk-1.0/atk/atkrelationset.h +10 -0
  26. data/vendor/local/include/atk-1.0/atk/atkselection.h +8 -0
  27. data/vendor/local/include/atk-1.0/atk/atksocket.h +6 -0
  28. data/vendor/local/include/atk-1.0/atk/atkstate.h +14 -2
  29. data/vendor/local/include/atk-1.0/atk/atkstateset.h +12 -0
  30. data/vendor/local/include/atk-1.0/atk/atkstreamablecontent.h +6 -1
  31. data/vendor/local/include/atk-1.0/atk/atktable.h +30 -6
  32. data/vendor/local/include/atk-1.0/atk/atktablecell.h +104 -0
  33. data/vendor/local/include/atk-1.0/atk/atktext.h +30 -5
  34. data/vendor/local/include/atk-1.0/atk/atkutil.h +35 -4
  35. data/vendor/local/include/atk-1.0/atk/atkvalue.h +88 -17
  36. data/vendor/local/include/atk-1.0/atk/atkversion.h +281 -2
  37. data/vendor/local/include/atk-1.0/atk/atkwindow.h +1 -0
  38. data/vendor/local/lib/girepository-1.0/Atk-1.0.typelib +0 -0
  39. data/vendor/local/lib/libatk-1.0.dll.a +0 -0
  40. data/vendor/local/lib/libatk-1.0.la +3 -3
  41. data/vendor/local/lib/pkgconfig/atk.pc +1 -1
  42. data/vendor/local/share/gir-1.0/Atk-1.0.gir +3410 -899
  43. data/vendor/local/share/gtk-doc/html/atk/AtkAction.html +343 -233
  44. data/vendor/local/share/gtk-doc/html/atk/AtkComponent.html +872 -578
  45. data/vendor/local/share/gtk-doc/html/atk/AtkDocument.html +558 -251
  46. data/vendor/local/share/gtk-doc/html/atk/AtkEditableText.html +298 -192
  47. data/vendor/local/share/gtk-doc/html/atk/AtkGObjectAccessible.html +117 -75
  48. data/vendor/local/share/gtk-doc/html/atk/AtkHyperlink.html +434 -273
  49. data/vendor/local/share/gtk-doc/html/atk/AtkHypertext.html +195 -119
  50. data/vendor/local/share/gtk-doc/html/atk/AtkImage.html +224 -143
  51. data/vendor/local/share/gtk-doc/html/atk/AtkMisc.html +191 -0
  52. data/vendor/local/share/gtk-doc/html/atk/AtkNoOpObject.html +83 -59
  53. data/vendor/local/share/gtk-doc/html/atk/AtkNoOpObjectFactory.html +66 -49
  54. data/vendor/local/share/gtk-doc/html/atk/AtkObject.html +2398 -1337
  55. data/vendor/local/share/gtk-doc/html/atk/AtkObjectFactory.html +154 -96
  56. data/vendor/local/share/gtk-doc/html/atk/AtkRegistry.html +192 -118
  57. data/vendor/local/share/gtk-doc/html/atk/AtkRelation.html +496 -278
  58. data/vendor/local/share/gtk-doc/html/atk/AtkRelationSet.html +294 -193
  59. data/vendor/local/share/gtk-doc/html/atk/AtkSelection.html +333 -201
  60. data/vendor/local/share/gtk-doc/html/atk/AtkStateSet.html +403 -256
  61. data/vendor/local/share/gtk-doc/html/atk/AtkStreamableContent.html +192 -130
  62. data/vendor/local/share/gtk-doc/html/atk/AtkTable.html +1363 -776
  63. data/vendor/local/share/gtk-doc/html/atk/AtkTableCell.html +497 -0
  64. data/vendor/local/share/gtk-doc/html/atk/AtkText.html +1975 -1446
  65. data/vendor/local/share/gtk-doc/html/atk/AtkUtil.html +862 -524
  66. data/vendor/local/share/gtk-doc/html/atk/AtkValue.html +638 -108
  67. data/vendor/local/share/gtk-doc/html/atk/AtkWindow.html +302 -175
  68. data/vendor/local/share/gtk-doc/html/atk/accessibles.html +49 -0
  69. data/vendor/local/share/gtk-doc/html/atk/api-index-1-12.html +18 -18
  70. data/vendor/local/share/gtk-doc/html/atk/api-index-1-13.html +21 -11
  71. data/vendor/local/share/gtk-doc/html/atk/api-index-1-20.html +11 -11
  72. data/vendor/local/share/gtk-doc/html/atk/api-index-1-22.html +10 -10
  73. data/vendor/local/share/gtk-doc/html/atk/api-index-1-3.html +11 -11
  74. data/vendor/local/share/gtk-doc/html/atk/api-index-1-30.html +15 -15
  75. data/vendor/local/share/gtk-doc/html/atk/api-index-1-4.html +9 -9
  76. data/vendor/local/share/gtk-doc/html/atk/api-index-1-6.html +11 -11
  77. data/vendor/local/share/gtk-doc/html/atk/api-index-1-9.html +39 -0
  78. data/vendor/local/share/gtk-doc/html/atk/api-index-2-10.html +35 -0
  79. data/vendor/local/share/gtk-doc/html/atk/api-index-2-12.html +78 -0
  80. data/vendor/local/share/gtk-doc/html/atk/api-index-2-2.html +53 -0
  81. data/vendor/local/share/gtk-doc/html/atk/api-index-2-8.html +47 -0
  82. data/vendor/local/share/gtk-doc/html/atk/api-index-deprecated.html +75 -25
  83. data/vendor/local/share/gtk-doc/html/atk/api-index-full.html +358 -288
  84. data/vendor/local/share/gtk-doc/html/atk/atk-AtkHyperlinkImpl.html +82 -60
  85. data/vendor/local/share/gtk-doc/html/atk/atk-AtkPlug.html +99 -52
  86. data/vendor/local/share/gtk-doc/html/atk/atk-AtkRange.html +328 -0
  87. data/vendor/local/share/gtk-doc/html/atk/atk-AtkSocket.html +139 -91
  88. data/vendor/local/share/gtk-doc/html/atk/atk-AtkState.html +355 -226
  89. data/vendor/local/share/gtk-doc/html/atk/atk-Versioning-Utilities.html +203 -142
  90. data/vendor/local/share/gtk-doc/html/atk/atk.devhelp2 +378 -547
  91. data/vendor/local/share/gtk-doc/html/atk/atkobject.html +33 -0
  92. data/vendor/local/share/gtk-doc/html/atk/data.html +49 -0
  93. data/vendor/local/share/gtk-doc/html/atk/deprecated.html +33 -0
  94. data/vendor/local/share/gtk-doc/html/atk/index.html +70 -46
  95. data/vendor/local/share/gtk-doc/html/atk/index.sgml +419 -519
  96. data/vendor/local/share/gtk-doc/html/atk/{atk.html → interfaces.html} +17 -60
  97. data/vendor/local/share/gtk-doc/html/atk/overview.html +47 -0
  98. data/vendor/local/share/gtk-doc/html/atk/style.css +260 -105
  99. data/vendor/local/share/gtk-doc/html/atk/toolkit.html +33 -0
  100. data/vendor/local/share/gtk-doc/html/atk/utilities.html +28 -14
  101. data/vendor/local/share/license/atk/AUTHORS +18 -5
  102. data/vendor/local/share/locale/an/LC_MESSAGES/atk10.mo +0 -0
  103. data/vendor/local/share/locale/as/LC_MESSAGES/atk10.mo +0 -0
  104. data/vendor/local/share/locale/ca/LC_MESSAGES/atk10.mo +0 -0
  105. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/atk10.mo +0 -0
  106. data/vendor/local/share/locale/cs/LC_MESSAGES/atk10.mo +0 -0
  107. data/vendor/local/share/locale/da/LC_MESSAGES/atk10.mo +0 -0
  108. data/vendor/local/share/locale/de/LC_MESSAGES/atk10.mo +0 -0
  109. data/vendor/local/share/locale/el/LC_MESSAGES/atk10.mo +0 -0
  110. data/vendor/local/share/locale/es/LC_MESSAGES/atk10.mo +0 -0
  111. data/vendor/local/share/locale/eu/LC_MESSAGES/atk10.mo +0 -0
  112. data/vendor/local/share/locale/fi/LC_MESSAGES/atk10.mo +0 -0
  113. data/vendor/local/share/locale/fr/LC_MESSAGES/atk10.mo +0 -0
  114. data/vendor/local/share/locale/gl/LC_MESSAGES/atk10.mo +0 -0
  115. data/vendor/local/share/locale/he/LC_MESSAGES/atk10.mo +0 -0
  116. data/vendor/local/share/locale/hu/LC_MESSAGES/atk10.mo +0 -0
  117. data/vendor/local/share/locale/id/LC_MESSAGES/atk10.mo +0 -0
  118. data/vendor/local/share/locale/it/LC_MESSAGES/atk10.mo +0 -0
  119. data/vendor/local/share/locale/ko/LC_MESSAGES/atk10.mo +0 -0
  120. data/vendor/local/share/locale/lt/LC_MESSAGES/atk10.mo +0 -0
  121. data/vendor/local/share/locale/lv/LC_MESSAGES/atk10.mo +0 -0
  122. data/vendor/local/share/locale/nb/LC_MESSAGES/atk10.mo +0 -0
  123. data/vendor/local/share/locale/pa/LC_MESSAGES/atk10.mo +0 -0
  124. data/vendor/local/share/locale/pl/LC_MESSAGES/atk10.mo +0 -0
  125. data/vendor/local/share/locale/pt/LC_MESSAGES/atk10.mo +0 -0
  126. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/atk10.mo +0 -0
  127. data/vendor/local/share/locale/ru/LC_MESSAGES/atk10.mo +0 -0
  128. data/vendor/local/share/locale/sk/LC_MESSAGES/atk10.mo +0 -0
  129. data/vendor/local/share/locale/sl/LC_MESSAGES/atk10.mo +0 -0
  130. data/vendor/local/share/locale/sr/LC_MESSAGES/atk10.mo +0 -0
  131. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/atk10.mo +0 -0
  132. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/atk10.mo +0 -0
  133. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/atk10.mo +0 -0
  134. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/atk10.mo +0 -0
  135. metadata +27 -19
  136. data/lib/1.9/atk.so +0 -0
  137. data/lib/2.1/atk.so +0 -0
  138. data/vendor/local/lib/atk-1.0.def +0 -248
  139. data/vendor/local/share/gtk-doc/html/atk/api-index-1-18.html +0 -31
  140. data/vendor/local/share/gtk-doc/html/atk/api-index-1-24.html +0 -31
  141. data/vendor/local/share/gtk-doc/html/atk/api-index-1-26.html +0 -31
  142. data/vendor/local/share/gtk-doc/html/atk/api-index-1-28.html +0 -31
  143. data/vendor/local/share/gtk-doc/html/atk/api-index-1-32.html +0 -30
@@ -32,7 +32,7 @@ G_BEGIN_DECLS
32
32
 
33
33
  /**
34
34
  *AtkTextAttribute:
35
- *@ATK_TEXT_ATTR_INVALID: Invalid attribute
35
+ *@ATK_TEXT_ATTR_INVALID: Invalid attribute, like bad spelling or grammar.
36
36
  *@ATK_TEXT_ATTR_LEFT_MARGIN: The pixel width of the left margin
37
37
  *@ATK_TEXT_ATTR_RIGHT_MARGIN: The pixel width of the right margin
38
38
  *@ATK_TEXT_ATTR_INDENT: The number of pixels that the text is indented
@@ -45,7 +45,7 @@ G_BEGIN_DECLS
45
45
  *@ATK_TEXT_ATTR_RISE: Number of pixels that the characters are risen above the baseline
46
46
  *@ATK_TEXT_ATTR_UNDERLINE: "none", "single", "double", "low", or "error"
47
47
  *@ATK_TEXT_ATTR_STRIKETHROUGH: "true" or "false" whether the text is strikethrough
48
- *@ATK_TEXT_ATTR_SIZE: The size of the characters.
48
+ *@ATK_TEXT_ATTR_SIZE: The size of the characters in points. eg: 10
49
49
  *@ATK_TEXT_ATTR_SCALE: The scale of the characters. The value is a string representation of a double
50
50
  *@ATK_TEXT_ATTR_WEIGHT: The weight of the characters.
51
51
  *@ATK_TEXT_ATTR_LANGUAGE: The language used
@@ -97,6 +97,7 @@ typedef enum
97
97
  ATK_TEXT_ATTR_LAST_DEFINED
98
98
  } AtkTextAttribute;
99
99
 
100
+ ATK_AVAILABLE_IN_ALL
100
101
  AtkTextAttribute atk_text_attribute_register (const gchar *name);
101
102
 
102
103
 
@@ -208,6 +209,7 @@ struct _AtkTextRange {
208
209
  gchar* content;
209
210
  };
210
211
 
212
+ ATK_AVAILABLE_IN_ALL
211
213
  GType atk_text_range_get_type (void);
212
214
 
213
215
  /**
@@ -333,6 +335,7 @@ struct _AtkTextIface
333
335
  gint *end_offset);
334
336
  };
335
337
 
338
+ ATK_AVAILABLE_IN_ALL
336
339
  GType atk_text_get_type (void);
337
340
 
338
341
 
@@ -343,35 +346,40 @@ GType atk_text_get_type (void);
343
346
  * editable text only)
344
347
  */
345
348
 
349
+ ATK_AVAILABLE_IN_ALL
346
350
  gchar* atk_text_get_text (AtkText *text,
347
351
  gint start_offset,
348
352
  gint end_offset);
353
+ ATK_AVAILABLE_IN_ALL
349
354
  gunichar atk_text_get_character_at_offset (AtkText *text,
350
355
  gint offset);
351
- G_DEPRECATED_FOR(atk_text_get_string_at_offset)
356
+ ATK_DEPRECATED_IN_2_10_FOR(atk_text_get_string_at_offset)
352
357
  gchar* atk_text_get_text_after_offset (AtkText *text,
353
358
  gint offset,
354
359
  AtkTextBoundary boundary_type,
355
360
  gint *start_offset,
356
361
  gint *end_offset);
357
- G_DEPRECATED_FOR(atk_text_get_string_at_offset)
362
+ ATK_DEPRECATED_IN_2_10_FOR(atk_text_get_string_at_offset)
358
363
  gchar* atk_text_get_text_at_offset (AtkText *text,
359
364
  gint offset,
360
365
  AtkTextBoundary boundary_type,
361
366
  gint *start_offset,
362
367
  gint *end_offset);
363
- G_DEPRECATED_FOR(atk_text_get_string_at_offset)
368
+ ATK_DEPRECATED_IN_2_10_FOR(atk_text_get_string_at_offset)
364
369
  gchar* atk_text_get_text_before_offset (AtkText *text,
365
370
  gint offset,
366
371
  AtkTextBoundary boundary_type,
367
372
  gint *start_offset,
368
373
  gint *end_offset);
374
+ ATK_AVAILABLE_IN_2_10
369
375
  gchar* atk_text_get_string_at_offset (AtkText *text,
370
376
  gint offset,
371
377
  AtkTextGranularity granularity,
372
378
  gint *start_offset,
373
379
  gint *end_offset);
380
+ ATK_AVAILABLE_IN_ALL
374
381
  gint atk_text_get_caret_offset (AtkText *text);
382
+ ATK_AVAILABLE_IN_ALL
375
383
  void atk_text_get_character_extents (AtkText *text,
376
384
  gint offset,
377
385
  gint *x,
@@ -379,47 +387,64 @@ void atk_text_get_character_extents (AtkText *tex
379
387
  gint *width,
380
388
  gint *height,
381
389
  AtkCoordType coords);
390
+ ATK_AVAILABLE_IN_ALL
382
391
  AtkAttributeSet* atk_text_get_run_attributes (AtkText *text,
383
392
  gint offset,
384
393
  gint *start_offset,
385
394
  gint *end_offset);
395
+ ATK_AVAILABLE_IN_ALL
386
396
  AtkAttributeSet* atk_text_get_default_attributes (AtkText *text);
397
+ ATK_AVAILABLE_IN_ALL
387
398
  gint atk_text_get_character_count (AtkText *text);
399
+ ATK_AVAILABLE_IN_ALL
388
400
  gint atk_text_get_offset_at_point (AtkText *text,
389
401
  gint x,
390
402
  gint y,
391
403
  AtkCoordType coords);
404
+ ATK_AVAILABLE_IN_ALL
392
405
  gint atk_text_get_n_selections (AtkText *text);
406
+ ATK_AVAILABLE_IN_ALL
393
407
  gchar* atk_text_get_selection (AtkText *text,
394
408
  gint selection_num,
395
409
  gint *start_offset,
396
410
  gint *end_offset);
411
+ ATK_AVAILABLE_IN_ALL
397
412
  gboolean atk_text_add_selection (AtkText *text,
398
413
  gint start_offset,
399
414
  gint end_offset);
415
+ ATK_AVAILABLE_IN_ALL
400
416
  gboolean atk_text_remove_selection (AtkText *text,
401
417
  gint selection_num);
418
+ ATK_AVAILABLE_IN_ALL
402
419
  gboolean atk_text_set_selection (AtkText *text,
403
420
  gint selection_num,
404
421
  gint start_offset,
405
422
  gint end_offset);
423
+ ATK_AVAILABLE_IN_ALL
406
424
  gboolean atk_text_set_caret_offset (AtkText *text,
407
425
  gint offset);
426
+ ATK_AVAILABLE_IN_ALL
408
427
  void atk_text_get_range_extents (AtkText *text,
409
428
 
410
429
  gint start_offset,
411
430
  gint end_offset,
412
431
  AtkCoordType coord_type,
413
432
  AtkTextRectangle *rect);
433
+ ATK_AVAILABLE_IN_ALL
414
434
  AtkTextRange** atk_text_get_bounded_ranges (AtkText *text,
415
435
  AtkTextRectangle *rect,
416
436
  AtkCoordType coord_type,
417
437
  AtkTextClipType x_clip_type,
418
438
  AtkTextClipType y_clip_type);
439
+ ATK_AVAILABLE_IN_ALL
419
440
  void atk_text_free_ranges (AtkTextRange **ranges);
441
+ ATK_AVAILABLE_IN_ALL
420
442
  void atk_attribute_set_free (AtkAttributeSet *attrib_set);
443
+ ATK_AVAILABLE_IN_ALL
421
444
  const gchar* atk_text_attribute_get_name (AtkTextAttribute attr);
445
+ ATK_AVAILABLE_IN_ALL
422
446
  AtkTextAttribute atk_text_attribute_for_name (const gchar *name);
447
+ ATK_AVAILABLE_IN_ALL
423
448
  const gchar* atk_text_attribute_get_value (AtkTextAttribute attr,
424
449
  gint index_);
425
450
 
@@ -137,6 +137,26 @@ struct _AtkUtil
137
137
  GObject parent;
138
138
  };
139
139
 
140
+ /**
141
+ * AtkUtilClass:
142
+ * @add_global_event_listener: adds the specified function to the list
143
+ * of functions to be called when an ATK event occurs. ATK
144
+ * implementors are discouraged from reimplementing this method.
145
+ * @remove_global_event_listener: removes the specified function to
146
+ * the list of functions to be called when an ATK event occurs. ATK
147
+ * implementors are discouraged from reimplementing this method.
148
+ * @add_key_event_listener: adds the specified function to the list of
149
+ * functions to be called when a key event occurs.
150
+ * @remove_key_event_listener: remove the specified function to the
151
+ * list of functions to be called when a key event occurs.
152
+ * @get_root: gets the root accessible container for the current
153
+ * application.
154
+ * @get_toolkit_name: gets name string for the GUI toolkit
155
+ * implementing ATK for this application.
156
+ * @get_toolkit_version: gets version string for the GUI toolkit
157
+ * implementing ATK for this application.
158
+ *
159
+ */
140
160
  struct _AtkUtilClass
141
161
  {
142
162
  GObjectClass parent;
@@ -150,6 +170,7 @@ struct _AtkUtilClass
150
170
  const gchar* (* get_toolkit_name) (void);
151
171
  const gchar* (* get_toolkit_version) (void);
152
172
  };
173
+ ATK_AVAILABLE_IN_ALL
153
174
  GType atk_util_get_type (void);
154
175
 
155
176
  /**
@@ -166,25 +187,34 @@ typedef enum {
166
187
  ATK_XY_WINDOW
167
188
  }AtkCoordType;
168
189
 
169
- G_DEPRECATED
190
+ ATK_DEPRECATED_IN_2_10
170
191
  guint atk_add_focus_tracker (AtkEventListener focus_tracker);
171
- G_DEPRECATED
192
+ ATK_DEPRECATED_IN_2_10
172
193
  void atk_remove_focus_tracker (guint tracker_id);
173
- G_DEPRECATED
194
+ ATK_DEPRECATED_IN_2_10
174
195
  void atk_focus_tracker_init (AtkEventListenerInit init);
175
- G_DEPRECATED
196
+ ATK_DEPRECATED_IN_2_10
176
197
  void atk_focus_tracker_notify (AtkObject *object);
198
+ ATK_AVAILABLE_IN_ALL
177
199
  guint atk_add_global_event_listener (GSignalEmissionHook listener,
178
200
  const gchar *event_type);
201
+ ATK_AVAILABLE_IN_ALL
179
202
  void atk_remove_global_event_listener (guint listener_id);
203
+ ATK_AVAILABLE_IN_ALL
180
204
  guint atk_add_key_event_listener (AtkKeySnoopFunc listener, gpointer data);
205
+ ATK_AVAILABLE_IN_ALL
181
206
  void atk_remove_key_event_listener (guint listener_id);
182
207
 
208
+ ATK_AVAILABLE_IN_ALL
183
209
  AtkObject* atk_get_root(void);
210
+ ATK_AVAILABLE_IN_ALL
184
211
  AtkObject* atk_get_focus_object (void);
185
212
 
213
+ ATK_AVAILABLE_IN_ALL
186
214
  const gchar *atk_get_toolkit_name (void);
215
+ ATK_AVAILABLE_IN_ALL
187
216
  const gchar *atk_get_toolkit_version (void);
217
+ ATK_AVAILABLE_IN_ALL
188
218
  const gchar *atk_get_version (void);
189
219
 
190
220
  /* --- GType boilerplate --- */
@@ -285,6 +315,7 @@ static void type_name##_class_intern_init (gpointer klass) \
285
315
  type_name##_class_init ((TypeName##Class*) klass); \
286
316
  } \
287
317
  \
318
+ ATK_AVAILABLE_IN_ALL \
288
319
  GType \
289
320
  type_name##_get_type (void) \
290
321
  { \
@@ -25,17 +25,10 @@
25
25
  #define __ATK_VALUE_H__
26
26
 
27
27
  #include <atk/atkobject.h>
28
+ #include <atk/atkrange.h>
28
29
 
29
30
  G_BEGIN_DECLS
30
31
 
31
- /*
32
- * The AtkValue interface should be supported by any object that
33
- * supports a numerical value (e.g., a scroll bar). This interface
34
- * provides the standard mechanism for an assistive technology to
35
- * determine and set the numerical value as well as get the minimum
36
- * and maximum values.
37
- */
38
-
39
32
  #define ATK_TYPE_VALUE (atk_value_get_type ())
40
33
  #define ATK_IS_VALUE(obj) G_TYPE_CHECK_INSTANCE_TYPE ((obj), ATK_TYPE_VALUE)
41
34
  #define ATK_VALUE(obj) G_TYPE_CHECK_INSTANCE_CAST ((obj), ATK_TYPE_VALUE, AtkValue)
@@ -47,10 +40,63 @@ typedef struct _AtkValue AtkValue;
47
40
  #endif
48
41
  typedef struct _AtkValueIface AtkValueIface;
49
42
 
43
+ /**
44
+ * AtkValueType:
45
+ *
46
+ * Default types for a given value. Those are defined in order to
47
+ * easily get localized strings to describe a given value or a given
48
+ * subrange, using atk_value_type_get_localized_name().
49
+ *
50
+ */
51
+ typedef enum
52
+ {
53
+ ATK_VALUE_VERY_WEAK,
54
+ ATK_VALUE_WEAK,
55
+ ATK_VALUE_ACCEPTABLE,
56
+ ATK_VALUE_STRONG,
57
+ ATK_VALUE_VERY_STRONG,
58
+ ATK_VALUE_VERY_LOW,
59
+ ATK_VALUE_LOW,
60
+ ATK_VALUE_MEDIUM,
61
+ ATK_VALUE_HIGH,
62
+ ATK_VALUE_VERY_HIGH,
63
+ ATK_VALUE_VERY_BAD,
64
+ ATK_VALUE_BAD,
65
+ ATK_VALUE_GOOD,
66
+ ATK_VALUE_VERY_GOOD,
67
+ ATK_VALUE_BEST,
68
+ ATK_VALUE_LAST_DEFINED
69
+ }AtkValueType;
70
+
71
+ /**
72
+ * AtkValueIface:
73
+ * @get_current_value: This virtual function is deprecated since 2.12
74
+ * and it should not be overriden.
75
+ * @get_maximum_value: This virtual function is deprecated since 2.12
76
+ * and it should not be overriden.
77
+ * @get_minimum_value: This virtual function is deprecated since 2.12
78
+ * and it should not be overriden.
79
+ * @set_current_value: This virtual function is deprecated since 2.12
80
+ * and it should not be overriden.
81
+ * @get_minimum_increment: This virtual function is deprecated since
82
+ * 2.12 and it should not be overriden.
83
+ * @get_value_and_text: gets the current value and the human readable
84
+ * text alternative (if available) of this object. Since 2.12.
85
+ * @get_range: gets the range that defines the minimum and maximum
86
+ * value of this object. Returns NULL if there is no range
87
+ * defined. Since 2.12.
88
+ * @get_increment: gets the minimum increment by which the value of
89
+ * this object may be changed. If zero it is undefined. Since 2.12.
90
+ * @get_sub_ranges: returns a list of different subranges, and their
91
+ * description (if available) of this object. Returns NULL if there
92
+ * is not subranges defined. Since 2.12.
93
+ * @set_value: sets the value of this object. Since 2.12.
94
+ */
50
95
  struct _AtkValueIface
51
96
  {
52
97
  GTypeInterface parent;
53
98
 
99
+ /*<deprecated>*/
54
100
  void (* get_current_value) (AtkValue *obj,
55
101
  GValue *value);
56
102
  void (* get_maximum_value) (AtkValue *obj,
@@ -61,31 +107,56 @@ struct _AtkValueIface
61
107
  const GValue *value);
62
108
  void (* get_minimum_increment) (AtkValue *obj,
63
109
  GValue *value);
110
+ /*</deprecated>*/
111
+ void (* get_value_and_text) (AtkValue *obj,
112
+ gdouble *value,
113
+ gchar **text);
114
+ AtkRange*(* get_range) (AtkValue *obj);
115
+ gdouble (* get_increment) (AtkValue *obj);
116
+ GSList* (* get_sub_ranges) (AtkValue *obj);
117
+ void (* set_value) (AtkValue *obj,
118
+ const gdouble new_value);
119
+
64
120
  };
65
121
 
122
+ ATK_AVAILABLE_IN_ALL
66
123
  GType atk_value_get_type (void);
67
124
 
125
+ ATK_DEPRECATED_IN_2_12_FOR(atk_value_get_value_and_text)
68
126
  void atk_value_get_current_value (AtkValue *obj,
69
127
  GValue *value);
70
128
 
71
-
129
+ ATK_DEPRECATED_IN_2_12_FOR(atk_value_get_range)
72
130
  void atk_value_get_maximum_value (AtkValue *obj,
73
131
  GValue *value);
74
-
132
+ ATK_DEPRECATED_IN_2_12_FOR(atk_value_get_range)
75
133
  void atk_value_get_minimum_value (AtkValue *obj,
76
134
  GValue *value);
77
-
135
+ ATK_DEPRECATED_IN_2_12_FOR(atk_value_set_value)
78
136
  gboolean atk_value_set_current_value (AtkValue *obj,
79
137
  const GValue *value);
80
-
138
+ ATK_DEPRECATED_IN_2_12_FOR(atk_value_get_increment)
81
139
  void atk_value_get_minimum_increment (AtkValue *obj,
82
140
  GValue *value);
83
141
 
84
- /*
85
- * Additional GObject properties exported by GaccessibleValue:
86
- * "accessible_value"
87
- * (the accessible value has changed)
88
- */
142
+ ATK_AVAILABLE_IN_2_12
143
+ void atk_value_get_value_and_text (AtkValue *obj,
144
+ gdouble *value,
145
+ gchar **text);
146
+ ATK_AVAILABLE_IN_2_12
147
+ AtkRange* atk_value_get_range (AtkValue *obj);
148
+ ATK_AVAILABLE_IN_2_12
149
+ gdouble atk_value_get_increment (AtkValue *obj);
150
+ ATK_AVAILABLE_IN_2_12
151
+ GSList* atk_value_get_sub_ranges (AtkValue *obj);
152
+ ATK_AVAILABLE_IN_2_12
153
+ void atk_value_set_value (AtkValue *obj,
154
+ const gdouble new_value);
155
+ /* AtkValueType methods */
156
+ ATK_AVAILABLE_IN_ALL
157
+ const gchar* atk_value_type_get_name (AtkValueType value_type);
158
+ ATK_AVAILABLE_IN_ALL
159
+ const gchar* atk_value_type_get_localized_name (AtkValueType value_type);
89
160
 
90
161
  G_END_DECLS
91
162
 
@@ -1,6 +1,7 @@
1
1
  /* ATK - Accessibility Toolkit
2
2
  *
3
3
  * Copyright (C) 2012 Igalia, S.L.
4
+ * Copyright (C) 2014 Chun-wei Fan
4
5
  *
5
6
  * Author: Alejandro Pi�eiro Iglesias <apinheiro@igalia.com>
6
7
  *
@@ -27,6 +28,8 @@
27
28
  #ifndef __ATK_VERSION_H__
28
29
  #define __ATK_VERSION_H__
29
30
 
31
+ #include <glib.h>
32
+
30
33
  /**
31
34
  * ATK_MAJOR_VERSION:
32
35
  *
@@ -47,7 +50,7 @@
47
50
  *
48
51
  * Since: 2.7.4
49
52
  */
50
- #define ATK_MINOR_VERSION (10)
53
+ #define ATK_MINOR_VERSION (14)
51
54
 
52
55
  /**
53
56
  * ATK_MICRO_VERSION:
@@ -69,7 +72,7 @@
69
72
  *
70
73
  * Since: 2.7.4
71
74
  */
72
- #define ATK_BINARY_AGE (21010)
75
+ #define ATK_BINARY_AGE (21410)
73
76
 
74
77
  /**
75
78
  * ATK_INTERFACE_AGE:
@@ -99,11 +102,287 @@
99
102
  (ATK_MAJOR_VERSION == (major) && ATK_MINOR_VERSION == (minor) && \
100
103
  ATK_MICRO_VERSION >= (micro)))
101
104
 
105
+ #ifndef _ATK_EXTERN
106
+ #define _ATK_EXTERN extern
107
+ #endif
108
+
109
+ /**
110
+ * ATK_VERSION_2_2:
111
+ *
112
+ * A macro that evaluates to the 2.2 version of ATK, in a format
113
+ * that can be used by the C pre-processor.
114
+ *
115
+ * Since: 2.14
116
+ */
117
+ #define ATK_VERSION_2_2 (G_ENCODE_VERSION (2, 2))
118
+
119
+ /**
120
+ * ATK_VERSION_2_4:
121
+ *
122
+ * A macro that evaluates to the 2.4 version of ATK, in a format
123
+ * that can be used by the C pre-processor.
124
+ *
125
+ * Since: 2.14
126
+ */
127
+ #define ATK_VERSION_2_4 (G_ENCODE_VERSION (2, 4))
128
+
129
+ /**
130
+ * ATK_VERSION_2_6:
131
+ *
132
+ * A macro that evaluates to the 2.6 version of ATK, in a format
133
+ * that can be used by the C pre-processor.
134
+ *
135
+ * Since: 2.14
136
+ */
137
+ #define ATK_VERSION_2_6 (G_ENCODE_VERSION (2, 6))
138
+
139
+ /**
140
+ * ATK_VERSION_2_8:
141
+ *
142
+ * A macro that evaluates to the 2.8 version of ATK, in a format
143
+ * that can be used by the C pre-processor.
144
+ *
145
+ * Since: 2.14
146
+ */
147
+ #define ATK_VERSION_2_8 (G_ENCODE_VERSION (2, 8))
148
+
149
+ /**
150
+ * ATK_VERSION_2_10:
151
+ *
152
+ * A macro that evaluates to the 2.10 version of ATK, in a format
153
+ * that can be used by the C pre-processor.
154
+ *
155
+ * Since: 2.14
156
+ */
157
+
158
+ #define ATK_VERSION_2_10 (G_ENCODE_VERSION (2, 10))
159
+ /**
160
+ * ATK_VERSION_2_12:
161
+ *
162
+ * A macro that evaluates to the 2.12 version of ATK, in a format
163
+ * that can be used by the C pre-processor.
164
+ *
165
+ * Since: 2.14
166
+ */
167
+ #define ATK_VERSION_2_12 (G_ENCODE_VERSION (2, 12))
168
+
169
+ /**
170
+ * ATK_VERSION_2_14:
171
+ *
172
+ * A macro that evaluates to the 2.14 version of ATK, in a format
173
+ * that can be used by the C pre-processor.
174
+ *
175
+ * Since: 2.14
176
+ */
177
+ #define ATK_VERSION_2_14 (G_ENCODE_VERSION (2, 14))
178
+
179
+ /* evaluates to the current stable version; for development cycles,
180
+ * this means the next stable target
181
+ */
182
+ #if (ATK_MINOR_VERSION % 2)
183
+ #define ATK_VERSION_CUR_STABLE (G_ENCODE_VERSION (ATK_MAJOR_VERSION, ATK_MINOR_VERSION + 1))
184
+ #else
185
+ #define ATK_VERSION_CUR_STABLE (G_ENCODE_VERSION (ATK_MAJOR_VERSION, ATK_MINOR_VERSION))
186
+ #endif
187
+
188
+ /* evaluates to the previous stable version */
189
+ #if (ATK_MINOR_VERSION % 2)
190
+ #define ATK_VERSION_PREV_STABLE (G_ENCODE_VERSION (ATK_MAJOR_VERSION, ATK_MINOR_VERSION - 1))
191
+ #else
192
+ #define ATK_VERSION_PREV_STABLE (G_ENCODE_VERSION (ATK_MAJOR_VERSION, ATK_MINOR_VERSION - 2))
193
+ #endif
194
+
195
+ /**
196
+ * ATK_VERSION_MIN_REQUIRED:
197
+ *
198
+ * A macro that should be defined by the user prior to including
199
+ * the atk/atk.h header.
200
+ * The definition should be one of the predefined ATK version
201
+ * macros: %ATK_VERSION_2_12, %ATK_VERSION_2_14,...
202
+ *
203
+ * This macro defines the earliest version of ATK that the package is
204
+ * required to be able to compile against.
205
+ *
206
+ * If the compiler is configured to warn about the use of deprecated
207
+ * functions, then using functions that were deprecated in version
208
+ * %ATK_VERSION_MIN_REQUIRED or earlier will cause warnings (but
209
+ * using functions deprecated in later releases will not).
210
+ *
211
+ * Since: 2.14
212
+ */
213
+ /* If the package sets ATK_VERSION_MIN_REQUIRED to some future
214
+ * ATK_VERSION_X_Y value that we don't know about, it will compare as
215
+ * 0 in preprocessor tests.
216
+ */
217
+ #ifndef ATK_VERSION_MIN_REQUIRED
218
+ # define ATK_VERSION_MIN_REQUIRED (ATK_VERSION_CUR_STABLE)
219
+ #elif ATK_VERSION_MIN_REQUIRED == 0
220
+ # undef ATK_VERSION_MIN_REQUIRED
221
+ # define ATK_VERSION_MIN_REQUIRED (ATK_VERSION_CUR_STABLE + 2)
222
+ #endif
223
+
224
+ /**
225
+ * ATK_VERSION_MAX_ALLOWED:
226
+ *
227
+ * A macro that should be defined by the user prior to including
228
+ * the atk/atk.h header.
229
+ * The definition should be one of the predefined ATK version
230
+ * macros: %ATK_VERSION_2_12, %ATK_VERSION_2_14,...
231
+ *
232
+ * This macro defines the latest version of the ATK API that the
233
+ * package is allowed to make use of.
234
+ *
235
+ * If the compiler is configured to warn about the use of deprecated
236
+ * functions, then using functions added after version
237
+ * %ATK_VERSION_MAX_ALLOWED will cause warnings.
238
+ *
239
+ * Unless you are using ATK_CHECK_VERSION() or the like to compile
240
+ * different code depending on the ATK version, then this should be
241
+ * set to the same value as %ATK_VERSION_MIN_REQUIRED.
242
+ *
243
+ * Since: 2.14
244
+ */
245
+ #if !defined (ATK_VERSION_MAX_ALLOWED) || (ATK_VERSION_MAX_ALLOWED == 0)
246
+ # undef ATK_VERSION_MAX_ALLOWED
247
+ # define ATK_VERSION_MAX_ALLOWED (ATK_VERSION_CUR_STABLE)
248
+ #endif
249
+
250
+ /* sanity checks */
251
+ #if ATK_VERSION_MIN_REQUIRED > ATK_VERSION_CUR_STABLE
252
+ #error "ATK_VERSION_MIN_REQUIRED must be <= ATK_VERSION_CUR_STABLE"
253
+ #endif
254
+ #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_MIN_REQUIRED
255
+ #error "ATK_VERSION_MAX_ALLOWED must be >= ATK_VERSION_MIN_REQUIRED"
256
+ #endif
257
+ #if ATK_VERSION_MIN_REQUIRED < ATK_VERSION_2_2
258
+ #error "ATK_VERSION_MIN_REQUIRED must be >= ATK_VERSION_2_2"
259
+ #endif
260
+
261
+ /* these macros are used to mark deprecated functions, and thus have to be
262
+ * exposed in a public header.
263
+ *
264
+ * do *not* use them in other libraries depending on Atk: use G_DEPRECATED
265
+ * and G_DEPRECATED_FOR, or use your own wrappers around them.
266
+ */
267
+ #ifdef ATK_DISABLE_DEPRECATION_WARNINGS
268
+ #define ATK_DEPRECATED _ATK_EXTERN
269
+ #define ATK_DEPRECATED_FOR(f) _ATK_EXTERN
270
+ #else
271
+ #define ATK_DEPRECATED G_DEPRECATED _ATK_EXTERN
272
+ #define ATK_DEPRECATED_FOR(f) G_DEPRECATED_FOR(f) _ATK_EXTERN
273
+ #endif
274
+
275
+ #define ATK_AVAILABLE_IN_ALL _ATK_EXTERN
276
+
277
+ /* XXX: Every new stable minor release should add a set of macros here */
278
+
279
+ #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_2
280
+ # define ATK_DEPRECATED_IN_2_2 ATK_DEPRECATED
281
+ # define ATK_DEPRECATED_IN_2_2_FOR(f) ATK_DEPRECATED_FOR(f)
282
+ #else
283
+ # define ATK_DEPRECATED_IN_2_2 _ATK_EXTERN
284
+ # define ATK_DEPRECATED_IN_2_2_FOR(f) _ATK_EXTERN
285
+ #endif
286
+
287
+ #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_2
288
+ # define ATK_AVAILABLE_IN_2_2 ATK_UNAVAILABLE(2, 2)
289
+ #else
290
+ # define ATK_AVAILABLE_IN_2_2 _ATK_EXTERN
291
+ #endif
292
+
293
+ #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_4
294
+ # define ATK_DEPRECATED_IN_2_4 ATK_DEPRECATED
295
+ # define ATK_DEPRECATED_IN_2_4_FOR(f) ATK_DEPRECATED_FOR(f)
296
+ #else
297
+ # define ATK_DEPRECATED_IN_2_4 _ATK_EXTERN
298
+ # define ATK_DEPRECATED_IN_2_4_FOR(f) _ATK_EXTERN
299
+ #endif
300
+
301
+ #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_4
302
+ # define ATK_AVAILABLE_IN_2_4 ATK_UNAVAILABLE(2, 4)
303
+ #else
304
+ # define ATK_AVAILABLE_IN_2_4 _ATK_EXTERN
305
+ #endif
306
+
307
+ #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_6
308
+ # define ATK_DEPRECATED_IN_2_6 ATK_DEPRECATED
309
+ # define ATK_DEPRECATED_IN_2_6_FOR(f) ATK_DEPRECATED_FOR(f)
310
+ #else
311
+ # define ATK_DEPRECATED_IN_2_6 _ATK_EXTERN
312
+ # define ATK_DEPRECATED_IN_2_6_FOR(f) _ATK_EXTERN
313
+ #endif
314
+
315
+ #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_6
316
+ # define ATK_AVAILABLE_IN_2_6 ATK_UNAVAILABLE(2, 6)
317
+ #else
318
+ # define ATK_AVAILABLE_IN_2_6 _ATK_EXTERN
319
+ #endif
320
+
321
+ #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_8
322
+ # define ATK_DEPRECATED_IN_2_8 ATK_DEPRECATED
323
+ # define ATK_DEPRECATED_IN_2_8_FOR(f) ATK_DEPRECATED_FOR(f)
324
+ #else
325
+ # define ATK_DEPRECATED_IN_2_8 _ATK_EXTERN
326
+ # define ATK_DEPRECATED_IN_2_8_FOR(f) _ATK_EXTERN
327
+ #endif
328
+
329
+ #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_8
330
+ # define ATK_AVAILABLE_IN_2_8 ATK_UNAVAILABLE(2, 8)
331
+ #else
332
+ # define ATK_AVAILABLE_IN_2_8 _ATK_EXTERN
333
+ #endif
334
+
335
+ #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_10
336
+ # define ATK_DEPRECATED_IN_2_10 ATK_DEPRECATED
337
+ # define ATK_DEPRECATED_IN_2_10_FOR(f) ATK_DEPRECATED_FOR(f)
338
+ #else
339
+ # define ATK_DEPRECATED_IN_2_10 _ATK_EXTERN
340
+ # define ATK_DEPRECATED_IN_2_10_FOR(f) _ATK_EXTERN
341
+ #endif
342
+
343
+ #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_10
344
+ # define ATK_AVAILABLE_IN_2_10 ATK_UNAVAILABLE(2, 10)
345
+ #else
346
+ # define ATK_AVAILABLE_IN_2_10 _ATK_EXTERN
347
+ #endif
348
+
349
+ #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_12
350
+ # define ATK_DEPRECATED_IN_2_12 ATK_DEPRECATED
351
+ # define ATK_DEPRECATED_IN_2_12_FOR(f) ATK_DEPRECATED_FOR(f)
352
+ #else
353
+ # define ATK_DEPRECATED_IN_2_12 _ATK_EXTERN
354
+ # define ATK_DEPRECATED_IN_2_12_FOR(f) _ATK_EXTERN
355
+ #endif
356
+
357
+ #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_12
358
+ # define ATK_AVAILABLE_IN_2_12 ATK_UNAVAILABLE(2, 12)
359
+ #else
360
+ # define ATK_AVAILABLE_IN_2_12 _ATK_EXTERN
361
+ #endif
362
+
363
+ #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_14
364
+ # define ATK_DEPRECATED_IN_2_14 ATK_DEPRECATED
365
+ # define ATK_DEPRECATED_IN_2_14_FOR(f) ATK_DEPRECATED_FOR(f)
366
+ #else
367
+ # define ATK_DEPRECATED_IN_2_14 _ATK_EXTERN
368
+ # define ATK_DEPRECATED_IN_2_14_FOR(f) _ATK_EXTERN
369
+ #endif
370
+
371
+ #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_14
372
+ # define ATK_AVAILABLE_IN_2_14 ATK_UNAVAILABLE(2, 14)
373
+ #else
374
+ # define ATK_AVAILABLE_IN_2_14 _ATK_EXTERN
375
+ #endif
102
376
 
377
+ ATK_AVAILABLE_IN_2_8
103
378
  guint atk_get_major_version (void) G_GNUC_CONST;
379
+ ATK_AVAILABLE_IN_2_8
104
380
  guint atk_get_minor_version (void) G_GNUC_CONST;
381
+ ATK_AVAILABLE_IN_2_8
105
382
  guint atk_get_micro_version (void) G_GNUC_CONST;
383
+ ATK_AVAILABLE_IN_2_8
106
384
  guint atk_get_binary_age (void) G_GNUC_CONST;
385
+ ATK_AVAILABLE_IN_2_8
107
386
  guint atk_get_interface_age (void) G_GNUC_CONST;
108
387
 
109
388
  #define atk_major_version atk_get_major_version ()