Up-Down Control

  • Article

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.

Supported Properties and Methods

  • accHitTest
    accLocation
    accNavigate
    accSelect
    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

Events Generated

EVENT_OBJECT_STATECHANGE

EVENT_OBJECT_VALUECHANGE

Remarks

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

See Also

IAccessible Interface