An interface for accessibility events listened to
by in-process accessibility clients, which can be used
to find out how to get accessibility and DOM interfaces for
the event and its target. To listen to in-process accessibility invents,
make your object an nsIObserver, and listen for accessible-event by
using code something like this:
nsCOMPtr<nsIObserverService> observerService =
do_GetService("@mozilla.org/observer-service;1", &rv);
if (NS_SUCCEEDED(rv))
rv = observerService->AddObserver(this, "accessible-event", PR_TRUE);
@status UNDER_REVIEW
[scriptable, uuid(ba448f0e-a761-48c8-a0f5-1f25e23d4fe4)]
interface nsIAccessibleEvent : nsISupports
Constants
An object has been created.
const
unsigned long
EVENT_DOM_CREATE = 1
An object has been destroyed.
const
unsigned long
EVENT_DOM_DESTROY = 2
An object's properties or content have changed significantly so that the type of object has really changed, and therefore the accessible should be destroyed or recreated.
const
unsigned long
EVENT_DOM_SIGNIFICANT_CHANGE = 3
A hidden object is shown -- this is a layout occurance and is thus asynchronous
const
unsigned long
EVENT_ASYNCH_SHOW = 4
An object is hidden -- this is a layout occurance and is thus asynchronous
const
unsigned long
EVENT_ASYNCH_HIDE = 5
An object had a significant layout change which could affect the type of accessible object -- this is a layout occurance and is thus asynchronous
const
unsigned long
EVENT_ASYNCH_SIGNIFICANT_CHANGE = 6
The active descendant of a component has changed. The active descendant is used in objects with transient children.
const
unsigned long
EVENT_ACTIVE_DECENDENT_CHANGED = 7
An object has received the keyboard focus.
const
unsigned long
EVENT_FOCUS = 8
An object's state has changed.
const
unsigned long
EVENT_STATE_CHANGE = 9
An object has changed location, shape, or size.
const
unsigned long
EVENT_LOCATION_CHANGE = 10
An object's Name property has changed.
const
unsigned long
EVENT_NAME_CHANGE = 11
An object's Description property has changed.
const
unsigned long
EVENT_DESCRIPTION_CHANGE = 12
An object's Value property has changed.
const
unsigned long
EVENT_VALUE_CHANGE = 13
An object's help has changed.
const
unsigned long
EVENT_HELP_CHANGE = 14
An object's default action has changed.
const
unsigned long
EVENT_DEFACTION_CHANGE = 15
An object's action has changed.
const
unsigned long
EVENT_ACTION_CHANGE = 16
An object's keyboard shortcut has changed.
const
unsigned long
EVENT_ACCELERATOR_CHANGE = 17
The selection within a container object has changed.
const
unsigned long
EVENT_SELECTION = 18
An item within a container object has been added to the selection.
const
unsigned long
EVENT_SELECTION_ADD = 19
An item within a container object has been removed from the selection.
const
unsigned long
EVENT_SELECTION_REMOVE = 20
Numerous selection changes have occurred within a container object.
const
unsigned long
EVENT_SELECTION_WITHIN = 21
An alert has been generated. Server applications send this event when a user needs to know that a user interface element has changed.
const
unsigned long
EVENT_ALERT = 22
The foreground window has changed.
const
unsigned long
EVENT_FOREGROUND = 23
A menu item on the menu bar has been selected.
const
unsigned long
EVENT_MENU_START = 24
A menu from the menu bar has been closed.
const
unsigned long
EVENT_MENU_END = 25
A pop-up menu has been displayed.
const
unsigned long
EVENT_MENUPOPUP_START = 26
A pop-up menu has been closed.
const
unsigned long
EVENT_MENUPOPUP_END = 27
A window has received mouse capture.
const
unsigned long
EVENT_CAPTURE_START = 28
A window has lost mouse capture.
const
unsigned long
EVENT_CAPTURE_END = 29
A window is being moved or resized.
const
unsigned long
EVENT_MOVESIZE_START = 30
The movement or resizing of a window has finished
const
unsigned long
EVENT_MOVESIZE_END = 31
A window has entered context-sensitive Help mode
const
unsigned long
EVENT_CONTEXTHELP_START = 32
A window has exited context-sensitive Help mode
const
unsigned long
EVENT_CONTEXTHELP_END = 33
An application is about to enter drag-and-drop mode
const
unsigned long
EVENT_DRAGDROP_START = 34
An application is about to exit drag-and-drop mode
const
unsigned long
EVENT_DRAGDROP_END = 35
A dialog box has been displayed
const
unsigned long
EVENT_DIALOG_START = 36
A dialog box has been closed
const
unsigned long
EVENT_DIALOG_END = 37
Scrolling has started on a scroll bar
const
unsigned long
EVENT_SCROLLING_START = 38
Scrolling has ended on a scroll bar
const
unsigned long
EVENT_SCROLLING_END = 39
A window object is about to be minimized or maximized
const
unsigned long
EVENT_MINIMIZE_START = 40
A window object has been minimized or maximized
const
unsigned long
EVENT_MINIMIZE_END = 41
XXX:
const
unsigned long
EVENT_DOCUMENT_LOAD_START = 42
The loading of the document has completed.
const
unsigned long
EVENT_DOCUMENT_LOAD_COMPLETE = 43
The document contents are being reloaded.
const
unsigned long
EVENT_DOCUMENT_RELOAD = 44
The loading of the document was interrupted.
const
unsigned long
EVENT_DOCUMENT_LOAD_STOPPED = 45
The document wide attributes of the document object have changed.
const
unsigned long
EVENT_DOCUMENT_ATTRIBUTES_CHANGED = 46
The contents of the document have changed.
const
unsigned long
EVENT_DOCUMENT_CONTENT_CHANGED = 47
const
unsigned long
EVENT_PROPERTY_CHANGED = 48
const
unsigned long
EVENT_SELECTION_CHANGED = 49
A text object's attributes changed. Also see EVENT_OBJECT_ATTRIBUTE_CHANGED.
const
unsigned long
EVENT_TEXT_ATTRIBUTE_CHANGED = 50
The caret has moved to a new position.
const
unsigned long
EVENT_TEXT_CARET_MOVED = 51
This event indicates general text changes, i.e. changes to text that is exposed through the IAccessibleText and IAccessibleEditableText interfaces.
const
unsigned long
EVENT_TEXT_CHANGED = 52
Text was inserted.
const
unsigned long
EVENT_TEXT_INSERTED = 53
Text was removed.
const
unsigned long
EVENT_TEXT_REMOVED = 54
Text was updated.
const
unsigned long
EVENT_TEXT_UPDATED = 55
The text selection changed.
const
unsigned long
EVENT_TEXT_SELECTION_CHANGED = 56
A visibile data event indicates the change of the visual appearance of an accessible object. This includes for example most of the attributes available via the IAccessibleComponent interface.
const
unsigned long
EVENT_VISIBLE_DATA_CHANGED = 57
The caret moved from one column to the next.
const
unsigned long
EVENT_TEXT_COLUMN_CHANGED = 58
The caret moved from one section to the next.
const
unsigned long
EVENT_SECTION_CHANGED = 59
A table caption changed.
const
unsigned long
EVENT_TABLE_CAPTION_CHANGED = 60
A table's data changed.
const
unsigned long
EVENT_TABLE_MODEL_CHANGED = 61
A table's summary changed.
const
unsigned long
EVENT_TABLE_SUMMARY_CHANGED = 62
A table's row description changed.
const
unsigned long
EVENT_TABLE_ROW_DESCRIPTION_CHANGED = 63
A table's row header changed.
const
unsigned long
EVENT_TABLE_ROW_HEADER_CHANGED = 64
const
unsigned long
EVENT_TABLE_ROW_INSERT = 65
const
unsigned long
EVENT_TABLE_ROW_DELETE = 66
const
unsigned long
EVENT_TABLE_ROW_REORDER = 67
A table's column description changed.
const
unsigned long
EVENT_TABLE_COLUMN_DESCRIPTION_CHANGED = 68
A table's column header changed.
const
unsigned long
EVENT_TABLE_COLUMN_HEADER_CHANGED = 69
const
unsigned long
EVENT_TABLE_COLUMN_INSERT = 70
const
unsigned long
EVENT_TABLE_COLUMN_DELETE = 71
const
unsigned long
EVENT_TABLE_COLUMN_REORDER = 72
const
unsigned long
EVENT_WINDOW_ACTIVATE = 73
const
unsigned long
EVENT_WINDOW_CREATE = 74
const
unsigned long
EVENT_WINDOW_DEACTIVATE = 75
const
unsigned long
EVENT_WINDOW_DESTROY = 76
const
unsigned long
EVENT_WINDOW_MAXIMIZE = 77
const
unsigned long
EVENT_WINDOW_MINIMIZE = 78
const
unsigned long
EVENT_WINDOW_RESIZE = 79
const
unsigned long
EVENT_WINDOW_RESTORE = 80
The ending index of this link within the containing string has changed.
const
unsigned long
EVENT_HYPERLINK_END_INDEX_CHANGED = 81
The number of anchors assoicated with this hyperlink object has changed.
const
unsigned long
EVENT_HYPERLINK_NUMBER_OF_ANCHORS_CHANGED = 82
The hyperlink selected state changed from selected to unselected or from unselected to selected.
const
unsigned long
EVENT_HYPERLINK_SELECTED_LINK_CHANGED = 83
One of the links associated with the hypertext object has been activated.
const
unsigned long
EVENT_HYPERTEXT_LINK_ACTIVATED = 84
One of the links associated with the hypertext object has been selected.
const
unsigned long
EVENT_HYPERTEXT_LINK_SELECTED = 85
The starting index of this link within the containing string has changed.
const
unsigned long
EVENT_HYPERLINK_START_INDEX_CHANGED = 86
Focus has changed from one hypertext object to another, or focus moved from a non-hypertext object to a hypertext object, or focus moved from a hypertext object to a non-hypertext object.
const
unsigned long
EVENT_HYPERTEXT_CHANGED = 87
The number of hyperlinks associated with a hypertext object changed.
const
unsigned long
EVENT_HYPERTEXT_NLINKS_CHANGED = 88
An object's attributes changed. Also see EVENT_TEXT_ATTRIBUTE_CHANGED.
const
unsigned long
EVENT_OBJECT_ATTRIBUTE_CHANGED = 89
A slide changed in a presentation document or a page boundary was crossed in a word processing document.
const
unsigned long
EVENT_PAGE_CHANGED = 90
Used internally in Gecko.
const
unsigned long
EVENT_INTERNAL_LOAD = 91
An object's children have changed
const
unsigned long
EVENT_REORDER = 92
Help make sure event map does not get out-of-line.
const
unsigned long
EVENT_LAST_ENTRY = 93
Attributes
The nsIAccessible associated with the event. May return null if no accessible is available
readonly attribute
nsIAccessible
accessible
The nsIAccessibleDocument that the event target nsIAccessible resides in. This can be used to get the DOM window, the DOM document and the window handler, among other things.
readonly attribute
nsIAccessibleDocument
accessibleDocument
The nsIDOMNode associated with the event May return null if accessible for event has been shut down
readonly attribute
nsIDOMNode
DOMNode
The type of event, based on the enumerated event values defined in this interface.
readonly attribute
unsigned long
eventType
Returns true if the event was caused by explicit user input, as opposed to purely originating from a timer or mouse movement
attribute
boolean
isFromUserInput
Compare to: