nsIAccessibleEvent

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.
Inherits from: nsISupports Last changed in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

Attributes

Attribute Type Description
accessible nsIAccessible The nsIAccessible associated with the event. May return null if no accessible is available. Read only.
accessibleDocument nsIAccessibleDocument 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. Read only.
DOMNode nsIDOMNode The nsIDOMNode associated with the event. May return null if accessible for event has been shut down. Read only.
eventType unsigned long The type of event, based on the enumerated event values defined in this interface. Read only.
isFromUserInput boolean Returns true if the event was caused by explicit user input, as opposed to purely originating from a timer or mouse movement.

Constants

Constant Gecko version Description
1.7 - 1.8.1 1.9 - 1.9.2 2.0
EVENT_SHOW 0x8002   0x0001 An object has been created.
EVENT_HIDE 0x8003   0x0002 An object has been destroyed.
EVENT_REORDER 0x8004 0x005C 0x0003 An object's children have changed.
EVENT_ACTIVE_DECENDENT_CHANGED   0x0007 0x0004 The active descendant of a component has changed. The active descendant is used in objects with transient children.
EVENT_FOCUS 0x8005 0x0008 0x0005 An object has received the keyboard focus.
EVENT_STATE_CHANGE 0x800A 0x0009 0x0006 An object's state has changed.
EVENT_LOCATION_CHANGE 0x800B 0x000A 0x0007 An object has changed location, shape, or size.
EVENT_NAME_CHANGE 0x800C 0x000B 0x0008 An object's Name property has changed.
EVENT_DESCRIPTION_CHANGE   0x000C 0x0009 An object's Description property has changed.
EVENT_VALUE_CHANGE 0x800E 0x000D 0x000A An object's Value property has changed.
EVENT_HELP_CHANGE   0x000E 0x000B An object's help has changed.
EVENT_DEFACTION_CHANGE   0x000F 0x000C An object's default action has changed.
EVENT_ACTION_CHANGE   0x0010 0x000D An object's action has changed.
EVENT_ACCELERATOR_CHANGE   0x0011 0x000E An object's keyboard shortcut has changed.
EVENT_SELECTION 0x8006 0x0012 0x000F The selection within a container object has changed.
EVENT_SELECTION_ADD 0x8007 0x0013 0x0010 An item within a container object has been added to the selection.
EVENT_SELECTION_REMOVE 0x8008 0x0014 0x0011 An item within a container object has been removed from the selection.
EVENT_SELECTION_WITHIN 0x8009 0x0015 0x0012 Numerous selection changes have occurred within a container object.
EVENT_ALERT 0x0002 0x0016 0x0013 An alert has been generated. Server applications send this event when a user needs to know that a user interface element has changed.
EVENT_FOREGROUND 0x0003 0x0017 0x0014 The foreground window has changed.
EVENT_MENU_START   0x0018 0x0015 A menu item on the menu bar has been selected.
EVENT_MENU_END   0x0019 0x0016 A menu from the menu bar has been closed.
EVENT_MENUPOPUP_START   0x001A 0x0017 A pop-up menu has been displayed.
EVENT_MENUPOPUP_END   0x001B 0x0018 A pop-up menu has been closed.
EVENT_CAPTURE_START   0x001C 0x0019 A window has received mouse capture.
EVENT_CAPTURE_END   0x001D 0x001A A window has lost mouse capture.
EVENT_MOVESIZE_START   0x001E 0x001B A window is being moved or resized.
EVENT_MOVESIZE_END   0x001F 0x001C The movement or resizing of a window has finished.
EVENT_CONTEXTHELP_START   0x0020 0x001D A window has entered context-sensitive Help mode.
EVENT_CONTEXTHELP_END   0x0021 0x001E A window has exited context-sensitive Help mode.
EVENT_DRAGDROP_START   0x0022 0x001F An application is about to enter drag-and-drop mode.
EVENT_DRAGDROP_END   0x0023 0x0020 An application is about to exit drag-and-drop mode.
EVENT_DIALOG_START   0x0024 0x0021 A dialog box has been displayed.
EVENT_DIALOG_END   0x0025 0x0022 A dialog box has been closed.
EVENT_SCROLLING_START   0x0026 0x0023 Scrolling has started on a scroll bar.
EVENT_SCROLLING_END   0x0027 0x0024 Scrolling has ended on a scroll bar.
EVENT_MINIMIZE_START   0x0028 0x0025 A window object is about to be minimized or maximized.
EVENT_MINIMIZE_END   0x0029 0x0026 A window object has been minimized or maximized.
EVENT_DOCUMENT_LOAD_COMPLETE   0x002B 0x0027 The loading of the document has completed.
EVENT_DOCUMENT_RELOAD   0x002C 0x0028 The document contents are being reloaded.
EVENT_DOCUMENT_LOAD_STOPPED   0x002D 0x0029 The loading of the document was interrupted.
EVENT_DOCUMENT_ATTRIBUTES_CHANGED   0x002E 0x002A The document wide attributes of the document object have changed.
EVENT_DOCUMENT_CONTENT_CHANGED   0x002F 0x002B The contents of the document have changed.
EVENT_PROPERTY_CHANGED   0x0030 0x002C  
EVENT_SELECTION_CHANGED   0x0031 0x002D  
EVENT_TEXT_ATTRIBUTE_CHANGED   0x0032 0x002E A text object's attributes changed. Also see EVENT_OBJECT_ATTRIBUTE_CHANGED.
EVENT_TEXT_CARET_MOVED   0x0033 0x002F The caret has moved to a new position.
EVENT_TEXT_CHANGED   0x0034 0x0030 This event indicates general text changes. That is, changes to text that is exposed through the IAccessibleText and IAccessibleEditableText interfaces.
EVENT_TEXT_INSERTED   0x0035 0x0031 Text was inserted.
EVENT_TEXT_REMOVED   0x0036 0x0032 Text was removed.
EVENT_TEXT_UPDATED   0x0037 0x0033 Text was updated.
EVENT_TEXT_SELECTION_CHANGED   0x0038 0x0034 The text selection changed.
EVENT_VISIBLE_DATA_CHANGED   0x0039 0x0035 A visible 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.
EVENT_TEXT_COLUMN_CHANGED   0x003A 0x0036 The caret moved from one column to the next.
EVENT_SECTION_CHANGED   0x003B 0x0037 The caret moved from one section to the next.
EVENT_TABLE_CAPTION_CHANGED   0x003C 0x0038 A table caption changed.
EVENT_TABLE_MODEL_CHANGED   0x003D 0x0039 A table's data changed.
EVENT_TABLE_SUMMARY_CHANGED   0x003E 0x003A A table's summary changed.
EVENT_TABLE_ROW_DESCRIPTION_CHANGED   0x003F 0x003B A table's row description changed.
EVENT_TABLE_ROW_HEADER_CHANGED   0x0040 0x003C A table's row header changed.
EVENT_TABLE_ROW_INSERT   0x0041 0x003D  
EVENT_TABLE_ROW_DELETE   0x0042 0x003E  
EVENT_TABLE_ROW_REORDER   0x0043 0x003F  
EVENT_TABLE_COLUMN_DESCRIPTION_CHANGED   0x0044 0x0040 A table's column description changed.
EVENT_TABLE_COLUMN_HEADER_CHANGED   0x0045 0x0041 A table's column header changed.
EVENT_TABLE_COLUMN_INSERT   0x0046 0x0042  
EVENT_TABLE_COLUMN_DELETE   0x0047 0x0043  
EVENT_TABLE_COLUMN_REORDER   0x0048 0x0044  
EVENT_WINDOW_ACTIVATE   0x0049 0x0045  
EVENT_WINDOW_CREATE   0x004A 0x0046  
EVENT_WINDOW_DEACTIVATE   0x004B 0x0047  
EVENT_WINDOW_DESTROY   0x004C 0x0048  
EVENT_WINDOW_MAXIMIZE   0x004D 0x0049  
EVENT_WINDOW_MINIMIZE   0x004E 0x004A  
EVENT_WINDOW_RESIZE   0x004F 0x004B  
EVENT_WINDOW_RESTORE   0x0050 0x004C  
EVENT_HYPERLINK_END_INDEX_CHANGED   0x0051 0x004D The ending index of this link within the containing string has changed.
EVENT_HYPERLINK_NUMBER_OF_ANCHORS_CHANGED   0x0052 0x004E The number of anchors associated with this hyperlink object has changed.
EVENT_HYPERLINK_SELECTED_LINK_CHANGED   0x0053 0x004F The hyperlink selected state changed from selected to unselected or from unselected to selected.
EVENT_HYPERTEXT_LINK_ACTIVATED   0x0054 0x0050 One of the links associated with the hypertext object has been activated.
EVENT_HYPERTEXT_LINK_SELECTED   0x0055 0x0051 One of the links associated with the hypertext object has been selected.
EVENT_HYPERLINK_START_INDEX_CHANGED   0x0056 0x0052 The starting index of this link within the containing string has changed.
EVENT_HYPERTEXT_CHANGED   0x0057 0x0053 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.
EVENT_HYPERTEXT_NLINKS_CHANGED   0x0058 0x0054 The number of hyperlinks associated with a hypertext object changed.
EVENT_OBJECT_ATTRIBUTE_CHANGED   0x0059 0x0055

An object's attributes changed. Also see EVENT_TEXT_ATTRIBUTE_CHANGED.

Gecko 1.9.2 note
This event is never sent in versions of Gecko prior to 1.9.2, even though the constant existed.
EVENT_PAGE_CHANGED   0x005A 0x0056 A slide changed in a presentation document or a page boundary was crossed in a word processing document.
EVENT_LAST_ENTRY   0x005D 0x0057 Help make sure event map does not get out-of-line.
EVENT_CREATE 0x8000    
EVENT_DESTROY 0x8001    
EVENT_DESCRIPTIONCHANGE 0x800D    
EVENT_PARENTCHANGE 0x800F    
EVENT_HELPCHANGE 0x8010    
EVENT_DEFACTIONCHANGE 0x8011    
EVENT_ACCELERATORCHANGE 0x8012    
EVENT_MENUSTART 0x0004    
EVENT_MENUEND 0x0005    
EVENT_MENUPOPUPSTART 0x0006    
EVENT_MENUPOPUPEND 0x0007    
EVENT_CAPTURESTART 0x0008    
EVENT_CAPTUREEND 0x0009    
EVENT_MOVESIZESTART 0x000A    
EVENT_MOVESIZEEND 0x000B    
EVENT_CONTEXTHELPSTART 0x000C    
EVENT_CONTEXTHELPEND 0x000D    
EVENT_DRAGDROPSTART 0x000E    
EVENT_DRAGDROPEND 0x000F    
EVENT_DIALOGSTART 0x0010    
EVENT_DIALOGEND 0x0011    
EVENT_SCROLLINGSTART 0x0012    
EVENT_SCROLLINGEND 0x0013    
EVENT_MINIMIZESTART 0x0016    
EVENT_MINIMIZEEND 0x0017    
EVENT_ATK_PROPERTY_CHANGE 0x0100    
EVENT_ATK_SELECTION_CHANGE 0x0101    
EVENT_ATK_TEXT_CHANGE 0x0102    
EVENT_ATK_TEXT_SELECTION_CHANGE 0x0103    
EVENT_ATK_TEXT_CARET_MOVE 0x0104    
EVENT_ATK_VISIBLE_DATA_CHANGE 0x0105    
EVENT_ATK_TABLE_MODEL_CHANGE 0x0110    
EVENT_ATK_TABLE_ROW_INSERT 0x0111    
EVENT_ATK_TABLE_ROW_DELETE 0x0112    
EVENT_ATK_TABLE_ROW_REORDER 0x0113    
EVENT_ATK_TABLE_COLUMN_INSERT 0x0114    
EVENT_ATK_TABLE_COLUMN_DELETE 0x0115    
EVENT_ATK_TABLE_COLUMN_REORDER 0x0116    
EVENT_ATK_LINK_SELECTED 0x0117    
EVENT_ATK_WINDOW_ACTIVATE 0x0118    
EVENT_ATK_WINDOW_CREATE 0x0119    
EVENT_ATK_WINDOW_DEACTIVATE 0x0120    
EVENT_ATK_WINDOW_DESTROY 0x0121    
EVENT_ATK_WINDOW_MAXIMIZE 0x0122    
EVENT_ATK_WINDOW_MINIMIZE 0x0123    
EVENT_ATK_WINDOW_RESIZE 0x0124    
EVENT_ATK_WINDOW_RESTORE 0x0125    
EVENT_DOM_CREATE   0x0001   An object has been created.
EVENT_DOM_DESTROY   0x0002   An object has been destroyed.
EVENT_DOM_SIGNIFICANT_CHANGE   0x0003   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.
EVENT_ASYNCH_SHOW   0x0004   A hidden object is shown -- this is a layout occurrence and is thus asynchronous.
EVENT_ASYNCH_HIDE   0x0005   An object is hidden -- this is a layout occurrence and is thus asynchronous.
EVENT_ASYNCH_SIGNIFICANT_CHANGE   0x0006   An object had a significant layout change which could affect the type of accessible object -- this is a layout occurrence and is thus asynchronous.
EVENT_DOCUMENT_LOAD_START   0x002A    
EVENT_INTERNAL_LOAD   0x005B   Used internally in Gecko.

Example

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);
}

Document Tags and Contributors

 Contributors to this page: Sheppy, trevorh, Kglee
 Last updated by: Sheppy,