Gecko States

« AT APIs Support Page

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

Document Tags and Contributors

Contributors to this page: Fredchat, Sheppy, fscholz, Surkov.alexander
Last updated by: Fredchat,