WONTOP()

Class

Screen Windows

Purpose

Function to check if the specified window is on top of the others

Syntax

WONTOP([<window-name>])

See Also

ACTIVATE SCREEN, ACTIVATE WINDOW, CLEAR WINDOWS, DEACTIVATE WINDOW, DEFINE WINDOW, HIDE WINDOW, MOVE WINDOW, MODIFY MEMO, RELEASE WINDOWS, RESIZE WINDOW, RESTORE WINDOW, SAVE WINDOW, SHOW WINDOW, SET COMMANDWINDOW, SET ERRORWINDOW, SET STATUS, SET TRACEWINDOW, SET WINDOW OF EDIT, SET WINDOW OF MEMO, WCOLS(), WEXIST(), WOUTPUT(), WROWS(), WVISIBLE()

Description

The WONTOP() function is used to determine which window is the topmost. A window is an area of the screen designated for output and input. Windows are created with the DEFINE WINDOW command, and are activated with the ACTIVATE WINDOW command. There is no limit to the number of defined windows.

Windows may be displayed or moved on top of one another. The command ACTIVATE WINDOW activates a specified window, and displays it according to its coordinates, regardless of the number of windows already displayed on the screen. The MOVE WINDOW command may be used to move windows by degrees or to certain coordinates. If the moving window is the active window, it will overlay existing windows. The RESIZE WINDOW command, used to change the size of a window, will also overlay existing windows with the active window. With no parameter, the WONTOP() function returns the name of the top most window in upper case.

If the window specified by <window-name> has not been defined, or is covered by another window, the WONTOP() function returns .F.. If the specified <window-name> is the topmost window the WONTOP() function returns .T..

Example

activate window edit
activate window memo
activate window browse
?wontop()
BROWSE
?wontop("memo")
.F.

Products

Recital Mirage Server, Recital Terminal Developer