WindowOnTop

Keep window on top.

 

Syntax:

WindowOnTop( partial-winname, mode [,retry] )

Parameters:

(s) partial-winname partial windowname of the window to be affected.

(i) mode A number specifying what action to take. See below.

(i) retry [optional] specifying window retry timeout to use. See below.

Returns:

(i) returns @TRUE on success, @FALSE on failure.

 

This function tells the specified window to remain on top of all other windows, or to return to a normal (non-topmost) state.

 

Mode

Meaning

0

Don't stay on top

1

Stay on top

-1

Return window's current topmost state:
@TRUE
= topmost
@FALSE
= not topmost

 

Retry

Meaning

@TRUE

Use the current timeout setting to wait for the target window to appear.

Note that IntControl 46 can be used to change the current retry timeout setting (default is 9 seconds).

@FALSE

(default) Omit timeout.  Immediately generate an error when target window is not found.

 

Example:


Run("calc.exe","")
;Place calc window on top
WindowOnTop("Calculator",1)

See Also:

IntControl 46, WinState