Edit

Share via


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:
  • "Moves the window out of
  • "Makes the window full
  • "Puts a minimized or
  • "Closes the window"
  • "Enters or leaves context-
  • "Brings up the keyboard when pressed"
get_accName The title bar itself does not support the Name property. The child buttons in the title bar have the following names:
  • "Minimize"
  • "Maximize" or "Restore",
  • "Close"
  • "Context help"
  • "IME"
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.

IAccessible Interface