atk 3.1.8-x64-mingw32 → 3.1.9-x64-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Rakefile +1 -1
- data/vendor/local/bin/libatk-1.0-0.dll +0 -0
- data/vendor/local/include/atk-1.0/atk/atk-enum-types.h +16 -9
- data/vendor/local/include/atk-1.0/atk/atkaction.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkcomponent.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkdocument.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkeditabletext.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkgobjectaccessible.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkhyperlink.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkhyperlinkimpl.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkhypertext.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkimage.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkmisc.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atknoopobjectfactory.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkobject.h +5 -3
- data/vendor/local/include/atk-1.0/atk/atkobjectfactory.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkplug.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkrange.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkregistry.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkrelation.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkrelationset.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkrelationtype.h +38 -6
- data/vendor/local/include/atk-1.0/atk/atkselection.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atksocket.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkstate.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkstateset.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkstreamablecontent.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atktable.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atktablecell.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atktext.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkutil.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkvalue.h +3 -3
- data/vendor/local/include/atk-1.0/atk/atkversion.h +5 -3
- data/vendor/local/include/atk-1.0/atk/atkwindow.h +3 -3
- data/vendor/local/lib/girepository-1.0/Atk-1.0.typelib +0 -0
- data/vendor/local/lib/libatk-1.0.dll.a +0 -0
- data/vendor/local/lib/libatk-1.0.la +3 -3
- data/vendor/local/lib/pkgconfig/atk.pc +1 -1
- data/vendor/local/share/gir-1.0/Atk-1.0.gir +61 -7
- data/vendor/local/share/gtk-doc/html/atk/AtkAction.html +4 -4
- data/vendor/local/share/gtk-doc/html/atk/AtkComponent.html +10 -9
- data/vendor/local/share/gtk-doc/html/atk/AtkDocument.html +3 -3
- data/vendor/local/share/gtk-doc/html/atk/AtkGObjectAccessible.html +2 -2
- data/vendor/local/share/gtk-doc/html/atk/AtkHyperlink.html +1 -1
- data/vendor/local/share/gtk-doc/html/atk/AtkHypertext.html +1 -1
- data/vendor/local/share/gtk-doc/html/atk/AtkImage.html +5 -5
- data/vendor/local/share/gtk-doc/html/atk/AtkObject.html +16 -7
- data/vendor/local/share/gtk-doc/html/atk/AtkObjectFactory.html +1 -1
- data/vendor/local/share/gtk-doc/html/atk/AtkRegistry.html +2 -2
- data/vendor/local/share/gtk-doc/html/atk/AtkRelation.html +61 -5
- data/vendor/local/share/gtk-doc/html/atk/AtkRelationSet.html +2 -2
- data/vendor/local/share/gtk-doc/html/atk/AtkSelection.html +1 -1
- data/vendor/local/share/gtk-doc/html/atk/AtkStateSet.html +5 -5
- data/vendor/local/share/gtk-doc/html/atk/AtkStreamableContent.html +2 -2
- data/vendor/local/share/gtk-doc/html/atk/AtkTable.html +6 -6
- data/vendor/local/share/gtk-doc/html/atk/AtkTableCell.html +9 -9
- data/vendor/local/share/gtk-doc/html/atk/AtkText.html +23 -23
- data/vendor/local/share/gtk-doc/html/atk/AtkUtil.html +6 -2
- data/vendor/local/share/gtk-doc/html/atk/AtkValue.html +76 -81
- data/vendor/local/share/gtk-doc/html/atk/annotation-glossary.html +62 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-12.html +9 -9
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-13.html +3 -3
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-20.html +1 -1
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-22.html +5 -5
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-3.html +3 -3
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-30.html +3 -3
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-4.html +1 -1
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-6.html +1 -1
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-9.html +2 -2
- data/vendor/local/share/gtk-doc/html/atk/api-index-2-10.html +1 -1
- data/vendor/local/share/gtk-doc/html/atk/api-index-2-12.html +24 -23
- data/vendor/local/share/gtk-doc/html/atk/api-index-2-2.html +9 -9
- data/vendor/local/share/gtk-doc/html/atk/api-index-2-8.html +6 -6
- data/vendor/local/share/gtk-doc/html/atk/api-index-deprecated.html +37 -37
- data/vendor/local/share/gtk-doc/html/atk/api-index-full.html +349 -349
- data/vendor/local/share/gtk-doc/html/atk/atk-AtkHyperlinkImpl.html +1 -1
- data/vendor/local/share/gtk-doc/html/atk/atk-AtkRange.html +2 -2
- data/vendor/local/share/gtk-doc/html/atk/atk-Versioning-Utilities.html +2 -2
- data/vendor/local/share/gtk-doc/html/atk/atk.devhelp2 +6 -0
- data/vendor/local/share/gtk-doc/html/atk/home.png +0 -0
- data/vendor/local/share/gtk-doc/html/atk/index.html +2 -2
- data/vendor/local/share/gtk-doc/html/atk/left-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/atk/left.png +0 -0
- data/vendor/local/share/gtk-doc/html/atk/right-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/atk/right.png +0 -0
- data/vendor/local/share/gtk-doc/html/atk/up-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/atk/up.png +0 -0
- data/vendor/local/share/license/atk/AUTHORS +4 -1
- data/vendor/local/share/locale/be/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/da/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/fur/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/ne/LC_MESSAGES/atk10.mo +0 -0
- metadata +5 -4
@@ -201,7 +201,7 @@ atk_table_cell_get_column_header_cells
|
|
201
201
|
<a name="atk-table-cell-get-column-header-cells.returns"></a><h4>Returns</h4>
|
202
202
|
<p> a GPtrArray of AtkObjects
|
203
203
|
representing the column header cells. </p>
|
204
|
-
<p><span class="annotation">[<
|
204
|
+
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AtkObject][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
205
205
|
</div>
|
206
206
|
<p class="since">Since: 2.12</p>
|
207
207
|
</div>
|
@@ -230,12 +230,12 @@ atk_table_cell_get_position (<em class="parameter"><code><a class="link" href="A
|
|
230
230
|
<tr>
|
231
231
|
<td class="parameter_name"><p>row</p></td>
|
232
232
|
<td class="parameter_description"><p> the row of the given cell. </p></td>
|
233
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
233
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
234
234
|
</tr>
|
235
235
|
<tr>
|
236
236
|
<td class="parameter_name"><p>column</p></td>
|
237
237
|
<td class="parameter_description"><p> the column of the given cell. </p></td>
|
238
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
238
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
239
239
|
</tr>
|
240
240
|
</tbody>
|
241
241
|
</table></div>
|
@@ -299,7 +299,7 @@ atk_table_cell_get_row_header_cells (<em class="parameter"><code><a class="link"
|
|
299
299
|
<a name="atk-table-cell-get-row-header-cells.returns"></a><h4>Returns</h4>
|
300
300
|
<p> a GPtrArray of AtkObjects
|
301
301
|
representing the row header cells. </p>
|
302
|
-
<p><span class="annotation">[<
|
302
|
+
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AtkObject][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
303
303
|
</div>
|
304
304
|
<p class="since">Since: 2.12</p>
|
305
305
|
</div>
|
@@ -333,22 +333,22 @@ on the object.</p>
|
|
333
333
|
<tr>
|
334
334
|
<td class="parameter_name"><p>row</p></td>
|
335
335
|
<td class="parameter_description"><p> the row index of the given cell. </p></td>
|
336
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
336
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
337
337
|
</tr>
|
338
338
|
<tr>
|
339
339
|
<td class="parameter_name"><p>column</p></td>
|
340
340
|
<td class="parameter_description"><p> the column index of the given cell. </p></td>
|
341
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
341
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
342
342
|
</tr>
|
343
343
|
<tr>
|
344
344
|
<td class="parameter_name"><p>row_span</p></td>
|
345
345
|
<td class="parameter_description"><p> the number of rows occupied by this cell. </p></td>
|
346
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
346
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
347
347
|
</tr>
|
348
348
|
<tr>
|
349
349
|
<td class="parameter_name"><p>column_span</p></td>
|
350
350
|
<td class="parameter_description"><p> the number of columns occupied by this cell. </p></td>
|
351
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
351
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
352
352
|
</tr>
|
353
353
|
</tbody>
|
354
354
|
</table></div>
|
@@ -383,7 +383,7 @@ atk_table_cell_get_table (<em class="parameter"><code><a class="link" href="AtkT
|
|
383
383
|
<div class="refsect3">
|
384
384
|
<a name="atk-table-cell-get-table.returns"></a><h4>Returns</h4>
|
385
385
|
<p> the atk object for the containing table. </p>
|
386
|
-
<p><span class="annotation">[<
|
386
|
+
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
387
387
|
</div>
|
388
388
|
<p class="since">Since: 2.12</p>
|
389
389
|
</div>
|
@@ -490,13 +490,13 @@ atk_text_get_text_after_offset (<em class="parameter"><code><a class="link" href
|
|
490
490
|
<tr>
|
491
491
|
<td class="parameter_name"><p>start_offset</p></td>
|
492
492
|
<td class="parameter_description"><p> the start offset of the returned string. </p></td>
|
493
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
493
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
494
494
|
</tr>
|
495
495
|
<tr>
|
496
496
|
<td class="parameter_name"><p>end_offset</p></td>
|
497
497
|
<td class="parameter_description"><p> the offset of the first character after the
|
498
498
|
returned substring. </p></td>
|
499
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
499
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
500
500
|
</tr>
|
501
501
|
</tbody>
|
502
502
|
</table></div>
|
@@ -568,13 +568,13 @@ start after the offset.</p>
|
|
568
568
|
<tr>
|
569
569
|
<td class="parameter_name"><p>start_offset</p></td>
|
570
570
|
<td class="parameter_description"><p> the start offset of the returned string. </p></td>
|
571
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
571
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
572
572
|
</tr>
|
573
573
|
<tr>
|
574
574
|
<td class="parameter_name"><p>end_offset</p></td>
|
575
575
|
<td class="parameter_description"><p> the offset of the first character after the
|
576
576
|
returned substring. </p></td>
|
577
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
577
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
578
578
|
</tr>
|
579
579
|
</tbody>
|
580
580
|
</table></div>
|
@@ -628,13 +628,13 @@ atk_text_get_text_before_offset (<em class="parameter"><code><a class="link" hre
|
|
628
628
|
<tr>
|
629
629
|
<td class="parameter_name"><p>start_offset</p></td>
|
630
630
|
<td class="parameter_description"><p> the start offset of the returned string. </p></td>
|
631
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
631
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
632
632
|
</tr>
|
633
633
|
<tr>
|
634
634
|
<td class="parameter_name"><p>end_offset</p></td>
|
635
635
|
<td class="parameter_description"><p> the offset of the first character after the
|
636
636
|
returned substring. </p></td>
|
637
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
637
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
638
638
|
</tr>
|
639
639
|
</tbody>
|
640
640
|
</table></div>
|
@@ -714,13 +714,13 @@ of the following paragraph after the offset.</p>
|
|
714
714
|
<td class="parameter_name"><p>start_offset</p></td>
|
715
715
|
<td class="parameter_description"><p> the start offset of the returned string, or -1
|
716
716
|
if an error has occurred (e.g. invalid offset, not implemented). </p></td>
|
717
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
717
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
718
718
|
</tr>
|
719
719
|
<tr>
|
720
720
|
<td class="parameter_name"><p>end_offset</p></td>
|
721
721
|
<td class="parameter_description"><p> the offset of the first character after the returned string,
|
722
722
|
or -1 if an error has occurred (e.g. invalid offset, not implemented). </p></td>
|
723
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
723
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
724
724
|
</tr>
|
725
725
|
</tbody>
|
726
726
|
</table></div>
|
@@ -733,7 +733,7 @@ bounded by the specified <em class="parameter"><code>granularity</code></em>
|
|
733
733
|
. Use
|
734
734
|
<code class="function">g_free()</code> to free the returned string. Returns <code class="literal">NULL</code> if the
|
735
735
|
offset is invalid or no implementation is available. </p>
|
736
|
-
<p><span class="annotation">[<
|
736
|
+
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
737
737
|
</div>
|
738
738
|
<p class="since">Since: 2.10</p>
|
739
739
|
</div>
|
@@ -798,22 +798,22 @@ atk_text_get_character_extents (<em class="parameter"><code><a class="link" href
|
|
798
798
|
<tr>
|
799
799
|
<td class="parameter_name"><p>x</p></td>
|
800
800
|
<td class="parameter_description"><p> Pointer for the x cordinate of the bounding box. </p></td>
|
801
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
801
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
|
802
802
|
</tr>
|
803
803
|
<tr>
|
804
804
|
<td class="parameter_name"><p>y</p></td>
|
805
805
|
<td class="parameter_description"><p> Pointer for the y cordinate of the bounding box. </p></td>
|
806
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
806
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
|
807
807
|
</tr>
|
808
808
|
<tr>
|
809
809
|
<td class="parameter_name"><p>width</p></td>
|
810
810
|
<td class="parameter_description"><p> Pointer for the width of the bounding box. </p></td>
|
811
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
811
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
|
812
812
|
</tr>
|
813
813
|
<tr>
|
814
814
|
<td class="parameter_name"><p>height</p></td>
|
815
815
|
<td class="parameter_description"><p> Pointer for the height of the bounding box. </p></td>
|
816
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
816
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
|
817
817
|
</tr>
|
818
818
|
<tr>
|
819
819
|
<td class="parameter_name"><p>coords</p></td>
|
@@ -867,12 +867,12 @@ the character to be inserted at the caret location.</p></td>
|
|
867
867
|
<tr>
|
868
868
|
<td class="parameter_name"><p>start_offset</p></td>
|
869
869
|
<td class="parameter_description"><p> the address to put the start offset of the range. </p></td>
|
870
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
870
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
871
871
|
</tr>
|
872
872
|
<tr>
|
873
873
|
<td class="parameter_name"><p>end_offset</p></td>
|
874
874
|
<td class="parameter_description"><p> the address to put the end offset of the range. </p></td>
|
875
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
875
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
876
876
|
</tr>
|
877
877
|
</tbody>
|
878
878
|
</table></div>
|
@@ -883,7 +883,7 @@ the character to be inserted at the caret location.</p></td>
|
|
883
883
|
explicitly set at <em class="parameter"><code>offset</code></em>
|
884
884
|
. This <a class="link" href="AtkObject.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> should be freed by a call
|
885
885
|
to <a class="link" href="AtkText.html#atk-attribute-set-free" title="atk_attribute_set_free ()"><code class="function">atk_attribute_set_free()</code></a>. </p>
|
886
|
-
<p><span class="annotation">[<
|
886
|
+
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
887
887
|
</div>
|
888
888
|
</div>
|
889
889
|
<hr>
|
@@ -916,7 +916,7 @@ returned.</p>
|
|
916
916
|
values of attributes. at <em class="parameter"><code>offset</code></em>
|
917
917
|
. this <span class="type">atkattributeset</span> should be freed by
|
918
918
|
a call to <a class="link" href="AtkText.html#atk-attribute-set-free" title="atk_attribute_set_free ()"><code class="function">atk_attribute_set_free()</code></a>. </p>
|
919
|
-
<p><span class="annotation">[<
|
919
|
+
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
920
920
|
</div>
|
921
921
|
</div>
|
922
922
|
<hr>
|
@@ -1053,7 +1053,7 @@ atk_text_get_bounded_ranges (<em class="parameter"><code><a class="link" href="A
|
|
1053
1053
|
<a name="atk-text-get-bounded-ranges.returns"></a><h4>Returns</h4>
|
1054
1054
|
<p> Array of AtkTextRange. The last
|
1055
1055
|
element of the array returned by this function will be NULL. </p>
|
1056
|
-
<p><span class="annotation">[<
|
1056
|
+
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></p>
|
1057
1057
|
</div>
|
1058
1058
|
<p class="since">Since: 1.3</p>
|
1059
1059
|
</div>
|
@@ -1101,7 +1101,7 @@ for which boundary information is required.</p></td>
|
|
1101
1101
|
<tr>
|
1102
1102
|
<td class="parameter_name"><p>rect</p></td>
|
1103
1103
|
<td class="parameter_description"><p> A pointer to a AtkTextRectangle which is filled in by this function. </p></td>
|
1104
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
1104
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
1105
1105
|
</tr>
|
1106
1106
|
</tbody>
|
1107
1107
|
</table></div>
|
@@ -1128,7 +1128,7 @@ and is NULL terminated.</p>
|
|
1128
1128
|
<td class="parameter_name"><p>ranges</p></td>
|
1129
1129
|
<td class="parameter_description"><p> A pointer to an array of <a class="link" href="AtkText.html#AtkTextRange" title="struct AtkTextRange"><span class="type">AtkTextRange</span></a> which is
|
1130
1130
|
to be freed. </p></td>
|
1131
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
1131
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>]</span></td>
|
1132
1132
|
</tr></tbody>
|
1133
1133
|
</table></div>
|
1134
1134
|
</div>
|
@@ -1196,13 +1196,13 @@ moving or deleting a selected region can change the numbering.</p></td>
|
|
1196
1196
|
<tr>
|
1197
1197
|
<td class="parameter_name"><p>start_offset</p></td>
|
1198
1198
|
<td class="parameter_description"><p> passes back the start position of the selected region. </p></td>
|
1199
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
1199
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
1200
1200
|
</tr>
|
1201
1201
|
<tr>
|
1202
1202
|
<td class="parameter_name"><p>end_offset</p></td>
|
1203
1203
|
<td class="parameter_description"><p> passes back the end position of (e.g. offset immediately past)
|
1204
1204
|
the selected region. </p></td>
|
1205
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
1205
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
1206
1206
|
</tr>
|
1207
1207
|
</tbody>
|
1208
1208
|
</table></div>
|
@@ -1516,7 +1516,7 @@ atk_text_attribute_get_value (<em class="parameter"><code><a class="link" href="
|
|
1516
1516
|
<p> a string containing the value; this string
|
1517
1517
|
should not be freed; <code class="literal">NULL</code> is returned if there are no values
|
1518
1518
|
maintained for the attr value. </p>
|
1519
|
-
<p><span class="annotation">[<
|
1519
|
+
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
1520
1520
|
</div>
|
1521
1521
|
</div>
|
1522
1522
|
</div>
|
@@ -256,6 +256,7 @@ implementation, subscribe to the <a class="link" href="AtkObject.html#AtkObject-
|
|
256
256
|
</div>
|
257
257
|
<p>Adds the specified function to the list of functions to be called
|
258
258
|
when an object receives focus.</p>
|
259
|
+
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
|
259
260
|
<div class="refsect3">
|
260
261
|
<a name="atk-add-focus-tracker.parameters"></a><h4>Parameters</h4>
|
261
262
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
@@ -320,6 +321,7 @@ to be implemented by ATK itself.</p>
|
|
320
321
|
This function should be called by an implementation of the
|
321
322
|
ATK interface if any specific work needs to be done to enable
|
322
323
|
focus tracking.</p>
|
324
|
+
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
|
323
325
|
<div class="refsect3">
|
324
326
|
<a name="atk-focus-tracker-init.parameters"></a><h4>Parameters</h4>
|
325
327
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
@@ -437,6 +439,7 @@ before calling this method. A simple way to do that is creating an
|
|
437
439
|
instance of <a class="link" href="AtkNoOpObject.html" title="AtkNoOpObject"><span class="type">AtkNoOpObject</span></a>. This class implements all ATK
|
438
440
|
interfaces, so creating the instance will register all ATK types as
|
439
441
|
a collateral effect.</p>
|
442
|
+
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
|
440
443
|
<div class="refsect3">
|
441
444
|
<a name="atk-add-global-event-listener.parameters"></a><h4>Parameters</h4>
|
442
445
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
@@ -546,6 +549,7 @@ atk_add_key_event_listener (<em class="parameter"><code><a class="link" href="At
|
|
546
549
|
<a class="link" href="AtkUtil.html#AtkKeySnoopFunc" title="AtkKeySnoopFunc ()"><span class="type">AtkKeySnoopFunc</span></a> (<em class="parameter"><code>listener</code></em>
|
547
550
|
) as the <em class="parameter"><code>func_data</code></em>
|
548
551
|
param, on notification.</p>
|
552
|
+
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
|
549
553
|
<div class="refsect3">
|
550
554
|
<a name="atk-add-key-event-listener.parameters"></a><h4>Parameters</h4>
|
551
555
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
@@ -609,7 +613,7 @@ atk_get_root (<em class="parameter"><code><span class="type">void</span></code><
|
|
609
613
|
<a name="atk-get-root.returns"></a><h4>Returns</h4>
|
610
614
|
<p> the root accessible container for the current
|
611
615
|
application. </p>
|
612
|
-
<p><span class="annotation">[<
|
616
|
+
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
613
617
|
</div>
|
614
618
|
</div>
|
615
619
|
<hr>
|
@@ -622,7 +626,7 @@ atk_get_focus_object (<em class="parameter"><code><span class="type">void</span>
|
|
622
626
|
<a name="atk-get-focus-object.returns"></a><h4>Returns</h4>
|
623
627
|
<p> the currently focused object for the current
|
624
628
|
application. </p>
|
625
|
-
<p><span class="annotation">[<
|
629
|
+
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
626
630
|
</div>
|
627
631
|
<p class="since">Since: 1.6</p>
|
628
632
|
</div>
|
@@ -176,38 +176,33 @@ range controls, as well as dials, should have <a class="link" href="AtkObject.ht
|
|
176
176
|
representations which implement <a class="link" href="AtkValue.html" title="AtkValue"><span class="type">AtkValue</span></a> on the component's
|
177
177
|
behalf. <span class="type">AtKValues</span> may be read-only, in which case attempts to
|
178
178
|
alter the value return would fail.</p>
|
179
|
-
<
|
180
|
-
|
181
|
-
|
179
|
+
<p><refsect1 id="current-value-text">
|
180
|
+
<title>On the subject of current value text</title>
|
181
|
+
<para>
|
182
182
|
In addition to providing the current value, implementors can
|
183
183
|
optionally provide an end-user-consumable textual description
|
184
184
|
associated with this value. This description should be included
|
185
185
|
when the numeric value fails to convey the full, on-screen
|
186
186
|
representation seen by users.
|
187
|
-
|
188
|
-
<
|
189
|
-
|
190
|
-
<div class="example-contents">
|
187
|
+
</para></p>
|
188
|
+
<p><example>
|
189
|
+
<title>Password strength</title>
|
191
190
|
A password strength meter whose value changes as the user types
|
192
191
|
their new password. Red is used for values less than 4.0, yellow
|
193
192
|
for values between 4.0 and 7.0, and green for values greater than
|
194
193
|
7.0. In this instance, value text should be provided by the
|
195
194
|
implementor. Appropriate value text would be "weak", "acceptable,"
|
196
195
|
and "strong" respectively.
|
197
|
-
|
198
|
-
|
199
|
-
<br class="example-break">
|
200
|
-
|
201
|
-
A level bar whose value changes to reflect the battery charge. The
|
196
|
+
</example></p>
|
197
|
+
<p>A level bar whose value changes to reflect the battery charge. The
|
202
198
|
color remains the same regardless of the charge and there is no
|
203
199
|
on-screen text reflecting the fullness of the battery. In this
|
204
200
|
case, because the position within the bar is the only indication
|
205
201
|
the user has of the current charge, value text should not be
|
206
|
-
provided by the implementor
|
207
|
-
|
208
|
-
|
209
|
-
|
210
|
-
<p>
|
202
|
+
provided by the implementor.</p>
|
203
|
+
<p><refsect2 id="implementor-notes">
|
204
|
+
<title>Implementor Notes</title>
|
205
|
+
<para>
|
211
206
|
Implementors should bear in mind that assistive technologies will
|
212
207
|
likely prefer the value text provided over the numeric value when
|
213
208
|
presenting a widget's value. As a result, strings not intended for
|
@@ -217,93 +212,93 @@ display value text on screen, for instance through a separate label
|
|
217
212
|
in close proximity to the value-displaying widget, it is still
|
218
213
|
expected that implementors will expose the value text using the
|
219
214
|
above API.
|
220
|
-
|
221
|
-
<p
|
215
|
+
</para></p>
|
216
|
+
<p><para>
|
222
217
|
<a class="link" href="AtkValue.html" title="AtkValue"><span class="type">AtkValue</span></a> should NOT be implemented for widgets whose displayed
|
223
218
|
value is not reflective of a meaningful amount. For instance, a
|
224
219
|
progress pulse indicator whose value alternates between 0.0 and 1.0
|
225
220
|
to indicate that some process is still taking place should not
|
226
221
|
implement <a class="link" href="AtkValue.html" title="AtkValue"><span class="type">AtkValue</span></a> because the current value does not reflect
|
227
222
|
progress towards completion.
|
228
|
-
|
229
|
-
|
230
|
-
|
231
|
-
<
|
232
|
-
|
233
|
-
|
223
|
+
</para>
|
224
|
+
</refsect2>
|
225
|
+
</refsect1></p>
|
226
|
+
<p><refsect1 id="ranges">
|
227
|
+
<title>On the subject of ranges</title>
|
228
|
+
<para>
|
234
229
|
In addition to providing the minimum and maximum values,
|
235
230
|
implementors can optionally provide details about subranges
|
236
231
|
associated with the widget. These details should be provided by the
|
237
232
|
implementor when both of the following are communicated visually to
|
238
233
|
the end user:
|
239
|
-
|
240
|
-
|
241
|
-
|
234
|
+
</para>
|
235
|
+
<itemizedlist>
|
236
|
+
<listitem>The existence of distinct ranges such as "weak",
|
242
237
|
"acceptable", and "strong" indicated by color, bar tick marks,
|
243
|
-
and/or on-screen text
|
244
|
-
|
238
|
+
and/or on-screen text.</listitem>
|
239
|
+
<listitem>Where the current value stands within a given subrange,
|
245
240
|
for instance illustrating progression from very "weak" towards
|
246
241
|
nearly "acceptable" through changes in shade and/or position on
|
247
|
-
the bar within the "weak" subrange
|
248
|
-
|
249
|
-
|
242
|
+
the bar within the "weak" subrange.</listitem>
|
243
|
+
</itemizedlist>
|
244
|
+
<para>
|
250
245
|
If both of the above do not apply to the widget, it should be
|
251
246
|
sufficient to expose the numeric value, along with the value text
|
252
247
|
if appropriate, to make the widget accessible.
|
253
|
-
|
254
|
-
<
|
255
|
-
|
256
|
-
|
248
|
+
</para></p>
|
249
|
+
<p><refsect2 id="ranges-implementor-notes">
|
250
|
+
<title>Implementor Notes</title>
|
251
|
+
<para>
|
257
252
|
If providing subrange details is deemed necessary, all possible
|
258
253
|
values of the widget are expected to fall within one of the
|
259
254
|
subranges defined by the implementor.
|
260
|
-
|
261
|
-
|
262
|
-
|
263
|
-
<
|
264
|
-
|
265
|
-
values
|
266
|
-
|
255
|
+
</para>
|
256
|
+
</refsect2>
|
257
|
+
</refsect1></p>
|
258
|
+
<p><refsect1 id="localization">
|
259
|
+
<title>On the subject of localization of end-user-consumable text
|
260
|
+
values</title>
|
261
|
+
<para>
|
267
262
|
Because value text and subrange descriptors are human-consumable,
|
268
263
|
implementors are expected to provide localized strings which can be
|
269
264
|
directly presented to end users via their assistive technology. In
|
270
265
|
order to simplify this for implementors, implementors can use
|
271
266
|
<code class="function">atk_value_type_get_localized_name()</code> with the following
|
272
267
|
already-localized constants for commonly-needed values can be used:
|
273
|
-
|
274
|
-
<
|
275
|
-
|
276
|
-
|
277
|
-
|
278
|
-
|
279
|
-
|
280
|
-
|
281
|
-
|
282
|
-
|
283
|
-
|
284
|
-
|
285
|
-
|
286
|
-
|
287
|
-
|
288
|
-
|
289
|
-
|
290
|
-
|
291
|
-
|
292
|
-
|
293
|
-
|
294
|
-
|
268
|
+
</para></p>
|
269
|
+
<p><itemizedlist>
|
270
|
+
<listitem>ATK_VALUE_VERY_WEAK</listitem>
|
271
|
+
<listitem>ATK_VALUE_WEAK</listitem>
|
272
|
+
<listitem>ATK_VALUE_ACCEPTABLE</listitem>
|
273
|
+
<listitem>ATK_VALUE_STRONG</listitem>
|
274
|
+
<listitem>ATK_VALUE_VERY_STRONG</listitem>
|
275
|
+
<listitem>ATK_VALUE_VERY_LOW</listitem>
|
276
|
+
<listitem>ATK_VALUE_LOW</listitem>
|
277
|
+
<listitem>ATK_VALUE_MEDIUM</listitem>
|
278
|
+
<listitem>ATK_VALUE_HIGH</listitem>
|
279
|
+
<listitem>ATK_VALUE_VERY_HIGH</listitem>
|
280
|
+
<listitem>ATK_VALUE_VERY_BAD</listitem>
|
281
|
+
<listitem>ATK_VALUE_BAD</listitem>
|
282
|
+
<listitem>ATK_VALUE_GOOD</listitem>
|
283
|
+
<listitem>ATK_VALUE_VERY_GOOD</listitem>
|
284
|
+
<listitem>ATK_VALUE_BEST</listitem>
|
285
|
+
<listitem>ATK_VALUE_SUBSUBOPTIMAL</listitem>
|
286
|
+
<listitem>ATK_VALUE_SUBOPTIMAL</listitem>
|
287
|
+
<listitem>ATK_VALUE_OPTIMAL</listitem>
|
288
|
+
</itemizedlist>
|
289
|
+
<para>
|
295
290
|
Proposals for additional constants, along with their use cases,
|
296
291
|
should be submitted to the GNOME Accessibility Team.
|
297
|
-
|
298
|
-
|
299
|
-
<
|
300
|
-
|
301
|
-
|
292
|
+
</para>
|
293
|
+
</refsect1></p>
|
294
|
+
<p><refsect1 id="changes">
|
295
|
+
<title>On the subject of changes</title>
|
296
|
+
<para>
|
302
297
|
Note that if there is a textual description associated with the new
|
303
298
|
numeric value, that description should be included regardless of
|
304
299
|
whether or not it has also changed.
|
305
|
-
|
306
|
-
|
300
|
+
</para>
|
301
|
+
</refsect1></p>
|
307
302
|
</div>
|
308
303
|
<div class="refsect1">
|
309
304
|
<a name="AtkValue.functions_details"></a><h2>Functions</h2>
|
@@ -335,7 +330,7 @@ instead.</p>
|
|
335
330
|
<tr>
|
336
331
|
<td class="parameter_name"><p>value</p></td>
|
337
332
|
<td class="parameter_description"><p> a <span class="type">GValue</span> representing the current accessible value. </p></td>
|
338
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
333
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
339
334
|
</tr>
|
340
335
|
</tbody>
|
341
336
|
</table></div>
|
@@ -369,7 +364,7 @@ atk_value_get_maximum_value (<em class="parameter"><code><a class="link" href="A
|
|
369
364
|
<tr>
|
370
365
|
<td class="parameter_name"><p>value</p></td>
|
371
366
|
<td class="parameter_description"><p> a <span class="type">GValue</span> representing the maximum accessible value. </p></td>
|
372
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
367
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
373
368
|
</tr>
|
374
369
|
</tbody>
|
375
370
|
</table></div>
|
@@ -403,7 +398,7 @@ atk_value_get_minimum_value (<em class="parameter"><code><a class="link" href="A
|
|
403
398
|
<tr>
|
404
399
|
<td class="parameter_name"><p>value</p></td>
|
405
400
|
<td class="parameter_description"><p> a <span class="type">GValue</span> representing the minimum accessible value. </p></td>
|
406
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
401
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
407
402
|
</tr>
|
408
403
|
</tbody>
|
409
404
|
</table></div>
|
@@ -477,7 +472,7 @@ floating point precision of the platform.</p>
|
|
477
472
|
<tr>
|
478
473
|
<td class="parameter_name"><p>value</p></td>
|
479
474
|
<td class="parameter_description"><p> a <span class="type">GValue</span> representing the minimum increment by which the accessible value may be changed. </p></td>
|
480
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
475
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
481
476
|
</tr>
|
482
477
|
</tbody>
|
483
478
|
</table></div>
|
@@ -514,14 +509,14 @@ caller. Can be NULL if no descriptor is available.</p>
|
|
514
509
|
<td class="parameter_name"><p>value</p></td>
|
515
510
|
<td class="parameter_description"><p> address of <span class="type">gdouble</span> to put the current value of <em class="parameter"><code>obj</code></em>
|
516
511
|
. </p></td>
|
517
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
512
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
518
513
|
</tr>
|
519
514
|
<tr>
|
520
515
|
<td class="parameter_name"><p>text</p></td>
|
521
516
|
<td class="parameter_description"><p> address of <span class="type">gchar</span> to put the human
|
522
517
|
readable text alternative for <em class="parameter"><code>value</code></em>
|
523
518
|
. </p></td>
|
524
|
-
<td class="parameter_annotations"><span class="annotation">[<
|
519
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
525
520
|
</tr>
|
526
521
|
</tbody>
|
527
522
|
</table></div>
|
@@ -555,7 +550,7 @@ atk_value_get_range (<em class="parameter"><code><a class="link" href="AtkValue.
|
|
555
550
|
that represents the minimum, maximum and descriptor (if available)
|
556
551
|
of <em class="parameter"><code>obj</code></em>
|
557
552
|
. NULL if that range is not defined. </p>
|
558
|
-
<p><span class="annotation">[<
|
553
|
+
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
559
554
|
</div>
|
560
555
|
<p class="since">Since: 2.12</p>
|
561
556
|
</div>
|
@@ -617,7 +612,7 @@ introduction for examples of subranges and when to expose them.</p>
|
|
617
612
|
<p> an <span class="type">GSList</span> of
|
618
613
|
<span class="type">AtkRange</span> which each of the subranges defined for this object. Free
|
619
614
|
the returns list with <code class="function">g_slist_free()</code>. </p>
|
620
|
-
<p><span class="annotation">[<
|
615
|
+
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AtkRange][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
621
616
|
</div>
|
622
617
|
<p class="since">Since: 2.12</p>
|
623
618
|
</div>
|