Edit

Check Box (MSAA UI Element Reference)

  • Article

Note

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

Check boxes are used to enable or disable one or more features or options from a set, usually within a dialog box. Typically, a check box contains a small box with adjoining text. When an option is selected, a check mark appears in the box.

The window class name for a check box is "BUTTON".

IAccessible Methods

Check boxes support the following IAccessible methods:

Method Comments
accDoDefaultAction The accDoDefaultAction method calls PostMessage with the BM_CLICK button message to click the check box.
accHitTest
accLocation
accNavigate
accSelect

IAccessible Properties

Check boxes support the following IAccessible properties:

Property Comments
get_accChild
get_accChildCount The ChildCount property is zero.
get_accDefaultAction The DefaultAction property of a check box depends on whether it is selected. A check box that is not selected has "Check" as its DefaultAction, and a check box that is selected has "UnCheck" as its DefaultAction. The DefaultAction for a three-state check box is "Toggle".
get_accDescription
accFocus
accKeyboardShortcut The KeyboardShortcut property is the check box's access key, which is an underlined character in the control's window text. This string contains the access key character appended to the string "Alt+".
accHelp The Name property is obtained from the control's window text (or caption), which is displayed with the check box.
accHelpTopic
accName The Name property is obtained from the control's window text (or caption), which is displayed with the check box.
accParent The Parent property is a window ( ROLE_SYSTEM_WINDOW ) that surrounds the control and has the same Name property and window class name as the control.
accRole The Role property is ROLE_SYSTEM_CHECKBUTTON.
accState The State property is a combination of one or more of the following values:STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_MIXED | STATE_SYSTEM_CHECKED | STATE_SYSTEM_NORMAL

IAccessible Interface