Dynamically Invoking Silverlight Methods

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 Silk4NET 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 Silk4NET 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.

For example, to call a method named SetTitle, which requires the title to be set as an input parameter of type string, on an actual instance of a control in the application under test, type the following:

control.Invoke("SetTitle", "my new title")

Note: Typically, most properties are read-only and cannot be set.

Note: Reflection is used in most technology domains to call methods and retrieve properties.

Supported Parameter Types

The following parameter types are supported:

All built-in Silk4NET types.
Silk4NET types include primitive types, for example boolean, int, and string, lists, and other types, for example Point and Rect.
Enum types.
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.
.NET structs and objects.
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.
Other controls.
Control parameters can be passed as TestObject.

Supported Methods and Properties

The following methods and properties can be called:

All public methods and properties that the MSDN defines for the AutomationElement class. For additional information, see http://msdn.microsoft.com/en-us/library/system.windows.automation.automationelement.aspx.
All methods and properties that MSUIA exposes. The available methods and properties are grouped in "patterns". Pattern is a MSUIA specific term. Every control implements certain patterns. For an overview of patterns in general and all available patterns see http://msdn.microsoft.com/en-us/library/ms752362.aspx. A custom control developer can provide testing support for the custom control by implementing a set of MSUIA patterns.

Returned Values

The following values are returned for properties and methods that have a return value:

The correct value for all built-in Silk4NET types.
All methods that have no return value return null in C# or Nothing in VB.
A string for all other types.
To retrieve this string representation, call the ToString method on returned .NET objects in the application under test.

Dynamically Invoking Silverlight Methods

Supported Parameter Types

Supported Methods and Properties

Returned Values

Example