Introduction
Below you will find a list of supported states by Gecko. State constants are defined in nsIAccessibleStates.
States List
- STATE_UNAVAILABLE
- The object is unavailable, i.e. disabled.
- Applied to: all roles.
- STATE_SELECTED
- The object is selected, i.e. indicates this object is the child of an object that allows its children to be selected and that this child is one of those children that has been selected.
- Applied to:
ROLE_MENUITEM,ROLE_CELL,ROLE_OUTLINEITEM, XXX: continue - Events:
EVENT_STATE_CHANGE - ะกoncomitant state: STATE_SELECTABLE
- STATE_FOCUSED
- The object is focused
- Applied to:
- Events:
- Concomitant state: STATE_FOCUSABLE
- STATE_PRESSED
- The object is pressed.
- STATE_CHECKED
- The object is checked
- STATE_MIXED
- Indicates that the state of a three-state check box or toolbar button is not determined. The check box is neither checked nor unchecked and is therefore in the third or mixed state.
- STATE_READONLY
- The object is designated read-only.
- STATE_HOTTRACKED
- The object is hot-tracked by the mouse, which means that its appearance has changed to indicate that the mouse pointer is located over it.
- Isn't used
- STATE_DEFAULT
- This state represents the default button in a window.
- STATE_EXPANDED
- Children of this object that have the ROLE_OUTLINEITEM role are displayed.
- STATE_COLLAPSED
- Children of this object that have the ROLE_OUTLINEITEM role are hidden.
- STATE_BUSY
- The control cannot accept input at this time.
- STATE_FLOATING
- Children "owned" not "contained" by parent
- STATE_CHECKABLE
- Indicates scrolling or moving text or graphics.
- STATE_ANIMATED
- The object's appearance changes rapidly or constantly. Graphics that are occasionally animated are described as ROLE_GRAPHIC with the State property set to STATE_ANIMATED. This state is used to indicate that the object's location is changing.
- STATE_INVISIBLE
- The object is programmatically hidden. For example, menu itmes are programmatically hidden until a user activates the menu. Because objects with this state are not available to users, client applications should not communicate information about the object to users. However, if client applications find an object with this state, they should check to see if STATE_OFFSCREEN is also set. If this second state is defined, then clients can communicate the information about the object to users. For example, a list box can have both STATE_INVISIBLE and STATE_OFFSCREEN set. In this case, the client application can communicate all items in the list to users.
- STATE_OFFSCREEN
- Scrolled off
- STATE_SIZEABLE
- The object can be resized. For example, a user could change the size of a window by clicking the border with a mouse and dragging the mouse.
- STATE_MOVEABLE
- Indicates that the object can be moved. For example, a user can click on the titlebar for the object and drag the object to a new location.
- STATE_SELFVOICING
- The object or child uses text-to-speech (TTS) technology for description purposes. A speech-based accessibility aid does not announce information when an object with this state has the focus because the object automatically announces information.
- Isn't used
- STATE_FOCUSABLE
- The object can be focused.
- Applied to:
- Events:
- Concomitant state: STATE_FOCUSED
- STATE_SELECTABLE
- The object can be selected.
- Applied to:
- Events:
- Concomitant state: STATE_SELECTED
- STATE_LINKED
- Indicates that the object is formatted as a hyperlink. The object role will usually be ROLE_TEXT_LEAF.
- STATE_TRAVERSED
- The object is a hyperlink that has been visited (previously clicked) by a user.
- STATE_MULTISELECTABLE
- Supports multiple selection
- STATE_EXTSELECTABLE
- Supports extended selection
- STATE_REQUIRED
- Indicates that user interaction is required.
- STATE_IMPORTANT
- Isn;t used.
- STATE_INVALID
- Indicates a validation failure.
- EXT_STATE_SUPPORTS_AUTOCOMPLETION
- For editable areas that have any kind of autocompletion
- EXT_STATE_DEFUNCT
- Object no longer exists
- EXT_STATE_SELECTABLE_TEXT
- For text which is selectable, object must implement nsIAccessibleText
- EXT_STATE_EDITABLE
- Implements nsIAccessibleEditableText
- EXT_STATE_ACTIVE
- This window is currently the active window
- EXT_STATE_MODAL
- Must do something with control before leaving it
- EXT_STATE_MULTI_LINE
- Edit control that can take multiple lines
- EXT_STATE_HORIZONTAL
- Uses horizontal layout
- EXT_STATE_OPAQUE
- Indicates this object paints every pixel within its rectangular region
- EXT_STATE_SINGLE_LINE
- This text object can only contain 1 line of text
- EXT_STATE_TRANSIENT
- EXT_STATE_VERTICAL
- Especially used for sliders and scrollbars
- EXT_STATE_STALE
- Object not dead, but not up-to-date either
- EXT_STATE_ENABLED
- A widget that is not unavailable
- EXT_STATE_SENSITIVE
- Same as ENABLED for now
- EXT_STATE_EXPANDABLE
- If COLLAPSED or EXPANDED