Title Bar (MSAA UI Element Reference)
Note
This topic describes Title Bar objects for purposes of MSAA UI Element Reference. How to create Title Bar objects in various UI frameworks is not described here. See the API reference documentation for the UI framework you're using.
The title bar at the top of a window displays an application-defined icon and line of text. The text specifies the name of the application and indicates the purpose of the window. The title bar also makes it possible for the user to move the window using a mouse or other pointing device.
Title bars contain at least three small buttons that minimize, maximize or restore, and close the window associated with the title bar. Title bars also contain a context-sensitive Help button. Applications running in the Far-East version of the Windows operating system may also contain Input Method Editor (IME) buttons. Microsoft Active Accessibility exposes these buttons as child elements of the title bar.
IAccessible Methods
Title bars support the following IAccessible methods:
IAccessible Properties
Title bars support the following IAccessible properties:
| Property | Comments |
|---|---|
| get_accChildCount | The ChildCount property is five. The ChildCount property includes the IME and context-sensitive Help buttons even when they are not displayed. Buttons that are not displayed have the State property STATE_SYSTEM_INVISIBLE. |
| get_accDescription | The Description property of the title bar itself is: "Displays the name of the window and contains controls to manipulate it." The child buttons in the title bar have the following descriptions:
|
| get_accName | The title bar itself does not support the Name property. The child buttons in the title bar have the following names:
|
| get_accParent | The Parent property of the title bar is the main application window ( ROLE_SYSTEM_WINDOW ) that has the same application-defined window class name as the title bar. |
| get_accRole | The Role property is ROLE_SYSTEM_TITLEBAR. The child buttons in the title bar have the Role property ROLE_SYSTEM_PUSHBUTTON. |
| get_accState | The State property for the title bar and the child buttons can be a combination of one or more of the following values: STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_INVISIBLE STATE_SYSTEM_OFFSCREEN STATE_SYSTEM_UNAVAILABLE STATE_SYSTEM_PRESSED |
| get_accValue | The Value property is a string that is the same as the text displayed in the title bar. |
Notes
- Although an application's title bar has the State property flag STATE_SYSTEM_FOCUSABLE, it never has the State flag STATE_SYSTEM_FOCUSED. Setting focus to a title bar object focuses the application window.
- Because the title bar object does not support get_accChild, the buttons on the title bar are simple elements. They do not support the IAccessible interface themselves. The title bar object provides information about these child buttons.
- Because title bars do not get focus and have no default action, the accDoDefaultAction and get_accDefaultAction methods are not supported for this control.