You can create custom classes for custom controls for which
Silk4NET does not offer any dedicated support. Creating custom classes offers the following advantages:
- Better locators for scripts.
- An easy way to write reusable code for the interaction with the custom control.
Example: Testing the
UltraGrid Infragistics control
Suppose that a custom
grid control is recognized by
Silk4NET as the generic class
Control. Using the custom control support of
Silk4NET has the following advantages:
- Better object recognition because the custom control class name can be used in a locator.
- Many objects might be recognized as
Control. The locator requires an index to identify the specific object. For example, the object might be identified by the locator
//Control[13]. When you create a custom class for this control, for example the class
UltraGrid, you can use the locator
//UltraGrid. By creating the custom class, you do not require the high index, which would be a fragile object identifier if the application
under test changed.
- You can implement reusable playback actions for the control in scripts.
-
When you are using custom classes, you can encapsulate the behavior for getting the contents of a grid into a method by adding
the following code to your custom class, which is the class that gets generated when you specify the custom control in the
user interface.
Typically, you can implement the methods in a custom control class in one of the following ways:
- You can use methods like
Click,
TypeKeys,
TextClick, and
TextCapture.
- You can dynamically invoke methods on the object in the AUT.
- You can dynamically invoke methods that you have added to the AUT. This is the approach that is described in this example.
You can use the following code to call the static method that is defined in the example in
Adding Code to the Application Under Test to Test Custom Controls. The method
GetContents is added into the generated class
UltraGrid.
' VB code
Partial Public Class UltraGrid
Public Function GetContents() As IList
Return Invoke("AUTExtensions.UltraGridUtil.GetContents", Me)
End Function
End Class
// C# code
public partial class UltraGrid {
public System.Collections.IList GetContents() {
return (System.Collections.IList) Invoke("AUTExtensions.UltraGridUtil.GetContents", this);
}
}
When you define a class as a custom control, you can use the class in the same way in which you can use any built-in class,
for example the
Dialog class.
' VB code
Dim ultraGrid As UltraGrid = mainWindow.UltraGrid("@automationId='my grid'")
Dim contents = ultraGrid.GetContents()
// C# code
UltraGrid ultraGrid = mainWindow.UltraGrid("@automationId='my grid'");
IList contents = ultraGrid.GetContents();