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.