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

IAccessible Methods

A slider control supports the following IAccessible methods:

• accHitTest
• accLocation
• accNavigate
• accSelect

IAccessible Properties

A slider control supports the following IAccessible properties:

• get_accChild

• get_accChildCount

• get_accDescription

• get_accHelp

• get_accHelpTopic

• 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".

Related topics

IAccessible Interface

Scroll Bar