To ensure that the methods supported for a UI Automation control cover the corresponding controls in all supported technologies, the Silk4J API supports only a subset of the methods and properties available for these controls. To call additional methods and properties that are not available in the Silk4J API for a control, use dynamic invoke.
Dynamic invoke enables you to directly call methods, retrieve properties, or set properties, on an actual instance of a control in the application under test. You can also call methods and properties that are not available in the Silk4J API for this control. Dynamic invoke is especially useful when you are working with custom controls, where the required functionality for interacting with the control is not exposed through the Silk4J API.
Call dynamic methods on objects with the invoke method. To retrieve a list of supported dynamic methods for a control, use the getDynamicMethodList method.
Call multiple dynamic methods on objects with the invokeMethods method. To retrieve a list of supported dynamic methods for a control, use the getDynamicMethodList method.
Retrieve dynamic properties with the getProperty method and set dynamic properties with the setProperty method. To retrieve a list of supported dynamic properties for a control, use the getPropertyList method.
control.invoke("SetTitle","my new title");
Silk4J types include primitive types, for example boolean, int, and string, lists, and other types, for example Point and Rect.
Enum parameters must be passed as string. The string must match the name of an enum value. For example, if the method expects a parameter of the .NET enum type System.Windows.Visiblity you can use the string values of Visible, Hidden, or Collapsed.
Pass .NET struct and object parameters as a list. The elements in the list must match one constructor for the .NET object in the test application. For example, if the method expects a parameter of the .NET type System.Windows.Vector, you can pass a list with two integers. This works because the System.Windows.Vector type has a constructor with two integer arguments.
Control parameters can be passed as TestObject.
To retrieve this string representation, call the ToString method on returned .NET objects in the application under test.
This example shows how you can call the scrolling methods of a UIADocument control by using dynamic invoke. Silk4J does not expose these scrolling methods in the API, as these methods are not available for the UIADocument control in all technologies that have implemented UI Automation provider interfaces.
UIADocument textBox = mainWindow.<UIADocument>find("//UIADocument"); List<String>propertyList = textBox.getPropertyList(); List<String> methodList = textBox.getDynamicMethodList();
For this example, the propertyList that is returned by the GetPropertyList method includes the property ScrollPattern.VerticalScrollPercent. The methodList that is returned by the GetDynamicMethodList method includes the method ScrollPattern.ScrollVertical.