Main Page | Namespace List | Class Hierarchy | Class List | File List | Namespace Members | Class Members | File Members

Accessibility::Event Struct Reference

A structure encapsulating information about an event for which notification was requested. More...

import "Accessibility_Event.idl";

List of all members.

Public Attributes

string type
 A colon-delimited string indicating the type of the event.
Accessible source
 The Accessible object which is the source of the event.
long detail1
 An integer whose meaning is event type dependent.
long detail2
 see description of detail2
any any_data
 A generic storage location for event-type-specific data which provides more specific information about the event; for instance, in AT-SPI versions prior to 1.7.0, in the case of ¨object:text-changed:insert¨ events, this field contains a string indicating the inserted text.


Detailed Description

A structure encapsulating information about an event for which notification was requested.

Usually such notification is requested via a call to Registry::registerGlobalEventListener. The structure contains a colon-delimited string indicating the event type, a reference to the generating Accessible, two detail fields whose interpretation is event-type-specific, and a final field containing event-type-specific data.

Note:
Since AT-SPI 1.7.0 the 'any' field contains an EventDetails struct, which encapsulates additional information about the event and its generating object.

Definition at line 63 of file Accessibility_Event.idl.


Member Data Documentation

string Accessibility::Event::type
 

A colon-delimited string indicating the type of the event.

The string can be interpreted as class:type:subtype For instance ¨object:text-changed:insert¨ is an event from the 'Object' class, which corresponds to Accessible objects general, the type of the event is a ¨text-changed¨ event (i.e. a change in the content of an implementor of the Text interface), and the specific subtype of the change is an insertion event.

Event classes include the following:

  • focus: an object has received keyboard focus. This event has no type or subtype.
  • window: a toplevel window has changed state.
  • object: an object (i.e. Accessible) has undergone some change in state, content, or hierarchy
  • document:a change to a document's content has occurred, or its content loading status has changed.
  • mouse: an event originating from the pointing device. Rarely used; in most cases clients will wish to register for pointer events via the DeviceEventController::registerDeviceEvent method instead.
  • keyboard: an event indicating that the keyboard state (for example, the modifier state) has changed significantly. "keyboard:" events are not sent for individual keystrokes except as a side-effect of certain keys, for instance modifier keys. Clients interested in key events should listen for DeviceEvents via DeviceEventController::registerKeystrokeListener instead.
Note:
For more information on specific event types, see the documentation for each of the individual interfaces supported by some Accessible objects.
See also:
Accessible, Component, Collection, Document, Image, Selection, Table, Text, Value.

Definition at line 95 of file Accessibility_Event.idl.

Accessible Accessibility::Event::source
 

The Accessible object which is the source of the event.

The source object is the object to which the change inferred by the event emission occurs; for instance, the object emitting a ¨object:parent-changed¨ event is the child, not the parent. Likewise, the event source of an ¨object:children-changed:insert¨ event is the parent, not the inserted child.

Definition at line 103 of file Accessibility_Event.idl.

long Accessibility::Event::detail1
 

An integer whose meaning is event type dependent.

It may indicate the offset of text being inserted, in the case of ¨object:text-changed:insert¨, or the index of a newly added child in the case of ¨object:children-changed:add¨.

Note:
since most AT-SPI clients react to events via an asynchronous queue, for performance reasons, this field may be of limited utility unless the client maintains a large client-side cache of the hierarchy and contained data. This is because by the time such an event is asynchronously processed, the state of the originating object may have changed. In other words, the data in the detail1 member is not state-coherent outside of the event handler. More useful results are gotten by examination of the 'any_data' field.

Definition at line 114 of file Accessibility_Event.idl.

long Accessibility::Event::detail2
 

see description of detail2

Definition at line 116 of file Accessibility_Event.idl.

any Accessibility::Event::any_data
 

A generic storage location for event-type-specific data which provides more specific information about the event; for instance, in AT-SPI versions prior to 1.7.0, in the case of ¨object:text-changed:insert¨ events, this field contains a string indicating the inserted text.

Note:
Since AT-SPI 1.7.0, the data contained in this field is an EventDetails struct.

Definition at line 125 of file Accessibility_Event.idl.


The documentation for this struct was generated from the following file:
Generated on Fri Dec 2 15:20:46 2005 for AT_SPI_IDL by  doxygen 1.4.3