Links

TesterHelperExtensions Methods

PerformActionAndWaitForScreenUpdate

Performs the specified action and waits for an update on the screen, returns false if no update is registered. This method is similar to WaitUntilScreenUpdate, but ensures the update check is registered before we attempt the action.

Syntax:

public static bool PerformActionAndWaitForScreenUpdate(
this ITester t,
Action action,
ImgDiffTolerance tolerance,
double timeToWaitForUpdateInSeconds,
params IImageFilter[] filters
)

Parameters:

Parameter
Description
t
Type: ITester The ITester interface on which the extension is called.
action
Type: Action The action that should be performed and checked for an effect on the screen.
tolerance
Type: ImgDiffTolerance How different a new image needs to be so that we will count it as an update.
timeToWaitForUpdateInSeconds
Type: Double The time during which the screen is monitored for updates after the action.
filters
Type: IImageFilter[ ] Typically a Select filter indicating the area of interest.

Return Value:

Returns true if a screen update was registered within the timeToWaitForUpdateInSeconds, false otherwise.

WaitUntil

Waits until the specified dateTime is reached on the system under test. If the dateTime is already passed, it doesn't wait.

Syntax:

public static void WaitUntil(
this ITester t,
DateTime dateTime,
ISutLocale sutLocale
)

Parameters:

Parameter
Description
t
Type: ITester The ITester interface on which the extension is called.
dateTime
Type: DateTime The date time on the sut until when shall be waited.
sutLocale
Type: Progile.TRIO.BaseModel.ISutLocale The sutLocale that provides the dateTime of the sut.

WaitUntilScreenUpdate

Waits until a relevant screen update is received. Returns false if after the timeout still no update was received. If the expected update happens directly after an interaction with the sut, the update register might happen too late. In this case use PerformActionAndWaitForScreenUpdate instead.

Syntax:

public static bool WaitUntilScreenUpdate(
this ITester t,
ImgDiffTolerance tolerance,
double timeOutInSeconds,
params IImageFilter[] filters
)

Parameters:

Parameter
Description
t
Type: ITester The ITester interface on which the extension is called.
tolerance
Type: ImgDiffTolerance How different a new image needs to be so that we will count it as an update.
timeOutInSeconds
Type: Double The timeout after which the method returns false.
filters
Type: IImageFilter[ ] Typically a Select filter indicating the area of interest.

Return Value:

Returns true if a screen update was registered within the timeOutInSeconds, false otherwise.

WaitUntilStableScreen

Waits until the screen is stable, meaning no more relevant updates are occuring anymore in the selected area. Returns false if after the specified timeout the screen is not yet stable.

Syntax:

public static bool WaitUntilScreenUpdate(
this ITester t,
ImgDiffTolerance tolerance,
double expectedStableTimeInSeconds,
double timeOutInSeconds,
params IImageFilter[] filters
)

Parameters:

Parameter
Description
t
Type: ITester The ITester interface on which the extension is called.
tolerance
Type: ImgDiffTolerance How different a new image can be so that we will still count the screen as stable.
expectedStableTimeInSeconds
Type: Double The expected time the screen should be stable (no relevant updates received during this time).
timeOutInSeconds
Type: Double The timeout after which the method returns false.
filters
Type: IImageFilter[ ] Typically a Select filter indicating the area of interest.

Return Value:

Returns true if the screen was stable for expectedStableTimeInSeconds before the timeOutInSeconds expired, false otherwise.