docs/tmpl/atkobject.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 AtkObject
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5
   6 The base object class for the Accessibility Toolkit API.
   7
   8 <!-- ##### SECTION Long_Description ##### -->
   9 <para>
  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.
  18 </para>
  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.
  26 </para>
  27
  28 <!-- ##### SECTION See_Also ##### -->
  29 <para>
  30 See also: #AtkObjectFactory, #AtkRegistry.
  31 ( GTK+ users see also #GtkAccessible).
  32 </para>
  33
  34 <!-- ##### STRUCT AtkObject ##### -->
  35 <para>
  36 The AtkObject structure should not be accessed directly.
  37
  38 </para>
  39
  40
  41 <!-- ##### ENUM AtkRole ##### -->
  42 <para>
  43 </para>
  44
  45 @ATK_ROLE_INVALID:
  46 @ATK_ROLE_ACCEL_LABEL:
  47 @ATK_ROLE_ALERT:
  48 @ATK_ROLE_ANIMATION:
  49 @ATK_ROLE_ARROW:
  50 @ATK_ROLE_CALENDAR:
  51 @ATK_ROLE_CANVAS:
  52 @ATK_ROLE_CHECK_BOX:
  53 @ATK_ROLE_CHECK_MENU_ITEM:
  54 @ATK_ROLE_COLOR_CHOOSER:
  55 @ATK_ROLE_COLUMN_HEADER:
  56 @ATK_ROLE_COMBO_BOX:
  57 @ATK_ROLE_DATE_EDITOR:
  58 @ATK_ROLE_DESKTOP_ICON:
  59 @ATK_ROLE_DESKTOP_FRAME:
  60 @ATK_ROLE_DIAL:
  61 @ATK_ROLE_DIALOG:
  62 @ATK_ROLE_DIRECTORY_PANE:
  63 @ATK_ROLE_DRAWING_AREA:
  64 @ATK_ROLE_FILE_CHOOSER:
  65 @ATK_ROLE_FILLER:
  66 @ATK_ROLE_FONT_CHOOSER:
  67 @ATK_ROLE_FRAME:
  68 @ATK_ROLE_GLASS_PANE:
  69 @ATK_ROLE_HTML_CONTAINER:
  70 @ATK_ROLE_ICON:
  71 @ATK_ROLE_IMAGE:
  72 @ATK_ROLE_INTERNAL_FRAME:
  73 @ATK_ROLE_LABEL:
  74 @ATK_ROLE_LAYERED_PANE:
  75 @ATK_ROLE_LIST:
  76 @ATK_ROLE_LIST_ITEM:
  77 @ATK_ROLE_MENU:
  78 @ATK_ROLE_MENU_BAR:
  79 @ATK_ROLE_MENU_ITEM:
  80 @ATK_ROLE_OPTION_PANE:
  81 @ATK_ROLE_PAGE_TAB:
  82 @ATK_ROLE_PAGE_TAB_LIST:
  83 @ATK_ROLE_PANEL:
  84 @ATK_ROLE_PASSWORD_TEXT:
  85 @ATK_ROLE_POPUP_MENU:
  86 @ATK_ROLE_PROGRESS_BAR:
  87 @ATK_ROLE_PUSH_BUTTON:
  88 @ATK_ROLE_RADIO_BUTTON:
  89 @ATK_ROLE_RADIO_MENU_ITEM:
  90 @ATK_ROLE_ROOT_PANE:
  91 @ATK_ROLE_ROW_HEADER:
  92 @ATK_ROLE_SCROLL_BAR:
  93 @ATK_ROLE_SCROLL_PANE:
  94 @ATK_ROLE_SEPARATOR:
  95 @ATK_ROLE_SLIDER:
  96 @ATK_ROLE_SPLIT_PANE:
  97 @ATK_ROLE_SPIN_BUTTON:
  98 @ATK_ROLE_STATUSBAR:
  99 @ATK_ROLE_TABLE:
 100 @ATK_ROLE_TABLE_CELL:
 101 @ATK_ROLE_TABLE_COLUMN_HEADER:
 102 @ATK_ROLE_TABLE_ROW_HEADER:
 103 @ATK_ROLE_TEAR_OFF_MENU_ITEM:
 104 @ATK_ROLE_TERMINAL:
 105 @ATK_ROLE_TEXT:
 106 @ATK_ROLE_TOGGLE_BUTTON:
 107 @ATK_ROLE_TOOL_BAR:
 108 @ATK_ROLE_TOOL_TIP:
 109 @ATK_ROLE_TREE:
 110 @ATK_ROLE_TREE_TABLE:
 111 @ATK_ROLE_UNKNOWN:
 112 @ATK_ROLE_VIEWPORT:
 113 @ATK_ROLE_WINDOW:
 114 @ATK_ROLE_HEADER:
 115 @ATK_ROLE_FOOTER:
 116 @ATK_ROLE_PARAGRAPH:
 117 @ATK_ROLE_RULER:
 118 @ATK_ROLE_APPLICATION:
 119 @ATK_ROLE_LAST_DEFINED:
 120
 121 <!-- ##### FUNCTION atk_role_register ##### -->
 122 <para>
 123
 124 </para>
 125
 126 @name:
 127 @Returns:
 128
 129
 130 <!-- ##### ENUM AtkLayer ##### -->
 131 <para>
 132 </para>
 133
 134 @ATK_LAYER_INVALID:
 135 @ATK_LAYER_BACKGROUND:
 136 @ATK_LAYER_CANVAS:
 137 @ATK_LAYER_WIDGET:
 138 @ATK_LAYER_MDI:
 139 @ATK_LAYER_POPUP:
 140 @ATK_LAYER_OVERLAY:
 141 @ATK_LAYER_WINDOW:
 142
 143 <!-- ##### STRUCT AtkImplementor ##### -->
 144 <para>
 145 The AtkImplementor structure does not contain any fields.
 146
 147 </para>
 148
 149
 150 <!-- ##### STRUCT AtkPropertyValues ##### -->
 151 <para>
 152 The Atk PropertyValue structure is used when notifying a change in property.
 153 Currently, the only property for which old_value is used is
 154 accessible-state; for instance if there is a focus change the
 155 property change handler will be called for the object which lost the focus
 156 with the old_value containing the AtkState value corresponding to focused
 157 and the property change handler will be called for the object which
 158 received the focus with the new_value containing the AtkState value
 159 corresponding to focused.
 160
 161 </para>
 162
 163 @property_name:
 164 @old_value:
 165 @new_value:
 166
 167 <!-- ##### USER_FUNCTION AtkFunction ##### -->
 168 <para>
 169 An AtkFunction is a function definition used for padding which has been added
 170 to class and interface structures to allow for expansion in the future.
 171
 172 </para>
 173
 174 @data:
 175 @Returns:
 176
 177
 178 <!-- ##### USER_FUNCTION AtkPropertyChangeHandler ##### -->
 179 <para>
 180 An AtkPropertyChangeHandler is a function which is executed when an AtkObject's property changes value. It is specified in a call to
 181 atk_object_connect_property_change_handler().
 182 </para>
 183
 184 @Param1:
 185 @Param2:
 186
 187
 188 <!-- ##### FUNCTION atk_implementor_ref_accessible ##### -->
 189 <para>
 190
 191 </para>
 192
 193 @implementor:
 194 @Returns:
 195
 196
 197 <!-- ##### FUNCTION atk_object_get_name ##### -->
 198 <para>
 199
 200 </para>
 201
 202 @accessible:
 203 @Returns:
 204
 205
 206 <!-- ##### FUNCTION atk_object_get_description ##### -->
 207 <para>
 208
 209 </para>
 210
 211 @accessible:
 212 @Returns:
 213
 214
 215 <!-- ##### FUNCTION atk_object_get_parent ##### -->
 216 <para>
 217
 218 </para>
 219
 220 @accessible:
 221 @Returns:
 222
 223
 224 <!-- ##### FUNCTION atk_object_get_n_accessible_children ##### -->
 225 <para>
 226
 227 </para>
 228
 229 @accessible:
 230 @Returns:
 231
 232
 233 <!-- ##### FUNCTION atk_object_ref_accessible_child ##### -->
 234 <para>
 235
 236 </para>
 237
 238 @accessible:
 239 @i:
 240 @Returns:
 241
 242
 243 <!-- ##### FUNCTION atk_object_ref_relation_set ##### -->
 244 <para>
 245
 246 </para>
 247
 248 @accessible:
 249 @Returns:
 250
 251
 252 <!-- ##### FUNCTION atk_object_get_layer ##### -->
 253 <para>
 254
 255 </para>
 256
 257 @accessible:
 258 @Returns:
 259
 260
 261 <!-- ##### FUNCTION atk_object_get_mdi_zorder ##### -->
 262 <para>
 263
 264 </para>
 265
 266 @accessible:
 267 @Returns:
 268
 269
 270 <!-- ##### FUNCTION atk_object_get_role ##### -->
 271 <para>
 272
 273 </para>
 274
 275 @accessible:
 276 @Returns:
 277
 278
 279 <!-- ##### FUNCTION atk_object_ref_state_set ##### -->
 280 <para>
 281
 282 </para>
 283
 284 @accessible:
 285 @Returns:
 286
 287
 288 <!-- ##### FUNCTION atk_object_get_index_in_parent ##### -->
 289 <para>
 290
 291 </para>
 292
 293 @accessible:
 294 @Returns:
 295
 296
 297 <!-- ##### FUNCTION atk_object_set_name ##### -->
 298 <para>
 299
 300 </para>
 301
 302 @accessible:
 303 @name:
 304
 305
 306 <!-- ##### FUNCTION atk_object_set_description ##### -->
 307 <para>
 308
 309 </para>
 310
 311 @accessible:
 312 @description:
 313
 314
 315 <!-- ##### FUNCTION atk_object_set_parent ##### -->
 316 <para>
 317
 318 </para>
 319
 320 @accessible:
 321 @parent:
 322
 323
 324 <!-- ##### FUNCTION atk_object_set_role ##### -->
 325 <para>
 326
 327 </para>
 328
 329 @accessible:
 330 @role:
 331
 332
 333 <!-- ##### FUNCTION atk_object_connect_property_change_handler ##### -->
 334 <para>
 335
 336 </para>
 337
 338 @accessible:
 339 @handler:
 340 @Returns:
 341
 342
 343 <!-- ##### FUNCTION atk_object_remove_property_change_handler ##### -->
 344 <para>
 345
 346 </para>
 347
 348 @accessible:
 349 @handler_id:
 350
 351
 352 <!-- ##### FUNCTION atk_object_notify_state_change ##### -->
 353 <para>
 354
 355 </para>
 356
 357 @accessible:
 358 @state:
 359 @value:
 360
 361
 362 <!-- ##### FUNCTION atk_object_initialize ##### -->
 363 <para>
 364
 365 </para>
 366
 367 @accessible:
 368 @data:
 369
 370
 371 <!-- ##### FUNCTION atk_object_add_relationship ##### -->
 372 <para>
 373
 374 </para>
 375
 376 @object:
 377 @relationship:
 378 @target:
 379 @Returns:
 380
 381
 382 <!-- ##### FUNCTION atk_object_remove_relationship ##### -->
 383 <para>
 384
 385 </para>
 386
 387 @object:
 388 @relationship:
 389 @target:
 390 @Returns:
 391
 392
 393 <!-- ##### FUNCTION atk_role_get_name ##### -->
 394 <para>
 395
 396 </para>
 397
 398 @role:
 399 @Returns:
 400
 401
 402 <!-- ##### FUNCTION atk_role_get_localized_name ##### -->
 403 <para>
 404
 405 </para>
 406
 407 @role:
 408 @Returns:
 409
 410
 411 <!-- ##### FUNCTION atk_role_for_name ##### -->
 412 <para>
 413
 414 </para>
 415
 416 @name:
 417 @Returns:
 418
 419
 420 <!-- ##### SIGNAL AtkObject::active-descendant-changed ##### -->
 421 <para>
 422
 423 </para>
 424
 425 @atkobject: the object which received the signal.
 426 @arg1:
 427
 428 <!-- ##### SIGNAL AtkObject::children-changed ##### -->
 429 <para>
 430 The children_changed signal supports two details, "add" and "remove" which
 431 indicate whether a child was added or removed
 432 </para>
 433
 434 @atkobject: the object which received the signal.
 435 @arg1: The index of the added or removed child
 436 @arg2: The child which was added or removed
 437
 438 <!-- ##### SIGNAL AtkObject::focus-event ##### -->
 439 <para>
 440
 441 </para>
 442
 443 @atkobject: the object which received the signal.
 444 @arg1: A boolean value which indicates whether or not the focus event is is or out.
 445
 446 <!-- ##### SIGNAL AtkObject::property-change ##### -->
 447 <para>
 448 This signal support a detail which identifies the property which has
 449 changed.
 450 </para>
 451
 452 @atkobject: the object which received the signal.
 453 @arg1: The new value of the property which changed.
 454
 455 <!-- ##### SIGNAL AtkObject::state-change ##### -->
 456 <para>
 457 This signal support, which may be any of the accessible state types.
 458 </para>
 459
 460 @atkobject: the object which received the signal.
 461 @arg1: The name of the state which has changed
 462 @arg2: A boolean which indicates whether the state has been set or unset.
 463
 464 <!-- ##### SIGNAL AtkObject::visible-data-changed ##### -->
 465 <para>
 466
 467 </para>
 468
 469 @atkobject: the object which received the signal.
 470
 471 <!-- ##### ARG AtkObject:accessible-component-layer ##### -->
 472 <para>
 473
 474 </para>
 475
 476 <!-- ##### ARG AtkObject:accessible-component-mdi-zorder ##### -->
 477 <para>
 478
 479 </para>
 480
 481 <!-- ##### ARG AtkObject:accessible-description ##### -->
 482 <para>
 483
 484 </para>
 485
 486 <!-- ##### ARG AtkObject:accessible-name ##### -->
 487 <para>
 488
 489 </para>
 490
 491 <!-- ##### ARG AtkObject:accessible-parent ##### -->
 492 <para>
 493
 494 </para>
 495
 496 <!-- ##### ARG AtkObject:accessible-role ##### -->
 497 <para>
 498
 499 </para>
 500
 501 <!-- ##### ARG AtkObject:accessible-table-caption ##### -->
 502 <para>
 503
 504 </para>
 505
 506 <!-- ##### ARG AtkObject:accessible-table-caption-object ##### -->
 507 <para>
 508
 509 </para>
 510
 511 <!-- ##### ARG AtkObject:accessible-table-column-description ##### -->
 512 <para>
 513
 514 </para>
 515
 516 <!-- ##### ARG AtkObject:accessible-table-column-header ##### -->
 517 <para>
 518
 519 </para>
 520
 521 <!-- ##### ARG AtkObject:accessible-table-row-description ##### -->
 522 <para>
 523
 524 </para>
 525
 526 <!-- ##### ARG AtkObject:accessible-table-row-header ##### -->
 527 <para>
 528
 529 </para>
 530
 531 <!-- ##### ARG AtkObject:accessible-table-summary ##### -->
 532 <para>
 533
 534 </para>
 535
 536 <!-- ##### ARG AtkObject:accessible-value ##### -->
 537 <para>
 538
 539 </para>
 540