Accessibility/Comparisons:Events: Difference between revisions

<table border="1"> <tr> <th>MSAA 1.3 event (EVENT_OBJECT_ *)</th> <th>Closest ATK Object Event(s) or Signals and the ATK Interface</th> <th>Closest UA Notification (NSAccessibility*Notification)</th> <th>Description</th> </tr>

  <td>An object has been created or destroyed. The system sends this event for the following user interface elements: caret, header, list view, tab, tree view, toolbar, and window objects.<br /> ATK: The character offset of the text caret (visible or notional) within this object has changed. Events of this type may also be generated when an onscreen text caret appears or disappears.</td> </tr>

  <td>A hidden object is shown. The system sends this event for the following user interface elements: caret, cursor, and window object. Hidden objects do not set the ATK_STATE_VISIBLE flag; shown objects do set this flag. The SHOW event also indicates that the ATK_STATE_VISIBLE flag is set.<br /> ATK: The character offset of the text caret (visible or notional) within this object has changed. Events of this type may also be generated when an onscreen text caret appears or disappears.</td> </tr>

  <td>text-caret-moved (AtkText)</td>

  <td>An object is hidden. The system sends this event for the following user interface elements: caret and cursor.<br /> ATK: The character offset of the text caret (visible or notional) within this object has changed. Events of this type may also be generated when an onscreen text caret appears or disappears.</td> </tr>

  <td>children-changed (AtkObject) active-descendant-changed (AtkObject)</td>

  <td>A container object has been added, removed, or reordered its children. The system sends this event for the following user interface elements: header control, list view control, toolbar control, and window object. For example, this event is generated by a list view object when the number of child elements or the order of the elements changes. This event is also sent by a parent window when the z order for the child windows changes.<br /> ATK: The number or identity of an object's children has changed.</td> </tr>

* [http://developer.gnome.org/doc/API/2.0/atk/AtkComponent.html#atk-component-remove-focus-handler atk_component_remove_focus_handler]</td>

  <td>An object has received the keyboard focus. The system sends this event for the following user interface elements: list view control, menu bar, pop-up menu, switch window, tab control, tree view control, and window object.</td> </tr>

  <td>selection-changed (AtkSelection) </td>

  <td>The selection within a container object has changed. The system sends this event for the following user interface elements: list view control, tab control, tree view control, and window object.<br /> ATK: An instance of Selection has undergone a change in the 'selected-ness' of its children, i.e. had a selection added, removed, and/or modified. Usually accompanied by corresponding <code>"object:state-changed:selected"</code> events from the corresponding children, unless the children are previously un-queried via AT-SPI and the Selection instance has STATE_MANAGES_DESCENDANTS.</td> </tr>

  <td>selection-changed (AtkSelection)</td>

  <td>An item within a container object has been added to or removed from the selection. The system sends these events for the following user interface elements: list box, list view control, and tree view control. For SELECTIONWITHIN, numerous selection changes have occurred within a container object. The system sends this event for list boxes. Used instead of sending several SELECTIONADD or SELECTIONREMOVE events.<br /> ATK: An instance of Selection has undergone a change in the 'selected-ness' of its children, i.e. had a selection added, removed, and/or modified. Usually accompanied by corresponding <code>"object:state-changed:selected"</code> events from the corresponding children, unless the children are previously un-queried via AT-SPI and the Selection instance has STATE_MANAGES_DESCENDANTS.</td> </tr>

  <tr class="OK"> <td>STATECHANGE</td>

  <td>An object's state has changed. The system sends this event for the following user interface elements: check box, combo box, header control, push button, radio button, scroll bar, toolbar control, tree view control, up-down control, and window object. For example, a state change occurs when a button object is pressed or released, or when an object is enabled or disabled.<br /> ATK: The object's StateSet has had a state added or removed.</td> </tr>

  <td>bounds-changed (AtkComponent) text-bounds-changed (proposed - AtkText) text-caret-moved (AtkText)</td>

  <td>An object has changed location, shape, or size. The system sends this event for the following user interface elements: caret and window object. Server applications send this event for their accessible objects. This event is generated in response to the top-level object within the object hierarchy that has changed, not for any children it might contain. For example, if the user resizes a window, the system sends this notification for the window, but not for the menu bar, title bar, scroll bars, or other objects that have also changed. The system does not send this event for every non-floating child window when the parent moves. However, if an application explicitly resizes child windows as a result of resizing, the system sends multiple events for the resized children.<br /> ATK: The 'bounds-changed" signal is emitted when the bposition or size of the a component changes.<br /> The character bounds of a text object have changed, for instance in response to a reformatting or reflow operation.<br /> The character offset of the text caret (visible or notional) within this object has changed. Events of this type may also be generated when an onscreen text caret appears or disappears.</td> </tr>

  <tr class="OK"> <td>NAMECHANGE</td>

  <td>An object's name property has changed. The system sends this event for the following user interface elements: check box, cursor, list view control, push button, radio button, status bar control, tree view control, and window object.<br /> ATK: A base (strongly-typed) object attribute has changed, for instance "object:property-change:accessible-name". Notifed property subtypes include accessible-name, accessible-description, and accessible-parent.</td> </tr>

  <td>property-change::accessible-description (AtkObject)</td>

  <td>An object's description property has changed.<br /> ATK: A base (strongly-typed) object attribute has changed, for instance "object:property-change:accessible-name". Notifed property subtypes include accessible-name, accessible-description, and accessible-parent.</td> </tr>

  <td>visible-data-changed (AtkObject) text-changed (AtkText) value-changed (proposed - AtkObject?) property-change::accessible-value (AtkObject) </td>

  <td>An object's value property has changed. The system sends this event for the following user interface elements: edit control, header control, hot key control, progress bar control, scroll bar, slider control, and up-down control.<br /> ATK: The visible data, text content, or value of this object has changed.</td> </tr>

  <td>property-change::accessible-parent (AtkObject)</td>

  <td>An object has a new parent object.<br /> ATK: A base (strongly-typed) object attribute has changed, for instance "object:property-change:accessible-name". Notifed property subtypes include accessible-name, accessible-description, and accessible-parent.</td> </tr>

  <td> </td>

  <td>An object's help property has changed.</td> </tr>

  <td> </td>

  <td>An object's key bindings has changed.</td> </tr>

  <td> </td>

  <td>An object's default action property has changed. The system sends this event for dialog boxes.</td> </tr>

  <td>active-descendant-changed (AtkObject)</td>

  <td>If the object includes STATE_MANAGES_DESCENDANTS, this event is fired to indicate that the descendant having STATE_ACTIVE has changed; this corresponds to "micro" keyboard focus when the containing/emitting object has "macro" or technical keyboard focus. For instance, this event is usually emitted while traversing tables and/or spreadsheet cells.</td> </tr>

  <td>text-selection-changed (AtkText)</td>

  <td>The range or number of text selections within this text object has changed</td> </tr>

  <td>link-selected (AtkHypertext)</td>

  <td> <p>The "link-selected" signal is emitted by an AtkHyperText object when one of the hyperlinks associated with the object is selected.</p> </td> </tr>

  <td>row-deleted (AtkTable)</td>

  <td> <p>The "row-deleted" signal is emitted by an object which implements the AtkTable interface when a row is deleted.</p> </td> </tr>

  <td>row-inserted (AtkTable)</td>

  <td>The "row-inserted" signal is emitted by an object which implements the AtkTable interface when a row is inserted.</td> </tr>