AccessibleStates.idl File Reference


Typedefs

typedef long AccessibleStates

Enumerations

enum  IA2States {
  IA2_STATE_ACTIVE = 0x1,
  IA2_STATE_ARMED = 0x2,
  IA2_STATE_DEFUNCT = 0x4,
  IA2_STATE_EDITABLE = 0x8,
  IA2_STATE_HORIZONTAL = 0x10,
  IA2_STATE_ICONIFIED = 0x20,
  IA2_STATE_INVALID_ENTRY = 0x40,
  IA2_STATE_MANAGES_DESCENDANTS = 0x80,
  IA2_STATE_MODAL = 0x100,
  IA2_STATE_MULTI_LINE = 0x200,
  IA2_STATE_OPAQUE = 0x400,
  IA2_STATE_REQUIRED = 0x800,
  IA2_STATE_SELECTABLE_TEXT = 0x1000,
  IA2_STATE_SINGLE_LINE = 0x2000,
  IA2_STATE_STALE = 0x4000,
  IA2_STATE_SUPPORTS_AUTOCOMPLETION = 0x8000,
  IA2_STATE_TRANSIENT = 0x10000,
  IA2_STATE_VERTICAL = 0x20000
}

Typedef Documentation

typedef long AccessibleStates


Enumeration Type Documentation

enum IA2States

IAccessible2 specific state bit constants

This enum defines the state bits returned by IAccessible2::states. The IAccessible2 state bits are in addition to those returned by MSAA.

Enumerator:
IA2_STATE_ACTIVE  Indicates a window is currently the active window, or is an active subelement within a container or table.

This state can be used to indicate the current active item in a container, even if the container itself is not currently active. In other words this would indicate the item that will get focus if you tab to the container.

This information is important for knowing what to report for trees and potentially other containers in a virtual buffer.

Also, see IA2_STATE_MANAGES_DESCENDANTS for more information.

IA2_STATE_ARMED  Indicates that the object is armed.

Used to indicate that the control is "pressed" and will be invoked when the actuator, e.g. a mouse button, is "released". An AT which either monitors the mouse or synthesizes mouse events might need to know that, and possibly a talking interface would even let the user know about it. It could also potentially be useful to on screen keyboards or test tools since the information does indicate something about the state of the interface, for example, code operating asynchronously might need to wait for the armed state to change before doing something else.

IA2_STATE_DEFUNCT  Indicates the user interface object corresponding to this object no longer exists.
IA2_STATE_EDITABLE  Indicates the user can change the contents of this object.
IA2_STATE_HORIZONTAL  Indicates the orientation of this object is horizontal.
IA2_STATE_ICONIFIED  Indicates this object is minimized and is represented only by an icon.
IA2_STATE_INVALID_ENTRY  Indicates an input validation failure.
IA2_STATE_MANAGES_DESCENDANTS  Indicates that this object manages its children.

Note: Due to the fact that MSAA's WinEvents don't allow the active child index to be passed on the IA2_EVENT_ACTIVE_DESCENDANT_CHANGED event, the manages descendants scheme can't be used. Instead the active child object has to fire MSAA's EVENT_OBJECT_FOCUS. In a future release a new event mechanism may be added to provide for event specific data to be passed with the event. At that time the IA2_EVENT_ACTIVE_DECENDENT_CHANGED event and IA2_STATE_MANAGES_DESCENDANTS state would be useful.

IA2_STATE_MODAL  Indicates that an object is modal.

Modal objects have the behavior that something must be done with the object before the user can interact with an object in a different window.

IA2_STATE_MULTI_LINE  Indicates this text object can contain multiple lines of text.
IA2_STATE_OPAQUE  Indicates this object paints every pixel within its rectangular region.
IA2_STATE_REQUIRED  Indicates that user interaction is required.

An example of when this state is used is when a field in a form must be filled before a form can be processed.

IA2_STATE_SELECTABLE_TEXT  Indicates an object which supports text selection.

Note: This is different than MSAA STATE_SYSTEM_SELECTABLE.

IA2_STATE_SINGLE_LINE  Indicates that this text object can contain only a single line of text.
IA2_STATE_STALE  Indicates that the accessible object is stale.

This state is used when the accessible object no longer accurately represents the state of the object which it is representing such as when an object is transient or when an object has been or is in the process of being destroyed or when the object's index in its parent has changed.

IA2_STATE_SUPPORTS_AUTOCOMPLETION  Indicates that the object implements autocompletion.

This state indicates that a text control will respond to the input of one ore more characters and cause a sub-item to become selected. The selection may also result in events fired on the parent object.

IA2_STATE_TRANSIENT  Indicates this object is transient.

An object has this state when its parent object has the state IA2_STATE_MANAGES_DESCENDANTS. For example, a list item object may be managed by its parent list object and may only exist as long as the object is actually rendered. Similarly a table cell's accessible object may exist only while the cell has focus. However, from the perspective of an assistive technology a transient object behaves like a non-transient object. As a result it is likely that this state is not of use to an assistive technology, but it is provided in case an assistive technology determines that knowledge of the transient nature of the object is useful and also for harmony with the Linux accessibility API.

Also, see IA2_STATE_MANAGES_DESCENDANTS for more information.

IA2_STATE_VERTICAL  Indicates the orientation of this object is vertical.


To submit feedback on IAccessible2 API Version 1.0.2, please use the Bugzilla interface located at: http://bugs.linuxfoundation.org/. When using Bugzilla please be sure to select IAccessible2 from the list of components. Bugzilla is the preferred method for receiving feedback because it automatically logs one's feedback in the IAccessible2 tracking system without additional human intervention. One may also, however, send email to accessibility-rfc@a11y.org, a publicly archived emailing list. Please address any technical problems you encounter with this document or the resources to which it links, to the Open A11y Webmaster <webmaster@a11y.org>

A stable online reference version of the documentation for IAccessible2 API Version 1.0.2, is available at: http://a11y.org/ia2-spec. A list of known and reported errors in the documentation for IAccessible2 API Version 1.0.2 can be found at: http://a11y.org/ia2-errata


Generated on Mon Oct 13 23:32:04 2008 for IAccessible2 API Version 1.0.2 by  doxygen 1.5.6