1 <!-- ##### SECTION Title ##### -->
4 <!-- ##### SECTION Short_Description ##### -->
6 The base object class for the Accessibility Toolkit API.
8 <!-- ##### SECTION Long_Description ##### -->
10 This class is the primary class for accessibility support via
11 the Accessibility ToolKit (ATK). Objects which are instances
12 of #AtkObject (or instances of AtkObject-derived types) are
13 queried for properties which relate basic (and generic) properties of a
14 UI component such as name and description. Instances of #AtkObject
15 may also be queried as to whether they implement other ATK interfaces
16 (e.g. #AtkAction, #AtkComponent, etc.), as appropriate to the role
17 which a given UI component plays in a user interface.
19 <para>All UI components in an application which provide useful
20 information or services to the user must provide corresponding
21 #AtkObject instances on request (in GTK+, for instance, usually
22 on a call to #gtk_widget_get_accessible ()), either via ATK support
23 built into the toolkit for the widget class or ancestor class, or in
24 the case of custom widgets, if the inherited #AtkObject implementation
25 is insufficient, via instances of a new #AtkObject subclass.
28 <!-- ##### SECTION See_Also ##### -->
30 See also: #AtkObjectFactory, #AtkRegistry.
31 ( GTK+ users see also #GtkAccessible).
34 <!-- ##### STRUCT AtkObject ##### -->
47 <!-- ##### ENUM AtkRole ##### -->
49 These are the built-in enumerated roles that UI components can have in
50 ATK. Other roles may be added at runtime, so an AtkRole >=
51 ATK_ROLE_LAST_DEFINED is not necessarily an error.
55 @ATK_ROLE_ACCEL_LABEL:
62 @ATK_ROLE_CHECK_MENU_ITEM:
63 @ATK_ROLE_COLOR_CHOOSER:
64 @ATK_ROLE_COLUMN_HEADER:
66 @ATK_ROLE_DATE_EDITOR:
67 @ATK_ROLE_DESKTOP_ICON:
68 @ATK_ROLE_DESKTOP_FRAME:
71 @ATK_ROLE_DIRECTORY_PANE:
72 @ATK_ROLE_DRAWING_AREA:
73 @ATK_ROLE_FILE_CHOOSER:
75 @ATK_ROLE_FONT_CHOOSER:
78 @ATK_ROLE_HTML_CONTAINER:
81 @ATK_ROLE_INTERNAL_FRAME:
83 @ATK_ROLE_LAYERED_PANE:
89 @ATK_ROLE_OPTION_PANE:
91 @ATK_ROLE_PAGE_TAB_LIST:
93 @ATK_ROLE_PASSWORD_TEXT:
95 @ATK_ROLE_PROGRESS_BAR:
96 @ATK_ROLE_PUSH_BUTTON:
97 @ATK_ROLE_RADIO_BUTTON:
98 @ATK_ROLE_RADIO_MENU_ITEM:
100 @ATK_ROLE_ROW_HEADER:
101 @ATK_ROLE_SCROLL_BAR:
102 @ATK_ROLE_SCROLL_PANE:
105 @ATK_ROLE_SPLIT_PANE:
106 @ATK_ROLE_SPIN_BUTTON:
109 @ATK_ROLE_TABLE_CELL:
110 @ATK_ROLE_TABLE_COLUMN_HEADER:
111 @ATK_ROLE_TABLE_ROW_HEADER:
112 @ATK_ROLE_TEAR_OFF_MENU_ITEM:
115 @ATK_ROLE_TOGGLE_BUTTON:
119 @ATK_ROLE_TREE_TABLE:
123 @ATK_ROLE_LAST_DEFINED:
125 <!-- ##### FUNCTION atk_role_register ##### -->
134 <!-- ##### ENUM AtkLayer ##### -->
136 These enumerated "layer values" are used when determining which UI
137 rendering layer a component is drawn into, which can help in making
138 determinations of when components occlude one another.
142 @ATK_LAYER_BACKGROUND:
149 <!-- ##### STRUCT AtkImplementor ##### -->
155 <!-- ##### STRUCT AtkImplementorIface ##### -->
157 This interface provides an alternative means of obtaining AtkObjects
158 from a GOBject instance, and for querying whether a GObject instance
159 provides ATK functionality.
165 <!-- ##### STRUCT AtkRelationSet ##### -->
173 <!-- ##### STRUCT AtkPropertyValues ##### -->
182 <!-- ##### USER_FUNCTION AtkFunction ##### -->
191 <!-- ##### USER_FUNCTION AtkPropertyChangeHandler ##### -->
200 <!-- ##### FUNCTION atk_implementor_ref_accessible ##### -->
209 <!-- ##### FUNCTION atk_object_get_name ##### -->
218 <!-- ##### FUNCTION atk_object_get_description ##### -->
227 <!-- ##### FUNCTION atk_object_get_parent ##### -->
236 <!-- ##### FUNCTION atk_object_get_n_accessible_children ##### -->
245 <!-- ##### FUNCTION atk_object_ref_accessible_child ##### -->
255 <!-- ##### FUNCTION atk_object_ref_relation_set ##### -->
264 <!-- ##### FUNCTION atk_object_get_layer ##### -->
273 <!-- ##### FUNCTION atk_object_get_mdi_zorder ##### -->
282 <!-- ##### FUNCTION atk_object_get_role ##### -->
291 <!-- ##### FUNCTION atk_object_ref_state_set ##### -->
300 <!-- ##### FUNCTION atk_object_get_index_in_parent ##### -->
309 <!-- ##### FUNCTION atk_object_set_name ##### -->
318 <!-- ##### FUNCTION atk_object_set_description ##### -->
327 <!-- ##### FUNCTION atk_object_set_parent ##### -->
336 <!-- ##### FUNCTION atk_object_set_role ##### -->
345 <!-- ##### FUNCTION atk_object_connect_property_change_handler ##### -->
355 <!-- ##### FUNCTION atk_object_remove_property_change_handler ##### -->
364 <!-- ##### FUNCTION atk_object_notify_state_change ##### -->
374 <!-- ##### FUNCTION atk_object_initialize ##### -->
383 <!-- ##### FUNCTION atk_role_get_name ##### -->
392 <!-- ##### FUNCTION atk_role_for_name ##### -->