 |
This method is obsolete. See the Remarks section below. |
Description
Use this method to obtain a scripting interface to the specified object exposed by methods of the IAccessible interface, which is implemented by WindowObj. The resulting object contains both methods and properties provided by MSAA as well as methods, properties and actions provided by TestComplete.
Declaration
TestObj.MSAAObject(Name)
| TestObj | A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section | |||
| Name | [in] | Required | String | |
| Result | Object | |||
Applies To
The method is applied to the following object:
View Mode
To view this method in the Object Browser panel and in other panels and dialogs, activate the Advanced view mode.
Parameters
The method has the following parameter:
Name
The name of the desired object. Wildcard characters ('*' and '?') can be used in this parameter.
Result Value
The MSAAObject method returns an object that provides a scripting interface to an object that is exposed through the IAccessible interface implemented by the window. If TestComplete cannot access the specified object (for example, this object does not exist), MSAAObject will return an empty stub object. To determine whether the method returns a valid object, use the Exists property of the resultant object. If this property returns False, then the returned object is a stub object and the call to MSAAObject was not successful.
Remarks
The MSAAObject method is available only if the Microsoft Active Accessibility Support plugin is installed and enabled in TestComplete. Otherwise, the method is absent in the method list of the Window object.
This method is obsolete and supported for backward compatibility only. TestComplete 7 and later addresses objects exposed by the MSAA engine by type names (see Addressing Objects in MSAA Open Applications).
The returned object contains both methods and properties exposed by IAccessible as well as methods, properties and actions provided by TestComplete. The resulting object may hold two or more methods and properties having the same name. When you call such a method or property, a naming conflict will occur. To avoid it and to specify which method or property is to be called, use the NativeMSAA namespace.
Example
To view an example that demonstrates how to use the MSAAObject method, see Addressing Objects in MSAA Open Applications.
See Also
Using Microsoft Active Accessibility
Implementing MSAA Support Manually
Window Method
WaitMSAAObject Method