Class
DesktopApplication

Represents desktop application.

Definition

Namespace:ArtOfTest.WebAii.DesktopAutomation

Assembly:ArtOfTest.WebAii.dll

Syntax:

cs-api-definition
public class DesktopApplication

Inheritance: objectDesktopApplication

Properties

MainWindow

Get desktop object referencing application main window.

Declaration

cs-api-definition
public DesktopApplicationWindow MainWindow { get; }

Property Value

DesktopApplicationWindow

Instance of DesktopApplicationWindow.

Manager

Reference to manager.

Declaration

cs-api-definition
public Manager Manager { get; }

Property Value

Manager

Popups

Get application popups.

Declaration

cs-api-definition
public DesktopApplicationPopup[] Popups { get; }

Property Value

DesktopApplicationPopup[]

Process

Get process of desktop application.

Declaration

cs-api-definition
public Process Process { get; }

Property Value

Process

QuitOnDetach

Whether to close application when the testing framework detaches from the application.

Declaration

cs-api-definition
public bool QuitOnDetach { get; set; }

Property Value

bool

Windows

Get desktop windows in application.

Declaration

cs-api-definition
public DesktopApplicationWindow[] Windows { get; }

Property Value

DesktopApplicationWindow[]

Methods

Detach()

Detach from underlying application.

Declaration

cs-api-definition
public void Detach()

Detach(bool)

Detach from underlying application.

Declaration

cs-api-definition
public void Detach(bool quitOnDetach)

Parameters

quitOnDetach

bool

Indicates whether application should be closed or not. Set to true to close.

Quit()

Quit desktop application.

Declaration

cs-api-definition
public void Quit()

Refresh(int)

Check whether application has changed its state and update MainWindow and Windows.

Declaration

cs-api-definition
public void Refresh(int depth = 2)

Parameters

depth

int

Indicates max level we need to search UI tree to find process related element.

WaitForPopup(string, int, int)

Wait for popup with particular class name and control type to appear.

Declaration

cs-api-definition
public DesktopApplicationPopup WaitForPopup(string className, int delay = 500, int timeout = 15000)

Parameters

className

string

Popup class name.

delay

int

Delay between retries.

timeout

int

Maximum time in milliseconds to wait.

Returns

DesktopApplicationPopup

Instance of DesktopApplicationPopup.

Exceptions

TimeoutException

Throws TimeoutException if the Popup is not found during the allotted time.

WaitForWindow(string, int, int)

Wait for window with particular name to appear.

Declaration

cs-api-definition
public DesktopApplicationWindow WaitForWindow(string name, int delay = 500, int timeout = 15000)

Parameters

name

string

Window name.

delay

int

Delay between retries.

timeout

int

Maximum time in milliseconds to wait.

Returns

DesktopApplicationWindow

Instance of DesktopApplicationWindow.

Exceptions

TimeoutException

Throws TimeoutException if the Window is not found during the allotted time.