Slider Control (MSAA UI Element Reference)
Note This topic describes Slider Control objects for purposes of MSAA UI Element Reference. How to create Slider Control objects in various UI frameworks is not described here. See the API reference documentation for the UI framework you're using.
A slider control, also called a trackbar control, lets a user select from a range of values by moving a slider. The volume controls in the Windows operating system are slider controls.
The window class name for a slider control is TRACKBAR_CLASS, which is defined as "msctls_trackbar" in Commctrl.h.
The contents of the IAccessible properties depend on whether the slider is vertical or horizontal and on which of the following parts of the slider control is queried by the client:
- Slider window
- Slider thumb
- Shaded area above (or to
- Shaded area below (or to the right of) the slider thumb
A slider control supports the following IAccessible methods:
A slider control supports the following IAccessible properties:
- get_accKeyboardShortcut—The KeyboardShortcut property is the slider window's access key, which is an underlined character in the text of the label for the slider. The returned string contains the access key character appended to the string "Alt+".
get_accName—The Name property depends on the part of the slider that is queried.
The parts of a vertical slider have the following names:
Slider part Name Slider window Static text control used as a label Slider thumb "Position" Shaded area above slider thumb "Page up" Shaded area below slider thumb "Page down"
The parts of a horizontal slider have the following names:
Slider part Name Slider window Static text control used as a label Slider thumb "Position" Shaded area to the left of slider thumb "Page left" Shaded area to the right of slider thumb "Page right"
- get_accParent—The Parent property of the arrow buttons, scroll thumb, and the shaded area on either side of the thumb is the slider window. The Parent property of the slider window is a window ( ROLE_SYSTEM_WINDOW ) that surrounds the control and has the same Name property and window class name.
get_accRole—The Role property depends on the part of the slider that is queried.
Slider part Role Slider window ROLE_SYSTEM_SLIDER Slider thumb ROLE_SYSTEM_INDICATOR Shaded areas on either side of the slider thumb ROLE_SYSTEM_PUSHBUTTON
get_accState—Values for the State property depend on the part of the slider that is queried.
Slider Part Possible state values Slider window STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_NORMAL Slider thumb Zero (0), which means the object is visible, or STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_NORMAL Shaded areas on either side of the slider thumb Zero (0), which means the object is visible, or STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_NORMAL
- get_accValue—The Value property for the slider window indicates the position of the thumb and is a string that contains an integer from "0" through "100".