Up-Down Control (MSAA UI Element Reference)
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.