NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

AccessibleStates Enumeration

Specifies values representing possible states for an accessible object

[Visual Basic]
Public Enum AccessibleStates
[C#]
public enum AccessibleStates
[C++]
public enum AccessibleStates

[JScript] In JScript, you can use the enumerations in the NGWS frameworks, but you cannot define your own.

Remarks

An accessible object refers to any user interface that supports the IAccessible interface.

An accessible object can be associated with one or more of these states.

Members

Member Name Description
AlertHigh Important information that should be conveyed to the user immediately. For example, a battery level indicator reaching a critical low level would transition to this state, in which case a blind access utility would announce this information immediately to the user, and a screen magnification program would scroll the screen so that the battery indicator is in view. This state is also appropriate for any prompt or operation that must be completed before the user can continue.
AlertLow Low-priority information that may not be important to the user.
AlertMedium Important information that does not need to be conveyed to the user immediately. For example, when a battery level indicator is starting to reach a low level, it could generate a medium-level alert. Blind access utilities could then generate a sound to let the user know that important information is available, without actually interrupting the user's work. The user could then query the alert information at his or her leisure.
Animated The object has a rapidly or constantly changing appearance. Graphics that are occasionally animated, but not always, should be defined as AccessibleRoles.Graphic | AccessibleStates.Animated. This state should not be used to indicate that the object's location is changing.
Busy A control that cannot accept input in its current condition.
Checked An object with a selected check box.
Collapsed Children of the object that are items in an outline or tree structure are hidden.
Default The default button or menu item.
DefaultState The system provided state for the accessible object.
Expanded Children of the object that are items in an outline or tree structure are displayed.
ExtSelectable Alters the selection so that all objects between the selection anchor, which is the object with the keyboard focus, and this object take on the anchor object's selection state. If the anchor object is not selected, the objects are removed from the selection. If the anchor object is selected, the selection is extended to include this object and all the objects in between. You can set the selection state by combining this flag with AccessibleSelection.AddSelection or AccessibleSelection.RemoveSelection. This flag does not change the focus or the selection anchor unless it is combined with AccessibleSelection.TakeFocus. The behavior of AccessibleStates.ExtendSelection | AccessibleSelection.TakeFocus is equivalent to adding an item to a selection manually by holding down the SHIFT key and clicking an unselected object. This flag may not be combined with AccessibleSelection.TakeSelection.
Floating The object is not fixed to the boundary of its parent object, and does not move automatically along with the parent.
Focusable The object is on the active window and can receive keyboard focus.
Focused An object with the keyboard focus.
HotTracked The object is hot-tracked by the mouse, meaning its appearance is highlighted to indicate the mouse pointer is located over it.
Indeterminate A three-state check box or toolbar button whose state is indeterminate. The check box is neither checked nor unchecked and it is in the third or mixed state.
Invisible An invisible object.
Linked A linked object that has not been previously selected.
Marqueed An object with scrolling or moving text or graphics.
Mixed A three-state check box or toolbar button whose state is indeterminate. The check box is neither checked nor unchecked and it is in the third or mixed state.
Moveable A movable object.
MultiSelectable An object that accepts multiple selected items.
Offscreen No on-screen representation. A sound or alert object would have this state, or a hidden window that is never made visible.
Pressed A pressed object.
Protected A password-protected edit control.
ReadOnly A read-only object.
Selectable An object that can accept selection.
Selected A selected object.
SelfVoicing The object or child can use text-to-speech (TTS) to describe itself. A speech-based accessibility aid should not announce information when an object with this state has the focus because the object will automatically announce information about itself.
Sizeable A sizable object.
Traversed A linked object that has previously been selected.
Unavailable An unavailable object.
Valid A valid object.

Requirements

Namespace: System.WinForms

Assembly: System.WinForms.dll

See Also

System.WinForms Namespace | AccessibleEvents | AccessibleObject | AccessibleNavigation | System.WinForms.AccessibleRole | AccessibleSelection