VerifyActive Method

Class

AnyWin class.

Action

Verifies that the window is active.

Syntax

window.VerifyActive([bActive][, nTimeout])
Variable Description
bActive Optional: TRUE (the default) verifies that the window is active. FALSE verifies that the window is inactive. BOOLEAN.
nTimeout Optional: The number of seconds to wait for the window to become active or inactive, depending on the value of bActive. NUMBER.

Notes

VerifyActive verifies that the window is active. Calling this method is the same as calling the Verify function in the following manner:
Verify(window.IsActive(), expected_state)

VerifyActive raises the exception E_WINDOW_NOT_ACTIVE if the window is not active.

Some other methods will verify that the window they are operating on is active if active window verification is enabled (specified with the OPT_VERIFY_ACTIVE option, which you set with SetOption).

If a timeout is specified with the nTimeout parameter, Silk Test Classic calls VerifyActive() until the condition is verified or the timeout is reached. The time between checks is the value of the window retry interval Agent option (OPT_WINDOW_RETRY). If the verification fails, an exception is thrown.

Example

// choose the Find command
TextEditor.Search.Find.Pick()
// check whether the Find dialog box appears
Find.VerifyActive()
// close the Find dialog box
Find.Close()