atk 3.1.8-x64-mingw32 → 3.1.9-x64-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.
- 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>
|