Project Properties - MSAA Options

This page is available if you have the Microsoft Active Accessibility Support plugin enabled in TestComplete. The plugin is installed and enabled by default when you install TestComplete.

If this page is not available, open the File > Install Extensions dialog and make sure that the plugin is enabled.

1. Select Tools > Current Project Properties from the TestComplete menu.

2. Select the Open Applications > MSAA category from the tree on the left.

Click the image to enlarge it.

• List of accepted windows - Specifies windows and controls TestComplete will recognize by their accessibility information. The syntax is as follows:

  WndClass
  WndClass;@text=WndCaption
  *;@text=WndCaption

  where WndClass is the object’s window class name, and WndCaption is the object’s caption or the text of the window’s title bar. To learn the object’s window name, view its WndClass property, and to get the object’s caption or title, view its WndCaption property in the Object Browser.

  Note:

  The syntax ending with ;@text=WndCaption is supported only if the Work with MSAA objects in mode compatible with TestComplete 6 and earlier option is not selected.

  You can use wildcards (* and ?) to match multiple window types based on some common pattern. The asterisk (*) matches a string of any length, including an empty string, the question mark (?) matches any single character or no character.

  Examples:

  Object Type	Description
  DirectUIHWND	Objects with the window class DirectUIHWND.
  Vfp*	Objects whose window class begins with Vfp.
  XTPReport;@text=My Report	Objects with the window class XTPReport and caption My Report.
  *;@text=My Report	Objects with the caption My Report and any window class.
  *;@text=*Report	Objects whose caption ends with Report.
  *	All objects. For performance reasons, we do not recommend that you use this pattern. Use a specific window pattern instead. To learn more, see Enhancing TestComplete Performance.

  Specify the pattern and select the check box next to it. TestComplete will use the MSAA identification only for patterns that have the check box selected.

  TestComplete will ignore patterns with cleared check boxes.

• Work with MSAA objects in mode compatible with TestComplete 6 and earlier – Specifies the format in which TestComplete addresses objects exposed by the MSAA engine.

  Clear the check box (by default) to configure TestComplete to address objects by their type names, such as Panel, ListItem, and so on.

  Select the check box to enable the compatibility mode and command TestComplete to address objects using the MSAAObject and WaitMSAAObject methods, like it used to do in version 6 and earlier.

  For more information, see Addressing Objects in MSAA Open Applications.

  When you change this option in the default project of your project suite, TestComplete updates the Object Browser panel so that it displays the object names in the appropriate manner.

  This option affects how TestComplete records object names and addresses objects during playback. The tests created in the compatibility mode will not play back correctly in the new mode and vice versa.