Providing the Name Property

Server developers must take care when creating predefined and common controls to ensure that Active Accessibility can expose the Name property for the control. Depending on the type of control, the text for the Name property comes from one of the following:

• The control's window text (or caption)
• Static text that labels the control

To find the control's window text, Active Accessibility sends the WM_GETTEXT message to the control. This text corresponds to the text parameter in the control's resource definition statement. For some controls, such as buttons, this is the same text that is displayed with the control. For other controls, such as toolbars, this text is not displayed. Therefore, server developers must provide meaningful text in the control's resource definition statement to help users of client utilities identify the control.

To find the control's label, Active Accessibility searches for a static text control by calling GetWindow with the GW_HWNDPREV flag. The search is halted if a static text control is found, or if a control is encountered that has the window styles WS_GROUP | WS_TABSTOP. This search order corresponds to the reverse tab order on a dialog box. Server developers must observe the tab order when creating controls so that a static text control immediately precedes the control that it labels.

The documentation in this appendix describes which of the above techniques Active Accessibility uses to expose the Name property.