Identifying .NET Objects

Applies to TestLeft 4.80, last modified on April 13, 2021
Search Patterns

TestLeft allows you to test .NET Windows Forms and VCL.NET applications.

To search for WinForms objects, use search patterns of the WinFormsPattern type. To search for VCL.NET objects, use the VCLNETPattern search pattern type.

.NET: The patterns belong to the SmartBear.TestLeft.TestObjects.WinForms and SmartBear.TestLeft.TestObjects.VCLNET namespaces correspondingly.

Java: The patterns belong to the com.example.smartbear.testleft.testobjects package.

These patterns use the following properties:

Property Type Description
ClrFullClassName String The object’s full class name including the namespace name. For example, System.Windows.Forms.Button.
Enabled Boolean Specifies whether the object is enabled or disabled. Disabled objects are usually shown grayed out.
Index Integer The object’s position in the front-to-back order (Z-order) within the parent object. Indexes start from 1 and are unique among sibling objects with the same window class (the WndClass property value). You can see this value in the TestLeft UI Spy.
Visible Boolean Specifies whether the object is visible in the application. Objects that are out of screen bounds or overlapped by other objects are still considered visible.
VCLNETControlName String Used only for VCL.NET objects. The object name specified by the developers in the application code. This is the Name native property of the object.
WinFormsControlName String Used only for WinForms objects. The object name specified by the developers in the application code. This is the Name native property of the object.
WndCaption String The object text. For example, window title, button text, text in a text box, check box caption, and so on.
Example

C#

IButton button = Driver.Find<IProcess>(new ProcessPattern()
{
   ProcessName = "Orders"
}).Find<ITopLevelWindow>(new WinFormsPattern()
{
   WinFormsControlName = "OrderForm"
}).Find<IButton>(new WinFormsPattern()
{
   ClrFullClassName = "System.Windows.Forms.Button",
   WndCaption = "OK"
});

Visual Basic .NET

Dim button As IButton = Driver.Find(Of IProcess)(New ProcessPattern() With {
   .ProcessName = "Orders"
}).Find(Of ITopLevelWindow)(New WinFormsPattern() With {
   .WinFormsControlName = "OrderForm"
}).Find(Of IButton)(New WinFormsPattern() With {
   .ClrFullClassName = "System.Windows.Forms.Button",
   .WndCaption = "OK"
})

Java

Button button = driver.find(Process.class, new ProcessPattern() {{
   ProcessName = "Orders";
}}).find(TopLevelWindow.class, new WinFormsPattern() {{
   WinFormsControlName = "OrderForm";
}}).find(Button.class, new WinFormsPattern() {{
   ClrFullClassName = "System.Windows.Forms.Button";
   WndCaption = "OK";
}});

Custom Properties

You can also specify custom properties by using the .add("propertyname", value) method of the pattern object. See Using Custom Properties in Search Patterns.

See Also

Understanding Object Identification
Preparing .NET Applications for Testing

Highlight search results