Table of Assistive Technology Service Provider Interface (AT-SPI) Events

Table of AT-SPI events

Data logged from AT-SPI 1.7.0, gail 1.8.11: Contents last updated: 2006/05/17 by Pete Parente, IBM, <pparent at us.ibm.com>; Markup last modified: 2008/02/04 by Gregory J. Rosmaita, <gregory at linux-foundation.org>; Latest Draft: http://accessibility.linux-foundation.org/a11yspecs/adoc/atspi-events.html; This Draft: http://accessibility.linux-foundation.org/a11yspecs/adoc/atspi-events_20080204.html; Previous Draft: http://accessibility.linux-foundation.org/a11yspecs/adoc/atspi-events_20060517.html

The following table details the AT-SPI events generated by the gail bridge. Events that have not been observed by the author at the time of this document's composition, are visually marked using a silver background and aurally by a switch from a male to a female voice, if one is using an Aural StyleSheet compliant browser or AT. The data these events provide is unknown.

The class, major, minor, and detail columns are the four parts of an AT-SPI event name. For instance, focus: only has a class specified while object:text-changed:inserted has class, major, and minor. Detail1, detail2, and any_data are extra data carried by the event object. Every event carries the source object of the event (not depicted in the table).

N.B.: Other AT-SPI bridge implementations may choose to include additional or different information in each event. Standardization is preferred for the sanity of AT-SPI clients, but is not currently enforced.

Assistive Technology Service Provider Interface (AT-SPI) events

Class

Major

Minor

Detail

detail1

detail2

any_data

focus

window

create

string: title

minimize

string: title

maximize

string: title

restore

string: title

reparent

desktop-create

desktop-destroy

activate

string: title

deactivate

string: title

raise

string: title

lower

string: title

move

string: title

resize

string: title

shade

string: title

unshade

string: title

restyle

string: title

object

text-caret-moved

int: new caret index

text-changed

inserted

int: start of inserted text

int: end of inserted text

string: inserted text

removed

int: start of deleted text

int: end of deleted text

string: deleted text

text-selection-changed

text-attributes-changed

property-change

accessible-parent

object: new parent

accessible-name

string: new name

accessible-description

string: new description

accessible-value

accessible-role

accessible-table-caption

accessible-table-column-description

accessible-table-column-header

accessible-table-row-description

accessible-table-row-header

accessible-table-summary

state-changed

^{[Footnote 1]}

bool: state set or state unset

children-changed

add

int: child index ^{[Footnote 2]}

object: added child ^{[Footnote 2]}

remove

int: child index ^{[Footnote 2]}

object: added child ^{[Footnote 2]}

visible-data-changed

bounds-changed

selection-changed

row-inserted

int: index of first row

int: number of rows

row-reordered

row-deleted

int: index of first row

int: number of rows

column-inserted

int: index of first column

int: number of columns

column-reordered

column-deleted

int: index of first column

int: number of columns

model-changed

active-descendant-changed

int: descendant index

object: descendant

attributes-changed

link-selected

document

load-complete

reload

load-stopped

content-changed

attributes-changed

terminal

line-changed

columncount-changed

linecount-changed

application-changed

charwidth-changed

mouse

abs

int: x

int: y

rel

int: delta x

int: delta y

button

int: x

int: y

int: x

int: y

int: x

int: y

int: x

int: y

int: x

int: y

int: x

int: y

Listeners for keyboard press and release events are only available using device listeners, not the global event listeners like the events about. pyLinAcc in LSR unifies the two event models.

Note 1 object:state-changed events have the untranslated name of the state that changed in the minor part of the event name. For instance, object:state-changed:enabled or object:state-changed:focused are valid event names. The minor fields are omitted from this table in order to avoid getting out of sync with the current AT-SPI specification. The current list of AT-SPI states can be found at:
http://gnome.org/~billh/at-spi-new-idl/html/html/namespaceAccessibility.html#a213

return to the text immediately preceding Note 1

Note 2: Two implementations of this event have been observed. In the common case, the event carries the added or removed child object in the any_data field and the detail1 field is empty. In rare cases, the any_data field is empty and detail1 contains the index of the added or removed child.

return to the text immediately preceding the first Note 2
return to the text immediately preceding the second Note 2
return to the text immediately preceding the third Note 2
return to the text immediately preceding the fourth Note 2
return to the text immediately preceding the fifth Note 2

Copyright 2005, 2008 Open A11y at The Linux Foundation.

Please submit comments, questions and inquiries about the content of this document to accessibility-rfc@a11y.org. Please report any technical issues encountered with this document or the resources to which it links to the Open A11y Webmaster, webmaster@a11y.org.