Edit

Up-Down Control (MSAA UI Element Reference)

  • Article

Note

This topic describes Up-Down Control objects for purposes of MSAA UI Element Reference. How to create Up-Down Control objects in various UI frameworks is not described here. See the API reference documentation for the UI framework you're using.

An up-down control, also known as a spin control, combines a pair of buttons displayed as arrows with a buddy edit control. Clicking the arrows increments or decrements the value in the edit control.

The window class name for a up-down control is UPDOWN_CLASS, which is defined as "msctls_updown32" in Commctrl.h.

IAccessible Methods

An up-down control supports the following IAccessible methods:

IAccessible Properties

An up-down control supports the following IAccessible properties:

Property Comments
get_accChild
get_accChildCount The ChildCount property is "2" (the up and down arrow buttons).
get_accFocus
get_accHelp
get_accHelpTopic
get_accName The Name property for the up-down control object is obtained from the control's window text (or caption). This text is not displayed with the up-down control, so server developers must provide meaningful text in the control's resource definition statement to help users of client utilities identify the control. The Name property for the top arrow button in the up-down control is "More", and the Name property for the bottom arrow button is "Less".
get_accParent The Parent property of the up-down control is a window ( ROLE_SYSTEM_WINDOW ) that surrounds the control and has the same Name property and window class name as the control. The Parent property of the up and down arrow buttons is the up-down control object.
get_accRole The Role property for up-down control object is ROLE_SYSTEM_SPINBUTTON. The Role property for the arrow buttons is ROLE_SYSTEM_PUSHBUTTON.
get_accState The State property for up-down control object is one of the following values:STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE
get_accValue

Notes

Microsoft Active Accessibility exposes the buddy edit control as a separate object.

IAccessible Interface