2
<function name="atk_text_get_selection">
4
Gets the text from the specified selection.
9
<parameter name="text">
10
<parameter_description> an #AtkText
11
</parameter_description>
13
<parameter name="selection_num">
14
<parameter_description> The selection number. The selected regions are
15
assigned numbers that correspond to how far the region is from the
16
start of the text. The selected region closest to the beginning
17
of the text region is assigned the number 0, etc. Note that adding,
18
moving or deleting a selected region can change the numbering.
19
</parameter_description>
21
<parameter name="start_offset">
22
<parameter_description> passes back the start position of the selected region
23
</parameter_description>
25
<parameter name="end_offset">
26
<parameter_description> passes back the end position of (e.g. offset immediately past)
28
</parameter_description>
31
<return> the selected text.
35
<function name="atk_image_get_image_position">
37
Gets the position of the image in the form of a point specifying the
38
images top-left corner.
42
<parameter name="image">
43
<parameter_description> a #GObject instance that implements AtkImageIface
44
</parameter_description>
47
<parameter_description> address of #gint to put x coordinate position; otherwise, -1 if value cannot be obtained.
48
</parameter_description>
51
<parameter_description> address of #gint to put y coordinate position; otherwise, -1 if value cannot be obtained.
52
</parameter_description>
54
<parameter name="coord_type">
55
<parameter_description> specifies whether the coordinates are relative to the screen
56
or to the components top level window
57
</parameter_description>
63
<function name="atk_table_set_column_header">
65
Sets the specified column header to @header.
69
<parameter name="table">
70
<parameter_description> a GObject instance that implements AtkTableIface
71
</parameter_description>
73
<parameter name="column">
74
<parameter_description> a #gint representing a column in @table
75
</parameter_description>
77
<parameter name="header">
78
<parameter_description> an #AtkTable
79
</parameter_description>
85
<function name="atk_table_is_row_selected">
87
Gets a boolean value indicating whether the specified @row
93
<parameter name="table">
94
<parameter_description> a GObject instance that implements AtkTableIface
95
</parameter_description>
97
<parameter name="row">
98
<parameter_description> a #gint representing a row in @table
99
</parameter_description>
102
<return> a gboolean representing if the row is selected, or 0
103
if value does not implement this interface.
107
<function name="atk_table_get_n_rows">
109
Gets the number of rows in the table.
114
<parameter name="table">
115
<parameter_description> a GObject instance that implements AtkTableIface
116
</parameter_description>
119
<return> a gint representing the number of rows, or 0
120
if value does not implement this interface.
124
<function name="atk_object_ref_state_set">
126
Gets a reference to the state set of the accessible; the caller must
127
unreference it when it is no longer needed.
132
<parameter name="accessible">
133
<parameter_description> an #AtkObject
134
</parameter_description>
137
<return> a reference to an #AtkStateSet which is the state
138
set of the accessible
142
<function name="atk_hyperlink_get_n_anchors">
144
Gets the number of anchors associated with this hyperlink.
149
<parameter name="link_">
150
<parameter_description> an #AtkHyperlink
151
</parameter_description>
154
<return> the number of anchors associated with this hyperlink
158
<function name="atk_object_set_description">
160
Sets the accessible description of the accessible.
164
<parameter name="accessible">
165
<parameter_description> an #AtkObject
166
</parameter_description>
168
<parameter name="description">
169
<parameter_description> a character string to be set as the accessible description
170
</parameter_description>
176
<function name="atk_state_type_register">
178
Register a new object state.
183
<parameter name="name">
184
<parameter_description> a character string describing the new state.
185
</parameter_description>
188
<return> an #AtkState value for the new state.
192
<function name="atk_component_get_mdi_zorder">
194
Gets the zorder of the component. The value G_MININT will be returned
195
if the layer of the component is not ATK_LAYER_MDI or ATK_LAYER_WINDOW.
200
<parameter name="component">
201
<parameter_description> an #AtkComponent
202
</parameter_description>
205
<return> a gint which is the zorder of the component, i.e. the depth at
206
which the component is shown in relation to other components in the same
211
<function name="atk_focus_tracker_notify">
213
Cause the focus tracker functions which have been specified to be
214
executed for the object.
218
<parameter name="object">
219
<parameter_description> an #AtkObject
220
</parameter_description>
226
<function name="atk_image_set_image_description">
228
Sets the textual description for this image.
233
<parameter name="image">
234
<parameter_description> a #GObject instance that implements AtkImageIface
235
</parameter_description>
237
<parameter name="description">
238
<parameter_description> a string description to set for @image
239
</parameter_description>
242
<return> boolean TRUE, or FALSE if operation could
247
<function name="atk_state_type_get_name">
249
Gets the description string describing the #AtkStateType @type.
254
<parameter name="type">
255
<parameter_description> The #AtkStateType whose name is required
256
</parameter_description>
259
<return> the string describing the AtkStateType
263
<function name="atk_hyperlink_get_start_index">
265
Gets the index with the hypertext document at which this link begins.
270
<parameter name="link_">
271
<parameter_description> an #AtkHyperlink
272
</parameter_description>
275
<return> the index with the hypertext document at which this link begins
279
<function name="atk_object_get_layer">
281
Gets the layer of the accessible.
283
Deprecated: Use atk_component_get_layer instead.
288
<parameter name="accessible">
289
<parameter_description> an #AtkObject
290
</parameter_description>
293
<return> an #AtkLayer which is the layer of the accessible
297
<function name="atk_table_get_column_header">
299
Gets the column header of a specified column in an accessible table.
304
<parameter name="table">
305
<parameter_description> a GObject instance that implements AtkTableIface
306
</parameter_description>
308
<parameter name="column">
309
<parameter_description> a #gint representing a column in the table
310
</parameter_description>
313
<return> a AtkObject* representing the specified column header, or
314
%NULL if value does not implement this interface.
318
<function name="atk_implementor_ref_accessible">
320
Gets a reference to an object's #AtkObject implementation, if
321
the object implements #AtkObjectIface
326
<parameter name="implementor">
327
<parameter_description> The #GObject instance which should implement #AtkImplementorIface
328
if a non-null return value is required.
329
</parameter_description>
332
<return> a reference to an object's #AtkObject implementation
336
<function name="atk_hyperlink_is_valid">
338
Since the document that a link is associated with may have changed
339
this method returns %TRUE if the link is still valid (with
340
respect to the document it references) and %FALSE otherwise.
345
<parameter name="link_">
346
<parameter_description> an #AtkHyperlink
347
</parameter_description>
350
<return> whether or not this link is still valid
354
<function name="atk_text_get_offset_at_point">
356
Gets the offset of the character located at coordinates @x and @y. @x and @y
357
are interpreted as being relative to the screen or this widget's window
358
depending on @coords.
363
<parameter name="text">
364
<parameter_description> an #AtkText
365
</parameter_description>
368
<parameter_description> screen x-position of character
369
</parameter_description>
372
<parameter_description> screen y-position of character
373
</parameter_description>
375
<parameter name="coords">
376
<parameter_description> specify whether coordinates are relative to the screen or
378
</parameter_description>
381
<return> the offset to the character which is located at
382
the specified @x and @y coordinates.
386
<function name="atk_object_set_role">
388
Sets the role of the accessible.
392
<parameter name="accessible">
393
<parameter_description> an #AtkObject
394
</parameter_description>
396
<parameter name="role">
397
<parameter_description> an #AtkRole to be set as the role
398
</parameter_description>
404
<function name="atk_text_get_n_selections">
406
Gets the number of selected regions.
411
<parameter name="text">
412
<parameter_description> an #AtkText
413
</parameter_description>
416
<return> The number of selected regions, or -1 if a failure
421
<function name="atk_hyperlink_impl_get_hyperlink">
423
Gets the hyperlink associated with this object.
429
<parameter name="obj">
430
<parameter_description> a GObject instance that implements AtkHyperlinkImplIface
431
</parameter_description>
434
<return>an AtkHyperlink object which points to this implementing AtkObject.
439
<function name="atk_text_get_run_attributes">
441
Creates an #AtkAttributeSet which consists of the attributes explicitly
442
set at the position @offset in the text. @start_offset and @end_offset are
443
set to the start and end of the range around @offset where the attributes are
444
invariant. Note that @end_offset is the offset of the first character
445
after the range. See the enum AtkTextAttribute for types of text
446
attributes that can be returned. Note that other attributes may also be
452
<parameter name="text">
453
<parameter_description> an #AtkText
454
</parameter_description>
456
<parameter name="offset">
457
<parameter_description> the offset at which to get the attributes, -1 means the offset of
458
the character to be inserted at the caret location.
459
</parameter_description>
461
<parameter name="start_offset">
462
<parameter_description> the address to put the start offset of the range
463
</parameter_description>
465
<parameter name="end_offset">
466
<parameter_description> the address to put the end offset of the range
467
</parameter_description>
470
<return> an #AtkAttributeSet which contains the attributes explicitly set
471
at @offset. This #AtkAttributeSet should be freed by a call to
472
atk_attribute_set_free().
476
<function name="atk_table_get_caption">
478
Gets the caption for the @table.
483
<parameter name="table">
484
<parameter_description> a GObject instance that implements AtkTableInterface
485
</parameter_description>
488
<return> a AtkObject* representing the table caption, or %NULL
489
if value does not implement this interface.
493
<function name="atk_component_ref_accessible_at_point">
495
Gets a reference to the accessible child, if one exists, at the
496
coordinate point specified by @x and @y.
501
<parameter name="component">
502
<parameter_description> the #AtkComponent
503
</parameter_description>
506
<parameter_description> x coordinate
507
</parameter_description>
510
<parameter_description> y coordinate
511
</parameter_description>
513
<parameter name="coord_type">
514
<parameter_description> specifies whether the coordinates are relative to the screen
515
or to the components top level window
516
</parameter_description>
519
<return> a reference to the accessible child, if one exists
523
<function name="atk_add_focus_tracker">
525
Adds the specified function to the list of functions to be called
526
when an object receives focus.
531
<parameter name="focus_tracker">
532
<parameter_description> Function to be added to the list of functions to be called
533
when an object receives focus.
534
</parameter_description>
537
<return> added focus tracker id, or 0 on failure.
541
<function name="atk_table_set_summary">
543
Sets the summary description of the table.
547
<parameter name="table">
548
<parameter_description> a GObject instance that implements AtkTableIface
549
</parameter_description>
551
<parameter name="accessible">
552
<parameter_description> an #AtkObject representing the summary description
554
</parameter_description>
560
<function name="atk_component_add_focus_handler">
562
Add the specified handler to the set of functions to be called
563
when this object receives focus events (in or out). If the handler is
564
already added it is not added again
569
<parameter name="component">
570
<parameter_description> The #AtkComponent to attach the @handler to
571
</parameter_description>
573
<parameter name="handler">
574
<parameter_description> The #AtkFocusHandler to be attached to @component
575
</parameter_description>
578
<return> a handler id which can be used in atk_component_remove_focus_handler
579
or zero if the handler was already added.
583
<function name="atk_editable_text_cut_text">
585
Copy text from @start_pos up to, but not including @end_pos
586
to the clipboard and then delete from the widget.
590
<parameter name="text">
591
<parameter_description> an #AtkEditableText
592
</parameter_description>
594
<parameter name="start_pos">
595
<parameter_description> start position
596
</parameter_description>
598
<parameter name="end_pos">
599
<parameter_description> end position
600
</parameter_description>
606
<function name="atk_gobject_accessible_for_object">
608
Gets the accessible object for the specified @obj.
613
<parameter name="obj">
614
<parameter_description> a #GObject
615
</parameter_description>
618
<return> a #AtkObject which is the accessible object for the @obj
622
<function name="atk_table_get_column_description">
624
Gets the description text of the specified @column in the table
629
<parameter name="table">
630
<parameter_description> a GObject instance that implements AtkTableIface
631
</parameter_description>
633
<parameter name="column">
634
<parameter_description> a #gint representing a column in @table
635
</parameter_description>
638
<return> a gchar* representing the column description, or %NULL
639
if value does not implement this interface.
643
<function name="atk_text_get_character_at_offset">
645
Gets the specified text.
650
<parameter name="text">
651
<parameter_description> an #AtkText
652
</parameter_description>
654
<parameter name="offset">
655
<parameter_description> position
656
</parameter_description>
659
<return> the character at @offset.
663
<function name="atk_no_op_object_factory_new">
665
Creates an instance of an #AtkObjectFactory which generates primitive
666
(non-functioning) #AtkObjects.
672
<return> an instance of an #AtkObjectFactory
676
<function name="atk_value_get_minimum_increment">
678
Gets the minimum increment by which the value of this object may be changed. If zero,
679
the minimum increment is undefined, which may mean that it is limited only by the
680
floating point precision of the platform.
686
<parameter name="obj">
687
<parameter_description> a GObject instance that implements AtkValueIface
688
</parameter_description>
690
<parameter name="value">
691
<parameter_description> a #GValue representing the minimum increment by which the accessible value may be changed
692
</parameter_description>
698
<function name="atk_role_get_name">
700
Gets the description string describing the #AtkRole @role.
705
<parameter name="role">
706
<parameter_description> The #AtkRole whose name is required
707
</parameter_description>
710
<return> the string describing the AtkRole
714
<function name="atk_object_get_attributes">
716
Get a list of properties applied to this object as a whole, as an #AtkAttributeSet consisting of
717
name-value pairs. As such these attributes may be considered weakly-typed properties or annotations,
718
as distinct from strongly-typed object data available via other get/set methods.
719
Not all objects have explicit "name-value pair" #AtkAttributeSet properties.
726
<parameter name="accessible">
727
<parameter_description> An #AtkObject.
728
</parameter_description>
731
<return> an #AtkAttributeSet consisting of all explicit properties/annotations applied to
732
the object, or an empty set if the object has no name-value pair attributes assigned to it.
736
<function name="atk_text_get_default_attributes">
738
Creates an #AtkAttributeSet which consists of the default values of
739
attributes for the text. See the enum AtkTextAttribute for types of text
740
attributes that can be returned. Note that other attributes may also be
746
<parameter name="text">
747
<parameter_description> an #AtkText
748
</parameter_description>
751
<return> an #AtkAttributeSet which contains the default values of attributes.
752
at @offset. This #AtkAttributeSet should be freed by a call to
753
atk_attribute_set_free().
757
<function name="atk_text_set_selection">
759
Changes the start and end offset of the specified selection.
764
<parameter name="text">
765
<parameter_description> an #AtkText
766
</parameter_description>
768
<parameter name="selection_num">
769
<parameter_description> The selection number. The selected regions are
770
assigned numbers that correspond to how far the region is from the
771
start of the text. The selected region closest to the beginning
772
of the text region is assigned the number 0, etc. Note that adding,
773
moving or deleting a selected region can change the numbering.
774
</parameter_description>
776
<parameter name="start_offset">
777
<parameter_description> the new start position of the selection
778
</parameter_description>
780
<parameter name="end_offset">
781
<parameter_description> the new end position of (e.g. offset immediately past)
783
</parameter_description>
786
<return> %TRUE if success, %FALSE otherwise
790
<function name="atk_streamable_content_get_n_mime_types">
792
Gets the number of mime types supported by this object.
797
<parameter name="streamable">
798
<parameter_description> a GObject instance that implements AtkStreamableContentIface
799
</parameter_description>
802
<return> a gint which is the number of mime types supported by the object.
806
<function name="atk_relation_get_relation_type">
808
Gets the type of @relation
813
<parameter name="relation">
814
<parameter_description> an #AtkRelation
815
</parameter_description>
818
<return> the type of @relation
822
<function name="atk_editable_text_paste_text">
824
Paste text from clipboard to specified @position.
828
<parameter name="text">
829
<parameter_description> an #AtkEditableText
830
</parameter_description>
832
<parameter name="position">
833
<parameter_description> position to paste
834
</parameter_description>
840
<function name="atk_misc_threads_enter">
842
Take the thread mutex for the GUI toolkit,
844
(This method is implemented by the toolkit ATK implementation layer;
845
for instance, for GTK+, GAIL implements this via GDK_THREADS_ENTER).
852
<parameter name="misc">
853
<parameter_description> an AtkMisc instance for this application.
854
</parameter_description>
860
<function name="atk_object_factory_get_accessible_type">
862
Gets the GType of the accessible which is created by the factory.
866
<parameter name="factory">
867
<parameter_description> an #AtkObjectFactory
868
</parameter_description>
871
<return> the type of the accessible which is created by the @factory.
872
The value G_TYPE_INVALID is returned if no type if found.
876
<function name="atk_component_get_layer">
878
Gets the layer of the component.
883
<parameter name="component">
884
<parameter_description> an #AtkComponent
885
</parameter_description>
888
<return> an #AtkLayer which is the layer of the component
892
<function name="atk_text_get_range_extents">
894
Get the bounding box for text within the specified range.
900
<parameter name="text">
901
<parameter_description> an #AtkText
902
</parameter_description>
904
<parameter name="start_offset">
905
<parameter_description> The offset of the first text character for which boundary
906
information is required.
907
</parameter_description>
909
<parameter name="end_offset">
910
<parameter_description> The offset of the text character after the last character
911
for which boundary information is required.
912
</parameter_description>
914
<parameter name="coord_type">
915
<parameter_description> Specify whether coordinates are relative to the screen or widget window.
916
</parameter_description>
918
<parameter name="rect">
919
<parameter_description> A pointer to a AtkTextRectangle which is filled in by this function.
920
</parameter_description>
926
<function name="atk_table_get_column_at_index">
928
Gets a #gint representing the column at the specified @index_.
933
<parameter name="table">
934
<parameter_description> a GObject instance that implements AtkTableInterface
935
</parameter_description>
937
<parameter name="index_">
938
<parameter_description> a #gint representing an index in @table
939
</parameter_description>
942
<return> a gint representing the column at the specified index,
943
or -1 if the table does not implement this interface
947
<function name="atk_object_get_parent">
949
Gets the accessible parent of the accessible.
954
<parameter name="accessible">
955
<parameter_description> an #AtkObject
956
</parameter_description>
959
<return> a #AtkObject representing the accessible parent of the accessible
963
<function name="atk_selection_is_child_selected">
965
Determines if the current child of this object is selected
966
Note: callers should not rely on %NULL or on a zero value for
967
indication of whether AtkSelectionIface is implemented, they should
968
use type checking/interface checking macros or the
969
atk_get_accessible_value() convenience method.
974
<parameter name="selection">
975
<parameter_description> a #GObject instance that implements AtkSelectionIface
976
</parameter_description>
979
<parameter_description> a #gint specifying the child index.
980
</parameter_description>
983
<return> a gboolean representing the specified child is selected, or 0
984
if @selection does not implement this interface.
988
<function name="atk_table_is_column_selected">
990
Gets a boolean value indicating whether the specified @column
996
<parameter name="table">
997
<parameter_description> a GObject instance that implements AtkTableIface
998
</parameter_description>
1000
<parameter name="column">
1001
<parameter_description> a #gint representing a column in @table
1002
</parameter_description>
1005
<return> a gboolean representing if the column is selected, or 0
1006
if value does not implement this interface.
1010
<function name="atk_text_get_character_count">
1012
Gets the character count.
1017
<parameter name="text">
1018
<parameter_description> an #AtkText
1019
</parameter_description>
1022
<return> the number of characters.
1026
<function name="atk_relation_type_get_name">
1028
Gets the description string describing the #AtkRelationType @type.
1033
<parameter name="type">
1034
<parameter_description> The #AtkRelationType whose name is required
1035
</parameter_description>
1038
<return> the string describing the AtkRelationType
1042
<function name="atk_table_set_row_header">
1044
Sets the specified row header to @header.
1048
<parameter name="table">
1049
<parameter_description> a GObject instance that implements AtkTableIface
1050
</parameter_description>
1052
<parameter name="row">
1053
<parameter_description> a #gint representing a row in @table
1054
</parameter_description>
1056
<parameter name="header">
1057
<parameter_description> an #AtkTable
1058
</parameter_description>
1064
<function name="atk_gobject_accessible_get_object">
1066
Gets the GObject for which @obj is the accessible object.
1071
<parameter name="obj">
1072
<parameter_description> a #AtkGObjectAccessible
1073
</parameter_description>
1076
<return> a #GObject which is the object for which @obj is the accessible object
1080
<function name="atk_relation_set_new">
1082
Creates a new empty relation set.
1088
<return> a new #AtkRelationSet
1092
<function name="atk_text_attribute_register">
1094
Associate @name with a new #AtkTextAttribute
1099
<parameter name="name">
1100
<parameter_description> a name string
1101
</parameter_description>
1104
<return> an #AtkTextAttribute associated with @name
1108
<function name="atk_object_connect_property_change_handler">
1110
Specifies a function to be called when a property changes value.
1115
<parameter name="accessible">
1116
<parameter_description> an #AtkObject
1117
</parameter_description>
1119
<parameter name="handler">
1120
<parameter_description> a function to be called when a property changes its value
1121
</parameter_description>
1124
<return> a #guint which is the handler id used in
1125
atk_object_remove_property_change_handler()
1129
<function name="atk_object_set_name">
1131
Sets the accessible name of the accessible.
1135
<parameter name="accessible">
1136
<parameter_description> an #AtkObject
1137
</parameter_description>
1139
<parameter name="name">
1140
<parameter_description> a character string to be set as the accessible name
1141
</parameter_description>
1147
<function name="atk_hyperlink_is_selected_link">
1149
Determines whether this AtkHyperlink is selected
1153
@Deprecated: This method is deprecated since ATK version 1.8.
1154
Please use ATK_STATE_SELECTED to indicate when a hyperlink within a
1155
Hypertext container is selected.
1160
<parameter name="link_">
1161
<parameter_description> an #AtkHyperlink
1162
</parameter_description>
1165
<return> True is the AtkHyperlink is selected, False otherwise
1169
<function name="atk_object_ref_accessible_child">
1171
Gets a reference to the specified accessible child of the object.
1172
The accessible children are 0-based so the first accessible child is
1173
at index 0, the second at index 1 and so on.
1178
<parameter name="accessible">
1179
<parameter_description> an #AtkObject
1180
</parameter_description>
1182
<parameter name="i">
1183
<parameter_description> a gint representing the position of the child, starting from 0
1184
</parameter_description>
1187
<return> an #AtkObject representing the specified accessible child
1192
<function name="atk_document_get_attribute_value">
1199
<parameter name="document">
1200
<parameter_description> a #GObject instance that implements AtkDocumentIface
1201
</parameter_description>
1203
<parameter name="attribute_name">
1204
<parameter_description> a character string representing the name of the attribute
1205
whose value is being queried.
1206
</parameter_description>
1209
<return> a string value associated with the named attribute for this
1210
document, or NULL if a value for #attribute_name has not been specified
1215
<function name="atk_relation_set_get_relation">
1217
Determines the relation at the specified position in the relation set.
1222
<parameter name="set">
1223
<parameter_description> an #AtkRelationSet
1224
</parameter_description>
1226
<parameter name="i">
1227
<parameter_description> a gint representing a position in the set, starting from 0.
1228
</parameter_description>
1231
<return> a #AtkRelation, which is the relation at position i in the set.
1235
<function name="atk_table_remove_row_selection">
1237
Removes the specified @row from the selection.
1242
<parameter name="table">
1243
<parameter_description> a GObject instance that implements AtkTableIface
1244
</parameter_description>
1246
<parameter name="row">
1247
<parameter_description> a #gint representing a row in @table
1248
</parameter_description>
1251
<return> a gboolean representing if the row was successfully removed from
1252
the selection, or 0 if value does not implement this interface.
1256
<function name="atk_state_set_remove_state">
1258
Removes the state for the specified type from the state set.
1263
<parameter name="set">
1264
<parameter_description> an #AtkStateSet
1265
</parameter_description>
1267
<parameter name="type">
1268
<parameter_description> an #AtkType
1269
</parameter_description>
1272
<return> %TRUE if @type was the state type is in @set.
1276
<function name="atk_text_attribute_for_name">
1278
Get the #AtkTextAttribute type corresponding to a text attribute name.
1283
<parameter name="name">
1284
<parameter_description> a string which is the (non-localized) name of an ATK text attribute.
1285
</parameter_description>
1288
<return> the #AtkTextAttribute enumerated type corresponding to the specified
1290
or #ATK_TEXT_ATTRIBUTE_INVALID if no matching text attribute is found.
1294
<function name="atk_image_get_image_description">
1296
Get a textual description of this image.
1301
<parameter name="image">
1302
<parameter_description> a #GObject instance that implements AtkImageIface
1303
</parameter_description>
1306
<return> a string representing the image description
1310
<function name="atk_document_get_document">
1312
Gets a %gpointer that points to an instance of the DOM. It is
1313
up to the caller to check atk_document_get_type to determine
1314
how to cast this pointer.
1319
<parameter name="document">
1320
<parameter_description> a #GObject instance that implements AtkDocumentIface
1321
</parameter_description>
1324
<return> a %gpointer that points to an instance of the DOM.
1328
<function name="atk_selection_ref_selection">
1330
Gets a reference to the accessible object representing the specified
1331
selected child of the object.
1332
Note: callers should not rely on %NULL or on a zero value for
1333
indication of whether AtkSelectionIface is implemented, they should
1334
use type checking/interface checking macros or the
1335
atk_get_accessible_value() convenience method.
1340
<parameter name="selection">
1341
<parameter_description> a #GObject instance that implements AtkSelectionIface
1342
</parameter_description>
1344
<parameter name="i">
1345
<parameter_description> a #gint specifying the index in the selection set. (e.g. the
1346
ith selection as opposed to the ith child).
1347
</parameter_description>
1350
<return> an #AtkObject representing the selected accessible , or %NULL
1351
if @selection does not implement this interface.
1355
<function name="atk_remove_focus_tracker">
1357
Removes the specified focus tracker from the list of functions
1358
to be called when any object receives focus.
1362
<parameter name="tracker_id">
1363
<parameter_description> the id of the focus tracker to remove
1364
</parameter_description>
1370
<function name="atk_component_grab_focus">
1372
Grabs focus for this @component.
1377
<parameter name="component">
1378
<parameter_description> an #AtkComponent
1379
</parameter_description>
1382
<return> %TRUE if successful, %FALSE otherwise.
1386
<function name="atk_relation_type_register">
1388
Associate @name with a new #AtkRelationType
1393
<parameter name="name">
1394
<parameter_description> a name string
1395
</parameter_description>
1398
<return> an #AtkRelationType associated with @name
1402
<function name="atk_editable_text_set_text_contents">
1404
Set text contents of @text.
1408
<parameter name="text">
1409
<parameter_description> an #AtkEditableText
1410
</parameter_description>
1412
<parameter name="string">
1413
<parameter_description> string to set for text contents of @text
1414
</parameter_description>
1420
<function name="atk_relation_set_add_relation_by_type">
1422
Add a new relation of the specified type with the specified target to
1423
the current relation set if the relation set does not contain a relation
1424
of that type. If it is does contain a relation of that typea the target
1425
is added to the relation.
1431
<parameter name="set">
1432
<parameter_description> an #AtkRelationSet
1433
</parameter_description>
1435
<parameter name="relationship">
1436
<parameter_description> an #AtkRelationType
1437
</parameter_description>
1439
<parameter name="target">
1440
<parameter_description> an #AtkObject
1441
</parameter_description>
1447
<function name="atk_object_get_role">
1449
Gets the role of the accessible.
1454
<parameter name="accessible">
1455
<parameter_description> an #AtkObject
1456
</parameter_description>
1459
<return> an #AtkRole which is the role of the accessible
1463
<function name="atk_add_key_event_listener">
1465
Adds the specified function to the list of functions to be called
1466
when a key event occurs. The @data element will be passed to the
1467
#AtkKeySnoopFunc (@listener) as the @func_data param, on notification.
1472
<parameter name="listener">
1473
<parameter_description> the listener to notify
1474
</parameter_description>
1476
<parameter name="data">
1477
<parameter_description> a #gpointer that points to a block of data that should be sent to the registered listeners,
1478
along with the event notification, when it occurs.
1479
</parameter_description>
1482
<return> added event listener id, or 0 on failure.
1486
<function name="atk_object_notify_state_change">
1488
Emits a state-change signal for the specified state.
1492
<parameter name="accessible">
1493
<parameter_description> an #AtkObject
1494
</parameter_description>
1496
<parameter name="state">
1497
<parameter_description> an #AtkState whose state is changed
1498
</parameter_description>
1500
<parameter name="value">
1501
<parameter_description> a gboolean which indicates whether the state is being set on or off
1502
</parameter_description>
1508
<function name="atk_table_add_row_selection">
1510
Adds the specified @row to the selection.
1515
<parameter name="table">
1516
<parameter_description> a GObject instance that implements AtkTableIface
1517
</parameter_description>
1519
<parameter name="row">
1520
<parameter_description> a #gint representing a row in @table
1521
</parameter_description>
1524
<return> a gboolean representing if row was successfully added to selection,
1525
or 0 if value does not implement this interface.
1529
<function name="atk_document_get_document_type">
1531
Gets a string indicating the document type.
1536
<parameter name="document">
1537
<parameter_description> a #GObject instance that implements AtkDocumentIface
1538
</parameter_description>
1541
<return> a string indicating the document type
1545
<function name="atk_no_op_object_new">
1547
Provides a default (non-functioning stub) #AtkObject.
1548
Application maintainers should not use this method.
1553
<parameter name="obj">
1554
<parameter_description> a #GObject
1555
</parameter_description>
1558
<return> a default (non-functioning stub) #AtkObject
1562
<function name="atk_get_root">
1564
Gets the root accessible container for the current application.
1570
<return> the root accessible container for the current application
1574
<function name="atk_relation_remove_target">
1576
Remove the specified AtkObject from the target for the relation.
1581
<parameter name="relation">
1582
<parameter_description> an #AtkRelation
1583
</parameter_description>
1585
<parameter name="target">
1586
<parameter_description> an #AtkObject
1587
</parameter_description>
1590
<return>TRUE if the removal is successful.
1594
<function name="atk_editable_text_copy_text">
1596
Copy text from @start_pos up to, but not including @end_pos
1601
<parameter name="text">
1602
<parameter_description> an #AtkEditableText
1603
</parameter_description>
1605
<parameter name="start_pos">
1606
<parameter_description> start position
1607
</parameter_description>
1609
<parameter name="end_pos">
1610
<parameter_description> end position
1611
</parameter_description>
1617
<function name="atk_object_ref_relation_set">
1619
Gets the #AtkRelationSet associated with the object.
1624
<parameter name="accessible">
1625
<parameter_description> an #AtkObject
1626
</parameter_description>
1629
<return> an #AtkRelationSet representing the relation set of the object.
1633
<function name="atk_object_factory_create_accessible">
1635
Provides an #AtkObject that implements an accessibility interface
1641
<parameter name="factory">
1642
<parameter_description> The #AtkObjectFactory associated with @obj's
1644
</parameter_description>
1646
<parameter name="obj">
1647
<parameter_description> a #GObject
1648
</parameter_description>
1651
<return> an #AtkObject that implements an accessibility interface
1656
<function name="atk_table_get_selected_rows">
1658
Gets the selected rows of the table by initializing **selected with
1659
the selected row numbers. This array should be freed by the caller.
1664
<parameter name="table">
1665
<parameter_description> a GObject instance that implements AtkTableIface
1666
</parameter_description>
1668
<parameter name="selected">
1669
<parameter_description> a #gint** that is to contain the selected row numbers
1670
</parameter_description>
1673
<return> a gint representing the number of selected rows,
1674
or zero if value does not implement this interface.
1678
<function name="atk_state_set_clear_states">
1680
Removes all states from the state set.
1684
<parameter name="set">
1685
<parameter_description> an #AtkStateSet
1686
</parameter_description>
1692
<function name="atk_object_get_index_in_parent">
1694
Gets the 0-based index of this accessible in its parent; returns -1 if the
1695
accessible does not have an accessible parent.
1700
<parameter name="accessible">
1701
<parameter_description> an #AtkObject
1702
</parameter_description>
1705
<return> an integer which is the index of the accessible in its parent
1709
<function name="atk_text_get_text_at_offset">
1711
Gets the specified text.
1713
If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character at the
1716
If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string
1717
is from the word start at or before the offset to the word start after
1720
The returned string will contain the word at the offset if the offset
1721
is inside a word and will contain the word before the offset if the
1722
offset is not inside a word.
1724
If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string
1725
is from the word end before the offset to the word end at or after the
1728
The returned string will contain the word at the offset if the offset
1729
is inside a word and will contain the word after to the offset if the
1730
offset is not inside a word.
1732
If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned
1733
string is from the sentence start at or before the offset to the sentence
1734
start after the offset.
1736
The returned string will contain the sentence at the offset if the offset
1737
is inside a sentence and will contain the sentence before the offset
1738
if the offset is not inside a sentence.
1740
If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string
1741
is from the sentence end before the offset to the sentence end at or
1744
The returned string will contain the sentence at the offset if the offset
1745
is inside a sentence and will contain the sentence after the offset
1746
if the offset is not inside a sentence.
1748
If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned
1749
string is from the line start at or before the offset to the line
1750
start after the offset.
1752
If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string
1753
is from the line end before the offset to the line end at or after
1759
<parameter name="text">
1760
<parameter_description> an #AtkText
1761
</parameter_description>
1763
<parameter name="offset">
1764
<parameter_description> position
1765
</parameter_description>
1767
<parameter name="boundary_type">
1768
<parameter_description> An #AtkTextBoundary
1769
</parameter_description>
1771
<parameter name="start_offset">
1772
<parameter_description> the start offset of the returned string
1773
</parameter_description>
1775
<parameter name="end_offset">
1776
<parameter_description> the offset of the first character after the
1778
</parameter_description>
1781
<return> the text at @offset bounded by the specified @boundary_type.
1785
<function name="atk_table_add_column_selection">
1787
Adds the specified @column to the selection.
1792
<parameter name="table">
1793
<parameter_description> a GObject instance that implements AtkTableIface
1794
</parameter_description>
1796
<parameter name="column">
1797
<parameter_description> a #gint representing a column in @table
1798
</parameter_description>
1801
<return> a gboolean representing if the column was successfully added to
1802
the selection, or 0 if value does not implement this interface.
1806
<function name="atk_value_get_minimum_value">
1808
Gets the minimum value of this object.
1812
<parameter name="obj">
1813
<parameter_description> a GObject instance that implements AtkValueIface
1814
</parameter_description>
1816
<parameter name="value">
1817
<parameter_description> a #GValue representing the minimum accessible value
1818
</parameter_description>
1824
<function name="atk_relation_get_target">
1826
Gets the target list of @relation
1831
<parameter name="relation">
1832
<parameter_description> an #AtkRelation
1833
</parameter_description>
1836
<return> the target list of @relation
1840
<function name="atk_get_focus_object">
1842
Gets the currently focused object.
1850
<return> the currently focused object for the current application
1854
<function name="atk_hypertext_get_link">
1856
Gets the link in this hypertext document at index
1862
<parameter name="hypertext">
1863
<parameter_description> an #AtkHypertext
1864
</parameter_description>
1866
<parameter name="link_index">
1867
<parameter_description> an integer specifying the desired link
1868
</parameter_description>
1871
<return> the link in this hypertext document at
1876
<function name="atk_object_remove_relationship">
1878
Removes a relationship of the specified type with the specified target.
1883
<parameter name="object">
1884
<parameter_description> The #AtkObject from which an AtkRelation is to be removed.
1885
</parameter_description>
1887
<parameter name="relationship">
1888
<parameter_description> The #AtkRelationType of the relation
1889
</parameter_description>
1891
<parameter name="target">
1892
<parameter_description> The #AtkObject which is the target of the relation to be removed.
1893
</parameter_description>
1896
<return>TRUE if the relationship is removed.
1900
<function name="atk_text_attribute_get_value">
1902
Gets the value for the index of the #AtkTextAttribute
1907
<parameter name="attr">
1908
<parameter_description> The #AtkTextAttribute for which a value is required
1909
</parameter_description>
1911
<parameter name="index_">
1912
<parameter_description> The index of the required value
1913
</parameter_description>
1916
<return> a string containing the value; this string should not be freed;
1917
NULL is returned if there are no values maintained for the attr value.
1921
<function name="atk_component_contains">
1923
Checks whether the specified point is within the extent of the @component.
1928
<parameter name="component">
1929
<parameter_description> the #AtkComponent
1930
</parameter_description>
1932
<parameter name="x">
1933
<parameter_description> x coordinate
1934
</parameter_description>
1936
<parameter name="y">
1937
<parameter_description> y coordinate
1938
</parameter_description>
1940
<parameter name="coord_type">
1941
<parameter_description> specifies whether the coordinates are relative to the screen
1942
or to the components top level window
1943
</parameter_description>
1946
<return> %TRUE or %FALSE indicating whether the specified point is within
1947
the extent of the @component or not
1951
<function name="atk_value_get_maximum_value">
1953
Gets the maximum value of this object.
1957
<parameter name="obj">
1958
<parameter_description> a GObject instance that implements AtkValueIface
1959
</parameter_description>
1961
<parameter name="value">
1962
<parameter_description> a #GValue representing the maximum accessible value
1963
</parameter_description>
1969
<function name="atk_component_set_extents">
1971
Sets the extents of @component.
1976
<parameter name="component">
1977
<parameter_description> an #AtkComponent
1978
</parameter_description>
1980
<parameter name="x">
1981
<parameter_description> x coordinate
1982
</parameter_description>
1984
<parameter name="y">
1985
<parameter_description> y coordinate
1986
</parameter_description>
1988
<parameter name="width">
1989
<parameter_description> width to set for @component
1990
</parameter_description>
1992
<parameter name="height">
1993
<parameter_description> height to set for @component
1994
</parameter_description>
1996
<parameter name="coord_type">
1997
<parameter_description> specifies whether the coordinates are relative to the screen
1998
or to the components top level window
1999
</parameter_description>
2002
<return> %TRUE or %FALSE whether the extents were set or not
2006
<function name="atk_relation_new">
2008
Create a new relation for the specified key and the specified list
2009
of targets. See also atk_object_add_relationship().
2014
<parameter name="targets">
2015
<parameter_description> an array of pointers to #AtkObjects
2016
</parameter_description>
2018
<parameter name="n_targets">
2019
<parameter_description> number of #AtkObjects pointed to by @targets
2020
</parameter_description>
2022
<parameter name="relationship">
2023
<parameter_description> an #AtkRelationType with which to create the new
2025
</parameter_description>
2028
<return> a pointer to a new #AtkRelation
2032
<function name="atk_object_get_n_accessible_children">
2034
Gets the number of accessible children of the accessible.
2039
<parameter name="accessible">
2040
<parameter_description> an #AtkObject
2041
</parameter_description>
2044
<return> an integer representing the number of accessible children
2049
<function name="atk_document_set_attribute_value">
2056
<parameter name="document">
2057
<parameter_description> a #GObject instance that implements AtkDocumentIface
2058
</parameter_description>
2060
<parameter name="attribute_name">
2061
<parameter_description> a character string representing the name of the attribute
2062
whose value is being set.
2063
</parameter_description>
2065
<parameter name="attribute_value">
2066
<parameter_description> a string value to be associated with #attribute_name.
2067
</parameter_description>
2070
<return> TRUE if #value is successfully associated with #attribute_name
2071
for this document, FALSE otherwise (e.g. if the document does not
2072
allow the attribute to be modified).
2076
<function name="atk_state_set_contains_states">
2078
Checks whether the states for all the specified types are in the
2084
<parameter name="set">
2085
<parameter_description> an #AtkStateSet
2086
</parameter_description>
2088
<parameter name="types">
2089
<parameter_description> an array of #AtkStateType
2090
</parameter_description>
2092
<parameter name="n_types">
2093
<parameter_description> The number of elements in the array
2094
</parameter_description>
2097
<return> %TRUE if all the states for @type are in @set.
2101
<function name="atk_table_set_row_description">
2103
Sets the description text for the specified @row of @table.
2107
<parameter name="table">
2108
<parameter_description> a GObject instance that implements AtkTableIface
2109
</parameter_description>
2111
<parameter name="row">
2112
<parameter_description> a #gint representing a row in @table
2113
</parameter_description>
2115
<parameter name="description">
2116
<parameter_description> a #gchar representing the description text
2117
to set for the specified @row of @table
2118
</parameter_description>
2124
<function name="atk_object_initialize">
2126
This function is called when implementing subclasses of #AtkObject.
2127
It does initialization required for the new object. It is intended
2128
that this function should called only in the ..._new() functions used
2129
to create an instance of a subclass of #AtkObject
2133
<parameter name="accessible">
2134
<parameter_description> a #AtkObject
2135
</parameter_description>
2137
<parameter name="data">
2138
<parameter_description> a #gpointer which identifies the object for which the AtkObject was created.
2139
</parameter_description>
2145
<function name="atk_table_is_selected">
2147
Gets a boolean value indicating whether the accessible object
2148
at the specified @row and @column is selected
2153
<parameter name="table">
2154
<parameter_description> a GObject instance that implements AtkTableIface
2155
</parameter_description>
2157
<parameter name="row">
2158
<parameter_description> a #gint representing a row in @table
2159
</parameter_description>
2161
<parameter name="column">
2162
<parameter_description> a #gint representing a column in @table
2163
</parameter_description>
2166
<return> a gboolean representing if the cell is selected, or 0
2167
if value does not implement this interface.
2171
<function name="atk_selection_select_all_selection">
2173
Causes every child of the object to be selected if the object
2174
supports multiple selections.
2179
<parameter name="selection">
2180
<parameter_description> a #GObject instance that implements AtkSelectionIface
2181
</parameter_description>
2184
<return> TRUE if success, FALSE otherwise.
2188
<function name="atk_selection_clear_selection">
2190
Clears the selection in the object so that no children in the object
2196
<parameter name="selection">
2197
<parameter_description> a #GObject instance that implements AtkSelectionIface
2198
</parameter_description>
2201
<return> TRUE if success, FALSE otherwise.
2205
<function name="atk_registry_get_factory_type">
2207
Provides a #GType indicating the #AtkObjectFactory subclass
2208
associated with @type.
2213
<parameter name="registry">
2214
<parameter_description> an #AtkRegistry
2215
</parameter_description>
2217
<parameter name="type">
2218
<parameter_description> a #GType with which to look up the associated #AtkObjectFactory
2220
</parameter_description>
2223
<return> a #GType associated with type @type
2227
<function name="atk_focus_tracker_init">
2229
Specifies the function to be called for focus tracker initialization.
2230
This function should be called by an implementation of the
2231
ATK interface if any specific work needs to be done to enable
2236
<parameter name="init">
2237
<parameter_description> Function to be called for focus tracker initialization
2238
</parameter_description>
2244
<function name="atk_table_get_n_columns">
2246
Gets the number of columns in the table.
2251
<parameter name="table">
2252
<parameter_description> a GObject instance that implements AtkTableIface
2253
</parameter_description>
2256
<return> a gint representing the number of columns, or 0
2257
if value does not implement this interface.
2261
<function name="atk_text_get_bounded_ranges">
2263
Get the ranges of text in the specified bounding box.
2270
<parameter name="text">
2271
<parameter_description> an #AtkText
2272
</parameter_description>
2274
<parameter name="rect">
2275
<parameter_description> An AtkTextRectagle giving the dimensions of the bounding box.
2276
</parameter_description>
2278
<parameter name="coord_type">
2279
<parameter_description> Specify whether coordinates are relative to the screen or widget window.
2280
</parameter_description>
2282
<parameter name="x_clip_type">
2283
<parameter_description> Specify the horizontal clip type.
2284
</parameter_description>
2286
<parameter name="y_clip_type">
2287
<parameter_description> Specify the vertical clip type.
2288
</parameter_description>
2291
<return> Array of AtkTextRange. The last element of the array returned
2292
by this function will be NULL.
2296
<function name="atk_table_get_row_extent_at">
2298
Gets the number of rows occupied by the accessible object
2299
at a specified @row and @column in the @table.
2304
<parameter name="table">
2305
<parameter_description> a GObject instance that implements AtkTableIface
2306
</parameter_description>
2308
<parameter name="row">
2309
<parameter_description> a #gint representing a row in @table
2310
</parameter_description>
2312
<parameter name="column">
2313
<parameter_description> a #gint representing a column in @table
2314
</parameter_description>
2317
<return> a gint representing the row extent at specified position, or 0
2318
if value does not implement this interface.
2322
<function name="atk_text_add_selection">
2324
Adds a selection bounded by the specified offsets.
2329
<parameter name="text">
2330
<parameter_description> an #AtkText
2331
</parameter_description>
2333
<parameter name="start_offset">
2334
<parameter_description> the start position of the selected region
2335
</parameter_description>
2337
<parameter name="end_offset">
2338
<parameter_description> the offset of the first character after the selected region.
2339
</parameter_description>
2342
<return> %TRUE if success, %FALSE otherwise
2346
<function name="atk_object_get_description">
2348
Gets the accessible description of the accessible.
2353
<parameter name="accessible">
2354
<parameter_description> an #AtkObject
2355
</parameter_description>
2358
<return> a character string representing the accessible description
2364
<function name="atk_hyperlink_get_object">
2366
Returns the item associated with this hyperlinks nth anchor.
2367
For instance, the returned #AtkObject will implement #AtkText
2368
if @link_ is a text hyperlink, #AtkImage if @link_ is an image
2371
Multiple anchors are primarily used by client-side image maps.
2376
<parameter name="link_">
2377
<parameter_description> an #AtkHyperlink
2378
</parameter_description>
2380
<parameter name="i">
2381
<parameter_description> a (zero-index) integer specifying the desired anchor
2382
</parameter_description>
2385
<return> an #AtkObject associated with this hyperlinks i-th anchor
2389
<function name="atk_get_toolkit_name">
2391
Gets name string for the GUI toolkit implementing ATK for this application.
2397
<return> name string for the GUI toolkit implementing ATK for this application
2401
<function name="atk_relation_type_for_name">
2403
Get the #AtkRelationType type corresponding to a relation name.
2408
<parameter name="name">
2409
<parameter_description> a string which is the (non-localized) name of an ATK relation type.
2410
</parameter_description>
2413
<return> the #AtkRelationType enumerated type corresponding to the specified name,
2414
or #ATK_RELATION_NULL if no matching relation type is found.
2418
<function name="atk_table_set_caption">
2420
Sets the caption for the table.
2424
<parameter name="table">
2425
<parameter_description> a GObject instance that implements AtkTableIface
2426
</parameter_description>
2428
<parameter name="caption">
2429
<parameter_description> a #AtkObject representing the caption to set for @table
2430
</parameter_description>
2436
<function name="atk_misc_get_instance">
2438
Obtain the singleton instance of AtkMisc for this application.
2446
<return> The singleton instance of AtkMisc for this application.
2451
<function name="atk_object_get_mdi_zorder">
2453
Gets the zorder of the accessible. The value G_MININT will be returned
2454
if the layer of the accessible is not ATK_LAYER_MDI.
2456
Deprecated: Use atk_component_get_mdi_zorder instead.
2461
<parameter name="accessible">
2462
<parameter_description> an #AtkObject
2463
</parameter_description>
2466
<return> a gint which is the zorder of the accessible, i.e. the depth at
2467
which the component is shown in relation to other components in the same
2473
<function name="atk_component_get_position">
2475
Gets the position of @component in the form of
2476
a point specifying @component's top-left corner.
2480
<parameter name="component">
2481
<parameter_description> an #AtkComponent
2482
</parameter_description>
2484
<parameter name="x">
2485
<parameter_description> address of #gint to put x coordinate position
2486
</parameter_description>
2488
<parameter name="y">
2489
<parameter_description> address of #gint to put y coordinate position
2490
</parameter_description>
2492
<parameter name="coord_type">
2493
<parameter_description> specifies whether the coordinates are relative to the screen
2494
or to the components top level window
2495
</parameter_description>
2501
<function name="atk_streamable_content_get_stream">
2503
Gets the content in the specified mime type.
2508
<parameter name="streamable">
2509
<parameter_description> a GObject instance that implements AtkStreamableContentIface
2510
</parameter_description>
2512
<parameter name="mime_type">
2513
<parameter_description> a gchar* representing the mime type
2514
</parameter_description>
2517
<return> A #GIOChannel which contains the content in the specified mime
2522
<function name="atk_relation_set_contains">
2524
Determines whether the relation set contains a relation that matches the
2530
<parameter name="set">
2531
<parameter_description> an #AtkRelationSet
2532
</parameter_description>
2534
<parameter name="relationship">
2535
<parameter_description> an #AtkRelationType
2536
</parameter_description>
2539
<return> %TRUE if @relationship is the relationship type of a relation
2540
in @set, %FALSE otherwise
2544
<function name="atk_action_get_name">
2546
Returns a non-localized string naming the specified action of the
2547
object. This name is generally not descriptive of the end result
2548
of the action, but instead names the 'interaction type' which the
2549
object supports. By convention, the above strings should be used to
2550
represent the actions which correspond to the common point-and-click
2551
interaction techniques of the same name: i.e.
2552
"click", "press", "release", "drag", "drop", "popup", etc.
2553
The "popup" action should be used to pop up a context menu for the
2554
object, if one exists.
2556
For technical reasons, some toolkits cannot guarantee that the
2557
reported action is actually 'bound' to a nontrivial user event;
2558
i.e. the result of some actions via atk_action_do_action() may be
2564
<parameter name="action">
2565
<parameter_description> a #GObject instance that implements AtkActionIface
2566
</parameter_description>
2568
<parameter name="i">
2569
<parameter_description> the action index corresponding to the action to be performed
2570
</parameter_description>
2573
<return>a name string, or %NULL
2574
if @action does not implement this interface.
2578
<function name="atk_state_set_new">
2580
Creates a new empty state set.
2586
<return> a new #AtkStateSet
2590
<function name="atk_table_get_selected_columns">
2592
Gets the selected columns of the table by initializing **selected with
2593
the selected column numbers. This array should be freed by the caller.
2598
<parameter name="table">
2599
<parameter_description> a GObject instance that implements AtkTableIface
2600
</parameter_description>
2602
<parameter name="selected">
2603
<parameter_description> a #gint** that is to contain the selected columns numbers
2604
</parameter_description>
2607
<return> a gint representing the number of selected columns,
2608
or %0 if value does not implement this interface.
2612
<function name="atk_relation_add_target">
2614
Adds the specified AtkObject to the target for the relation, if it is
2615
not already present. See also atk_object_add_relationship().
2622
<parameter name="relation">
2623
<parameter_description> an #AtkRelation
2624
</parameter_description>
2626
<parameter name="target">
2627
<parameter_description> an #AtkObject
2628
</parameter_description>
2634
<function name="atk_plug_get_plug_id">
2636
Gets the unique ID of an #AtkPlug object, which can be used to embed inside
2637
of an #AtkSocket using atk_socket_embed().
2642
<parameter name="obj">
2643
<parameter_description> an #AtkPlug
2644
</parameter_description>
2647
<return> the unique ID for the plug
2651
<function name="atk_action_do_action">
2653
Perform the specified action on the object.
2658
<parameter name="action">
2659
<parameter_description> a #GObject instance that implements AtkActionIface
2660
</parameter_description>
2662
<parameter name="i">
2663
<parameter_description> the action index corresponding to the action to be performed
2664
</parameter_description>
2667
<return> %TRUE if success, %FALSE otherwise
2672
<function name="atk_streamable_content_get_uri">
2674
Get a string representing a URI in IETF standard format
2675
(see http://www.ietf.org/rfc/rfc2396.txt) from which the object's content
2676
may be streamed in the specified mime-type, if one is available.
2677
If mime_type is NULL, the URI for the default (and possibly only) mime-type is
2680
Note that it is possible for get_uri to return NULL but for
2681
get_stream to work nonetheless, since not all GIOChannels connect to URIs.
2687
<parameter name="streamable">
2688
<parameter_description> a GObject instance that implements AtkStreamableContentIface
2689
</parameter_description>
2691
<parameter name="mime_type">
2692
<parameter_description> a gchar* representing the mime type, or NULL to request a URI
2693
for the default mime type.
2694
</parameter_description>
2697
<return> Returns a string representing a URI, or NULL if no corresponding URI
2703
<function name="atk_hyperlink_is_inline">
2705
Indicates whether the link currently displays some or all of its
2706
content inline. Ordinary HTML links will usually return
2707
%FALSE, but an inline <src> HTML element will return
2713
<parameter name="link_">
2714
<parameter_description> an #AtkHyperlink
2715
</parameter_description>
2718
<return> whether or not this link displays its content inline.
2723
<function name="atk_table_get_row_header">
2725
Gets the row header of a specified row in an accessible table.
2730
<parameter name="table">
2731
<parameter_description> a GObject instance that implements AtkTableIface
2732
</parameter_description>
2734
<parameter name="row">
2735
<parameter_description> a #gint representing a row in the table
2736
</parameter_description>
2739
<return> a AtkObject* representing the specified row header, or
2740
%NULL if value does not implement this interface.
2744
<function name="atk_editable_text_insert_text">
2746
Insert text at a given position.
2750
<parameter name="text">
2751
<parameter_description> an #AtkEditableText
2752
</parameter_description>
2754
<parameter name="string">
2755
<parameter_description> the text to insert
2756
</parameter_description>
2758
<parameter name="length">
2759
<parameter_description> the length of text to insert, in bytes
2760
</parameter_description>
2762
<parameter name="position">
2763
<parameter_description> The caller initializes this to
2764
the position at which to insert the text. After the call it
2765
points at the position after the newly inserted text.
2766
</parameter_description>
2772
<function name="atk_role_for_name">
2774
Get the #AtkRole type corresponding to a rolew name.
2779
<parameter name="name">
2780
<parameter_description> a string which is the (non-localized) name of an ATK role.
2781
</parameter_description>
2784
<return> the #AtkRole enumerated type corresponding to the specified
2786
or #ATK_ROLE_INVALID if no matching role is found.
2790
<function name="atk_selection_remove_selection">
2792
Removes the specified child of the object from the object's selection.
2797
<parameter name="selection">
2798
<parameter_description> a #GObject instance that implements AtkSelectionIface
2799
</parameter_description>
2801
<parameter name="i">
2802
<parameter_description> a #gint specifying the index in the selection set. (e.g. the
2803
ith selection as opposed to the ith child).
2804
</parameter_description>
2807
<return> TRUE if success, FALSE otherwise.
2811
<function name="atk_text_free_ranges">
2813
Frees the memory associated with an array of AtkTextRange. It is assumed
2814
that the array was returned by the function atk_text_get_bounded_ranges
2815
and is NULL terminated.
2821
<parameter name="ranges">
2822
<parameter_description> A pointer to an array of #AtkTextRange which is to be freed.
2823
</parameter_description>
2829
<function name="atk_table_set_column_description">
2831
Sets the description text for the specified @column of the @table.
2835
<parameter name="table">
2836
<parameter_description> a GObject instance that implements AtkTableIface
2837
</parameter_description>
2839
<parameter name="column">
2840
<parameter_description> a #gint representing a column in @table
2841
</parameter_description>
2843
<parameter name="description">
2844
<parameter_description> a #gchar representing the description text
2845
to set for the specified @column of the @table
2846
</parameter_description>
2852
<function name="atk_component_set_position">
2854
Sets the postition of @component.
2859
<parameter name="component">
2860
<parameter_description> an #AtkComponent
2861
</parameter_description>
2863
<parameter name="x">
2864
<parameter_description> x coordinate
2865
</parameter_description>
2867
<parameter name="y">
2868
<parameter_description> y coordinate
2869
</parameter_description>
2871
<parameter name="coord_type">
2872
<parameter_description> specifies whether the coordinates are relative to the screen
2873
or to the components top level window
2874
</parameter_description>
2877
<return> %TRUE or %FALSE whether or not the position was set or not
2881
<function name="atk_editable_text_delete_text">
2883
Delete text @start_pos up to, but not including @end_pos.
2887
<parameter name="text">
2888
<parameter_description> an #AtkEditableText
2889
</parameter_description>
2891
<parameter name="start_pos">
2892
<parameter_description> start position
2893
</parameter_description>
2895
<parameter name="end_pos">
2896
<parameter_description> end position
2897
</parameter_description>
2903
<function name="atk_action_get_n_actions">
2905
Gets the number of accessible actions available on the object.
2906
If there are more than one, the first one is considered the
2907
"default" action of the object.
2912
<parameter name="action">
2913
<parameter_description> a #GObject instance that implements AtkActionIface
2914
</parameter_description>
2917
<return> a the number of actions, or 0 if @action does not
2918
implement this interface.
2922
<function name="atk_image_get_image_locale">
2929
<parameter name="image">
2930
<parameter_description> An #AtkImage
2931
</parameter_description>
2934
<return>a string corresponding to the POSIX LC_MESSAGES locale used by the image description, or NULL if the image does not specify a locale.
2939
<function name="atk_relation_set_remove">
2941
Removes a relation from the relation set.
2942
This function unref's the #AtkRelation so it will be deleted unless there
2943
is another reference to it.
2947
<parameter name="set">
2948
<parameter_description> an #AtkRelationSet
2949
</parameter_description>
2951
<parameter name="relation">
2952
<parameter_description> an #AtkRelation
2953
</parameter_description>
2959
<function name="atk_role_register">
2961
Registers the role specified by @name.
2966
<parameter name="name">
2967
<parameter_description> a character string describing the new role.
2968
</parameter_description>
2971
<return> an #AtkRole for the new role.
2975
<function name="atk_component_get_alpha">
2977
Returns the alpha value (i.e. the opacity) for this
2978
@component, on a scale from 0 (fully transparent) to 1.0
2985
<parameter name="component">
2986
<parameter_description> an #AtkComponent
2987
</parameter_description>
2990
<return> An alpha value from 0 to 1.0, inclusive.
2994
<function name="atk_document_get_locale">
2996
Gets a UTF-8 string indicating the POSIX-style LC_MESSAGES locale
2997
of the content of this document instance. Individual
2998
text substrings or images within this document may have
2999
a different locale, see atk_text_get_attributes and
3000
atk_image_get_image_locale.
3005
<parameter name="document">
3006
<parameter_description> a #GObject instance that implements AtkDocumentIface
3007
</parameter_description>
3010
<return> a UTF-8 string indicating the POSIX-style LC_MESSAGES
3011
locale of the document content as a whole, or NULL if
3012
the document content does not specify a locale.
3016
<function name="atk_text_get_text">
3018
Gets the specified text.
3023
<parameter name="text">
3024
<parameter_description> an #AtkText
3025
</parameter_description>
3027
<parameter name="start_offset">
3028
<parameter_description> start position
3029
</parameter_description>
3031
<parameter name="end_offset">
3032
<parameter_description> end position
3033
</parameter_description>
3036
<return> the text from @start_offset up to, but not including @end_offset.
3040
<function name="atk_document_get_attributes">
3042
Gets an AtkAttributeSet which describes document-wide
3043
attributes as name-value pairs.
3050
<parameter name="document">
3051
<parameter_description> a #GObject instance that implements AtkDocumentIface
3052
</parameter_description>
3055
<return> An AtkAttributeSet containing the explicitly
3056
set name-value-pair attributes associated with this document
3061
<function name="atk_image_get_image_size">
3063
Get the width and height in pixels for the specified image.
3064
The values of @width and @height are returned as -1 if the
3065
values cannot be obtained (for instance, if the object is not onscreen).
3069
<parameter name="image">
3070
<parameter_description> a #GObject instance that implements AtkImageIface
3071
</parameter_description>
3073
<parameter name="width">
3074
<parameter_description> filled with the image width, or -1 if the value cannot be obtained.
3075
</parameter_description>
3077
<parameter name="height">
3078
<parameter_description> filled with the image height, or -1 if the value cannot be obtained.
3079
</parameter_description>
3085
<function name="atk_state_set_contains_state">
3087
Checks whether the state for the specified type is in the specified set.
3092
<parameter name="set">
3093
<parameter_description> an #AtkStateSet
3094
</parameter_description>
3096
<parameter name="type">
3097
<parameter_description> an #AtkStateType
3098
</parameter_description>
3101
<return> %TRUE if @type is the state type is in @set.
3105
<function name="atk_hyperlink_get_end_index">
3107
Gets the index with the hypertext document at which this link ends.
3112
<parameter name="link_">
3113
<parameter_description> an #AtkHyperlink
3114
</parameter_description>
3117
<return> the index with the hypertext document at which this link ends
3121
<function name="atk_action_get_localized_name">
3123
Returns the localized name of the specified action of the object.
3128
<parameter name="action">
3129
<parameter_description> a #GObject instance that implements AtkActionIface
3130
</parameter_description>
3132
<parameter name="i">
3133
<parameter_description> the action index corresponding to the action to be performed
3134
</parameter_description>
3137
<return>a name string, or %NULL
3138
if @action does not implement this interface.
3142
<function name="atk_registry_set_factory_type">
3144
Associate an #AtkObjectFactory subclass with a #GType. Note:
3145
The associated @factory_type will thereafter be responsible for
3146
the creation of new #AtkObject implementations for instances
3147
appropriate for @type.
3151
<parameter name="registry">
3152
<parameter_description> the #AtkRegistry in which to register the type association
3153
</parameter_description>
3155
<parameter name="type">
3156
<parameter_description> an #AtkObject type
3157
</parameter_description>
3159
<parameter name="factory_type">
3160
<parameter_description> an #AtkObjectFactory type to associate with @type. Must
3161
implement AtkObject appropriate for @type.
3162
</parameter_description>
3168
<function name="atk_text_attribute_get_name">
3170
Gets the name corresponding to the #AtkTextAttribute
3175
<parameter name="attr">
3176
<parameter_description> The #AtkTextAttribute whose name is required
3177
</parameter_description>
3180
<return> a string containing the name; this string should not be freed
3184
<function name="atk_action_get_description">
3186
Returns a description of the specified action of the object.
3191
<parameter name="action">
3192
<parameter_description> a #GObject instance that implements AtkActionIface
3193
</parameter_description>
3195
<parameter name="i">
3196
<parameter_description> the action index corresponding to the action to be performed
3197
</parameter_description>
3200
<return>a description string, or %NULL
3201
if @action does not implement this interface.
3205
<function name="atk_attribute_set_free">
3207
Frees the memory used by an #AtkAttributeSet, including all its
3212
<parameter name="attrib_set">
3213
<parameter_description> The #AtkAttributeSet to free
3214
</parameter_description>
3220
<function name="atk_get_default_registry">
3222
Gets a default implementation of the #AtkObjectFactory/type
3224
Note: For most toolkit maintainers, this will be the correct
3225
registry for registering new #AtkObject factories. Following
3226
a call to this function, maintainers may call atk_registry_set_factory_type()
3227
to associate an #AtkObjectFactory subclass with the GType of objects
3228
for whom accessibility information will be provided.
3234
<return> a default implementation of the #AtkObjectFactory/type
3239
<function name="atk_action_get_keybinding">
3241
Returns a keybinding associated with this action, if one exists.
3242
The returned string is in the format "<a>;<b>;<c>"
3243
(i.e. semicolon-delimited), where <a> is the keybinding which
3244
activates the object if it is presently enabled onscreen,
3245
<b> corresponds to the keybinding or sequence of keys
3246
which invokes the action even if the relevant element is not
3247
currently posted on screen (for instance, for a menu item it
3248
posts the parent menus before invoking). The last token in the
3249
above string, if non-empty, represents a keyboard shortcut which
3250
invokes the same action without posting the component or its
3251
enclosing menus or dialogs.
3256
<parameter name="action">
3257
<parameter_description> a #GObject instance that implements AtkActionIface
3258
</parameter_description>
3260
<parameter name="i">
3261
<parameter_description> the action index corresponding to the action to be performed
3262
</parameter_description>
3265
<return>a string representing the available keybindings, or %NULL
3266
if there is no keybinding for this action.
3271
<function name="atk_text_get_text_before_offset">
3273
Gets the specified text.
3275
If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character before the
3278
If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string
3279
is from the word start before the word start before the offset to
3280
the word start before the offset.
3282
The returned string will contain the word before the offset if the offset
3283
is inside a word and will contain the word before the word before the
3284
offset if the offset is not inside a word.
3286
If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string
3287
is from the word end before the word end at or before the offset to the
3288
word end at or before the offset.
3290
The returned string will contain the word before the offset if the offset
3291
is inside a word or if the offset is not inside a word.
3293
If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned
3294
string is from the sentence start before the sentence start before
3295
the offset to the sentence start before the offset.
3297
The returned string will contain the sentence before the offset if the
3298
offset is inside a sentence and will contain the sentence before the
3299
sentence before the offset if the offset is not inside a sentence.
3301
If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string
3302
is from the sentence end before the sentence end at or before the offset to
3303
the sentence end at or before the offset.
3305
The returned string will contain the sentence before the offset if the
3306
offset is inside a sentence or if the offset is not inside a sentence.
3308
If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned
3309
string is from the line start before the line start ar or before the offset
3310
to the line start ar or before the offset.
3312
If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string
3313
is from the line end before the line end before the offset to the
3314
line end before the offset.
3319
<parameter name="text">
3320
<parameter_description> an #AtkText
3321
</parameter_description>
3323
<parameter name="offset">
3324
<parameter_description> position
3325
</parameter_description>
3327
<parameter name="boundary_type">
3328
<parameter_description> An #AtkTextBoundary
3329
</parameter_description>
3331
<parameter name="start_offset">
3332
<parameter_description> the start offset of the returned string
3333
</parameter_description>
3335
<parameter name="end_offset">
3336
<parameter_description> the offset of the first character after the
3338
</parameter_description>
3341
<return> the text before @offset bounded by the specified @boundary_type.
3345
<function name="atk_table_get_index_at">
3347
Gets a #gint representing the index at the specified @row and @column.
3352
<parameter name="table">
3353
<parameter_description> a GObject instance that implements AtkTableIface
3354
</parameter_description>
3356
<parameter name="row">
3357
<parameter_description> a #gint representing a row in @table
3358
</parameter_description>
3360
<parameter name="column">
3361
<parameter_description> a #gint representing a column in @table
3362
</parameter_description>
3365
<return> a #gint representing the index at specified position.
3366
The value -1 is returned if the object at row,column is not a child
3367
of table or table does not implement this interface.
3371
<function name="atk_object_set_parent">
3373
Sets the accessible parent of the accessible.
3377
<parameter name="accessible">
3378
<parameter_description> an #AtkObject
3379
</parameter_description>
3381
<parameter name="parent">
3382
<parameter_description> an #AtkObject to be set as the accessible parent
3383
</parameter_description>
3389
<function name="atk_text_remove_selection">
3391
Removes the specified selection.
3396
<parameter name="text">
3397
<parameter_description> an #AtkText
3398
</parameter_description>
3400
<parameter name="selection_num">
3401
<parameter_description> The selection number. The selected regions are
3402
assigned numbers that correspond to how far the region is from the
3403
start of the text. The selected region closest to the beginning
3404
of the text region is assigned the number 0, etc. Note that adding,
3405
moving or deleting a selected region can change the numbering.
3406
</parameter_description>
3409
<return> %TRUE if success, %FALSE otherwise
3413
<function name="atk_selection_get_selection_count">
3415
Gets the number of accessible children currently selected.
3416
Note: callers should not rely on %NULL or on a zero value for
3417
indication of whether AtkSelectionIface is implemented, they should
3418
use type checking/interface checking macros or the
3419
atk_get_accessible_value() convenience method.
3424
<parameter name="selection">
3425
<parameter_description> a #GObject instance that implements AtkSelectionIface
3426
</parameter_description>
3429
<return> a gint representing the number of items selected, or 0
3430
if @selection does not implement this interface.
3434
<function name="atk_get_toolkit_version">
3436
Gets version string for the GUI toolkit implementing ATK for this application.
3442
<return> version string for the GUI toolkit implementing ATK for this application
3446
<function name="atk_component_get_extents">
3448
Gets the rectangle which gives the extent of the @component.
3453
<parameter name="component">
3454
<parameter_description> an #AtkComponent
3455
</parameter_description>
3457
<parameter name="x">
3458
<parameter_description> address of #gint to put x coordinate
3459
</parameter_description>
3461
<parameter name="y">
3462
<parameter_description> address of #gint to put y coordinate
3463
</parameter_description>
3465
<parameter name="width">
3466
<parameter_description> address of #gint to put width
3467
</parameter_description>
3469
<parameter name="height">
3470
<parameter_description> address of #gint to put height
3471
</parameter_description>
3473
<parameter name="coord_type">
3474
<parameter_description> specifies whether the coordinates are relative to the screen
3475
or to the components top level window
3476
</parameter_description>
3482
<function name="atk_get_version">
3484
Gets the current version for ATK.
3490
<return> version string for ATK
3494
<function name="atk_registry_get_factory">
3496
Gets an #AtkObjectFactory appropriate for creating #AtkObjects
3497
appropriate for @type.
3502
<parameter name="registry">
3503
<parameter_description> an #AtkRegistry
3504
</parameter_description>
3506
<parameter name="type">
3507
<parameter_description> a #GType with which to look up the associated #AtkObjectFactory
3508
</parameter_description>
3511
<return> an #AtkObjectFactory appropriate for creating #AtkObjects
3512
appropriate for @type.
3516
<function name="atk_state_set_or_sets">
3518
Constructs the union of the two sets.
3523
<parameter name="set">
3524
<parameter_description> an #AtkStateSet
3525
</parameter_description>
3527
<parameter name="compare_set">
3528
<parameter_description> another #AtkStateSet
3529
</parameter_description>
3532
<return> a new #AtkStateSet which is the union of the two sets,
3533
returning %NULL is empty.
3537
<function name="atk_component_get_size">
3539
Gets the size of the @component in terms of width and height.
3543
<parameter name="component">
3544
<parameter_description> an #AtkComponent
3545
</parameter_description>
3547
<parameter name="width">
3548
<parameter_description> address of #gint to put width of @component
3549
</parameter_description>
3551
<parameter name="height">
3552
<parameter_description> address of #gint to put height of @component
3553
</parameter_description>
3559
<function name="atk_text_get_caret_offset">
3561
Gets the offset position of the caret (cursor).
3566
<parameter name="text">
3567
<parameter_description> an #AtkText
3568
</parameter_description>
3571
<return> the offset position of the caret (cursor).
3575
<function name="atk_relation_set_get_relation_by_type">
3577
Finds a relation that matches the specified type.
3582
<parameter name="set">
3583
<parameter_description> an #AtkRelationSet
3584
</parameter_description>
3586
<parameter name="relationship">
3587
<parameter_description> an #AtkRelationType
3588
</parameter_description>
3591
<return> an #AtkRelation, which is a relation matching the specified type.
3595
<function name="atk_object_factory_invalidate">
3597
Inform @factory that it is no longer being used to create
3598
accessibles. When called, @factory may need to inform
3599
#AtkObjects which it has created that they need to be re-instantiated.
3600
Note: primarily used for runtime replacement of #AtkObjectFactorys
3601
in object registries.
3605
<parameter name="factory">
3606
<parameter_description> an #AtkObjectFactory to invalidate
3607
</parameter_description>
3613
<function name="atk_table_get_row_description">
3615
Gets the description text of the specified row in the table
3620
<parameter name="table">
3621
<parameter_description> a GObject instance that implements AtkTableIface
3622
</parameter_description>
3624
<parameter name="row">
3625
<parameter_description> a #gint representing a row in @table
3626
</parameter_description>
3629
<return> a gchar* representing the row description, or %NULL
3630
if value does not implement this interface.
3634
<function name="atk_state_set_and_sets">
3636
Constructs the intersection of the two sets, returning %NULL if the
3637
intersection is empty.
3642
<parameter name="set">
3643
<parameter_description> an #AtkStateSet
3644
</parameter_description>
3646
<parameter name="compare_set">
3647
<parameter_description> another #AtkStateSet
3648
</parameter_description>
3651
<return> a new #AtkStateSet which is the intersection of the two sets.
3655
<function name="atk_table_remove_column_selection">
3657
Adds the specified @column to the selection.
3662
<parameter name="table">
3663
<parameter_description> a GObject instance that implements AtkTableIface
3664
</parameter_description>
3666
<parameter name="column">
3667
<parameter_description> a #gint representing a column in @table
3668
</parameter_description>
3671
<return> a gboolean representing if the column was successfully removed from
3672
the selection, or 0 if value does not implement this interface.
3676
<function name="atk_table_get_row_at_index">
3678
Gets a #gint representing the row at the specified @index_.
3683
<parameter name="table">
3684
<parameter_description> a GObject instance that implements AtkTableInterface
3685
</parameter_description>
3687
<parameter name="index_">
3688
<parameter_description> a #gint representing an index in @table
3689
</parameter_description>
3692
<return> a gint representing the row at the specified index,
3693
or -1 if the table does not implement this interface
3697
<function name="atk_action_set_description">
3699
Sets a description of the specified action of the object.
3704
<parameter name="action">
3705
<parameter_description> a #GObject instance that implements AtkActionIface
3706
</parameter_description>
3708
<parameter name="i">
3709
<parameter_description> the action index corresponding to the action to be performed
3710
</parameter_description>
3712
<parameter name="desc">
3713
<parameter_description> the description to be assigned to this action
3714
</parameter_description>
3717
<return> a gboolean representing if the description was successfully set;
3721
<function name="atk_socket_is_occupied">
3723
Determines whether or not the socket has an embedded plug.
3728
<parameter name="obj">
3729
<parameter_description> an #AtkSocket
3730
</parameter_description>
3733
<return> TRUE if a plug is embedded in the socket
3737
<function name="atk_component_set_size">
3739
Set the size of the @component in terms of width and height.
3744
<parameter name="component">
3745
<parameter_description> an #AtkComponent
3746
</parameter_description>
3748
<parameter name="width">
3749
<parameter_description> width to set for @component
3750
</parameter_description>
3752
<parameter name="height">
3753
<parameter_description> height to set for @component
3754
</parameter_description>
3757
<return> %TRUE or %FALSE whether the size was set or not
3761
<function name="atk_value_set_current_value">
3763
Sets the value of this object.
3768
<parameter name="obj">
3769
<parameter_description> a GObject instance that implements AtkValueIface
3770
</parameter_description>
3772
<parameter name="value">
3773
<parameter_description> a #GValue which is the desired new accessible value.
3774
</parameter_description>
3777
<return> %TRUE if new value is successfully set, %FALSE otherwise.
3781
<function name="atk_remove_global_event_listener">
3783
Removes the specified event listener
3787
<parameter name="listener_id">
3788
<parameter_description> the id of the event listener to remove
3789
</parameter_description>
3795
<function name="atk_add_global_event_listener">
3797
Adds the specified function to the list of functions to be called
3798
when an event of type event_type occurs.
3803
<parameter name="listener">
3804
<parameter_description> the listener to notify
3805
</parameter_description>
3807
<parameter name="event_type">
3808
<parameter_description> the type of event for which notification is requested
3809
</parameter_description>
3812
<return> added event listener id, or 0 on failure.
3816
<function name="atk_table_ref_at">
3818
Get a reference to the table cell at @row, @column.
3823
<parameter name="table">
3824
<parameter_description> a GObject instance that implements AtkTableIface
3825
</parameter_description>
3827
<parameter name="row">
3828
<parameter_description> a #gint representing a row in @table
3829
</parameter_description>
3831
<parameter name="column">
3832
<parameter_description> a #gint representing a column in @table
3833
</parameter_description>
3836
<return> a AtkObject* representing the referred to accessible
3840
<function name="atk_object_get_name">
3842
Gets the accessible name of the accessible.
3847
<parameter name="accessible">
3848
<parameter_description> an #AtkObject
3849
</parameter_description>
3852
<return> a character string representing the accessible name of the object.
3856
<function name="atk_object_remove_property_change_handler">
3858
Removes a property change handler.
3862
<parameter name="accessible">
3863
<parameter_description> an #AtkObject
3864
</parameter_description>
3866
<parameter name="handler_id">
3867
<parameter_description> a guint which identifies the handler to be removed.
3868
</parameter_description>
3874
<function name="atk_table_get_summary">
3876
Gets the summary description of the table.
3881
<parameter name="table">
3882
<parameter_description> a GObject instance that implements AtkTableIface
3883
</parameter_description>
3886
<return> a AtkObject* representing a summary description of the table,
3887
or zero if value does not implement this interface.
3891
<function name="atk_text_set_caret_offset">
3893
Sets the caret (cursor) position to the specified @offset.
3898
<parameter name="text">
3899
<parameter_description> an #AtkText
3900
</parameter_description>
3902
<parameter name="offset">
3903
<parameter_description> position
3904
</parameter_description>
3907
<return> %TRUE if success, %FALSE otherwise.
3911
<function name="atk_state_set_is_empty">
3913
Checks whether the state set is empty, i.e. has no states set.
3918
<parameter name="set">
3919
<parameter_description> an #AtkStateType
3920
</parameter_description>
3923
<return> %TRUE if @set has no states set, otherwise %FALSE
3927
<function name="atk_relation_set_get_n_relations">
3929
Determines the number of relations in a relation set.
3934
<parameter name="set">
3935
<parameter_description> an #AtkRelationSet
3936
</parameter_description>
3939
<return> an integer representing the number of relations in the set.
3943
<function name="atk_text_get_text_after_offset">
3945
Gets the specified text.
3947
If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character after the
3950
If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string
3951
is from the word start after the offset to the next word start.
3953
The returned string will contain the word after the offset if the offset
3954
is inside a word or if the offset is not inside a word.
3956
If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string
3957
is from the word end at or after the offset to the next work end.
3959
The returned string will contain the word after the offset if the offset
3960
is inside a word and will contain the word after the word after the offset
3961
if the offset is not inside a word.
3963
If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned
3964
string is from the sentence start after the offset to the next sentence
3967
The returned string will contain the sentence after the offset if the offset
3968
is inside a sentence or if the offset is not inside a sentence.
3970
If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string
3971
is from the sentence end at or after the offset to the next sentence end.
3973
The returned string will contain the sentence after the offset if the offset
3974
is inside a sentence and will contain the sentence after the sentence
3975
after the offset if the offset is not inside a sentence.
3977
If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned
3978
string is from the line start after the offset to the next line start.
3980
If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string
3981
is from the line end at or after the offset to the next line start.
3986
<parameter name="text">
3987
<parameter_description> an #AtkText
3988
</parameter_description>
3990
<parameter name="offset">
3991
<parameter_description> position
3992
</parameter_description>
3994
<parameter name="boundary_type">
3995
<parameter_description> An #AtkTextBoundary
3996
</parameter_description>
3998
<parameter name="start_offset">
3999
<parameter_description> the start offset of the returned string
4000
</parameter_description>
4002
<parameter name="end_offset">
4003
<parameter_description> the offset of the first character after the
4005
</parameter_description>
4008
<return> the text after @offset bounded by the specified @boundary_type.
4012
<function name="atk_relation_set_add">
4014
Add a new relation to the current relation set if it is not already
4016
This function ref's the AtkRelation so the caller of this function
4017
should unref it to ensure that it will be destroyed when the AtkRelationSet
4022
<parameter name="set">
4023
<parameter_description> an #AtkRelationSet
4024
</parameter_description>
4026
<parameter name="relation">
4027
<parameter_description> an #AtkRelation
4028
</parameter_description>
4034
<function name="atk_editable_text_set_run_attributes">
4036
Sets the attributes for a specified range. See the ATK_ATTRIBUTE
4037
macros (such as #ATK_ATTRIBUTE_LEFT_MARGIN) for examples of attributes
4038
that can be set. Note that other attributes that do not have corresponding
4039
ATK_ATTRIBUTE macros may also be set for certain text widgets.
4044
<parameter name="text">
4045
<parameter_description> an #AtkEditableText
4046
</parameter_description>
4048
<parameter name="attrib_set">
4049
<parameter_description> an #AtkAttributeSet
4050
</parameter_description>
4052
<parameter name="start_offset">
4053
<parameter_description> start of range in which to set attributes
4054
</parameter_description>
4056
<parameter name="end_offset">
4057
<parameter_description> end of range in which to set attributes
4058
</parameter_description>
4061
<return> %TRUE if attributes successfully set for the specified
4062
range, otherwise %FALSE
4066
<function name="atk_table_get_column_extent_at">
4068
Gets the number of columns occupied by the accessible object
4069
at the specified @row and @column in the @table.
4074
<parameter name="table">
4075
<parameter_description> a GObject instance that implements AtkTableIface
4076
</parameter_description>
4078
<parameter name="row">
4079
<parameter_description> a #gint representing a row in @table
4080
</parameter_description>
4082
<parameter name="column">
4083
<parameter_description> a #gint representing a column in @table
4084
</parameter_description>
4087
<return> a gint representing the column extent at specified position, or 0
4088
if value does not implement this interface.
4092
<function name="atk_socket_embed">
4094
Embeds the children of an #AtkPlug as the children of the #AtkSocket. The
4095
plug may be in the same process or in a different process.
4099
<parameter name="obj">
4100
<parameter_description> an #AtkSocket
4101
</parameter_description>
4103
<parameter name="plug_id">
4104
<parameter_description> the ID of an #AtkPlug
4105
</parameter_description>
4111
<function name="atk_state_set_add_states">
4113
Add the states for the specified types to the current state set.
4117
<parameter name="set">
4118
<parameter_description> an #AtkStateSet
4119
</parameter_description>
4121
<parameter name="types">
4122
<parameter_description> an array of #AtkStateType
4123
</parameter_description>
4125
<parameter name="n_types">
4126
<parameter_description> The number of elements in the array
4127
</parameter_description>
4133
<function name="atk_misc_threads_leave">
4135
Release the thread mutex for the GUI toolkit,
4136
if one exists. This method, and atk_misc_threads_enter,
4137
are needed in some situations by threaded application code which
4138
services ATK requests, since fulfilling ATK requests often
4139
requires calling into the GUI toolkit. If a long-running or
4140
potentially blocking call takes place inside such a block, it should
4141
be bracketed by atk_misc_threads_leave/atk_misc_threads_enter calls.
4142
(This method is implemented by the toolkit ATK implementation layer;
4143
for instance, for GTK+, GAIL implements this via GDK_THREADS_LEAVE).
4150
<parameter name="misc">
4151
<parameter_description> an AtkMisc instance for this application.
4152
</parameter_description>
4158
<function name="atk_state_type_for_name">
4160
Gets the #AtkStateType corresponding to the description string @name.
4165
<parameter name="name">
4166
<parameter_description> a character string state name
4167
</parameter_description>
4170
<return> an #AtkStateType corresponding to @name
4174
<function name="atk_hypertext_get_link_index">
4176
Gets the index into the array of hyperlinks that is associated with
4177
the character specified by @char_index.
4182
<parameter name="hypertext">
4183
<parameter_description> an #AtkHypertext
4184
</parameter_description>
4186
<parameter name="char_index">
4187
<parameter_description> a character index
4188
</parameter_description>
4191
<return> an index into the array of hyperlinks in @hypertext,
4192
or -1 if there is no hyperlink associated with this character.
4196
<function name="atk_object_add_relationship">
4198
Adds a relationship of the specified type with the specified target.
4203
<parameter name="object">
4204
<parameter_description> The #AtkObject to which an AtkRelation is to be added.
4205
</parameter_description>
4207
<parameter name="relationship">
4208
<parameter_description> The #AtkRelationType of the relation
4209
</parameter_description>
4211
<parameter name="target">
4212
<parameter_description> The #AtkObject which is to be the target of the relation.
4213
</parameter_description>
4216
<return>TRUE if the relationship is added.
4220
<function name="atk_text_get_character_extents">
4222
Get the bounding box containing the glyph representing the character at
4223
a particular text offset.
4227
<parameter name="text">
4228
<parameter_description> an #AtkText
4229
</parameter_description>
4231
<parameter name="offset">
4232
<parameter_description> The offset of the text character for which bounding information is required.
4233
</parameter_description>
4235
<parameter name="x">
4236
<parameter_description> Pointer for the x cordinate of the bounding box
4237
</parameter_description>
4239
<parameter name="y">
4240
<parameter_description> Pointer for the y cordinate of the bounding box
4241
</parameter_description>
4243
<parameter name="width">
4244
<parameter_description> Pointer for the width of the bounding box
4245
</parameter_description>
4247
<parameter name="height">
4248
<parameter_description> Pointer for the height of the bounding box
4249
</parameter_description>
4251
<parameter name="coords">
4252
<parameter_description> specify whether coordinates are relative to the screen or widget window
4253
</parameter_description>
4259
<function name="atk_component_remove_focus_handler">
4261
Remove the handler specified by @handler_id from the list of
4262
functions to be executed when this object receives focus events
4267
<parameter name="component">
4268
<parameter_description> the #AtkComponent to remove the focus handler from
4269
</parameter_description>
4271
<parameter name="handler_id">
4272
<parameter_description> the handler id of the focus handler to be removed
4274
</parameter_description>
4280
<function name="atk_state_set_add_state">
4282
Add a new state for the specified type to the current state set if
4283
it is not already present.
4288
<parameter name="set">
4289
<parameter_description> an #AtkStateSet
4290
</parameter_description>
4292
<parameter name="type">
4293
<parameter_description> an #AtkStateType
4294
</parameter_description>
4297
<return> %TRUE if the state for @type is not already in @set.
4301
<function name="atk_value_get_current_value">
4303
Gets the value of this object.
4307
<parameter name="obj">
4308
<parameter_description> a GObject instance that implements AtkValueIface
4309
</parameter_description>
4311
<parameter name="value">
4312
<parameter_description> a #GValue representing the current accessible value
4313
</parameter_description>
4319
<function name="atk_state_set_xor_sets">
4321
Constructs the exclusive-or of the two sets, returning %NULL is empty.
4322
The set returned by this operation contains the states in exactly
4323
one of the two sets.
4328
<parameter name="set">
4329
<parameter_description> an #AtkStateSet
4330
</parameter_description>
4332
<parameter name="compare_set">
4333
<parameter_description> another #AtkStateSet
4334
</parameter_description>
4337
<return> a new #AtkStateSet which contains the states which are
4338
in exactly one of the two sets.
4342
<function name="atk_role_get_localized_name">
4344
Gets the localized description string describing the #AtkRole @role.
4349
<parameter name="role">
4350
<parameter_description> The #AtkRole whose localized name is required
4351
</parameter_description>
4354
<return> the localized string describing the AtkRole
4358
<function name="atk_remove_key_event_listener">
4360
Removes the specified event listener
4364
<parameter name="listener_id">
4365
<parameter_description> the id of the event listener to remove
4366
</parameter_description>
4372
<function name="atk_hypertext_get_n_links">
4374
Gets the number of links within this hypertext document.
4379
<parameter name="hypertext">
4380
<parameter_description> an #AtkHypertext
4381
</parameter_description>
4384
<return> the number of links within this hypertext document
4388
<function name="atk_streamable_content_get_mime_type">
4390
Gets the character string of the specified mime type. The first mime
4391
type is at position 0, the second at position 1, and so on.
4396
<parameter name="streamable">
4397
<parameter_description> a GObject instance that implements AtkStreamableContent
4398
</parameter_description>
4400
<parameter name="i">
4401
<parameter_description> a gint representing the position of the mime type starting from 0
4402
</parameter_description>
4405
<return> a gchar* representing the specified mime type; the caller
4406
should not free the character string.
4410
<function name="atk_selection_add_selection">
4412
Adds the specified accessible child of the object to the
4418
<parameter name="selection">
4419
<parameter_description> a #GObject instance that implements AtkSelectionIface
4420
</parameter_description>
4422
<parameter name="i">
4423
<parameter_description> a #gint specifying the child index.
4424
</parameter_description>
4427
<return> TRUE if success, FALSE otherwise.
4431
<function name="atk_hyperlink_get_uri">
4433
Get a the URI associated with the anchor specified
4436
Multiple anchors are primarily used by client-side image maps.
4441
<parameter name="link_">
4442
<parameter_description> an #AtkHyperlink
4443
</parameter_description>
4445
<parameter name="i">
4446
<parameter_description> a (zero-index) integer specifying the desired anchor
4447
</parameter_description>
4450
<return> a string specifying the URI