WaitTillActive

Description:

baWaitTillActive pauses execution until a specified window becomes the active one.

Platforms:

Windows

Usage:

baWaitTillActive( WindowHandle )

Arguments:

Integer.
WindowHandle is the handle of the window to wait for.

Returns:

Void.

Examples:

Director:
baWaitTillActive( baWinHandle() ) -- wait till Director window becomes the active one

Authorware:
baWaitTillActive( baWinHandle() ) -- wait till Authorware window becomes the active one
 

Notes:

This function is mainly intended to be used with the baRunProgram function. The RunProgram function can pause execution until the jumped to program quits. This may cause a problem if the user switches back to the Authorware program without quitting the jumped to program. If you use the baRunProgram without the pause option, you can use this function (after a short wait) to resume the program if the user switches back to it.

This function is provided for compatibility with older versions. New applications should use the baWaitForWindow function.
 

See also:

baWaitForWindow
baNextActiveWindow
baActiveWindow