WINDOW ACTIVATE

Makes an open window available for viewing and interaction by the application user.

Syntax

WINDOW ACTIVATE [window] [EXPOSE|HIDE]

Parameters

window

Window can be
name
The name of an open window. The software looks up name in the currently accessed directories in the usual way. A compiled command using name contains the unambiguous name of the window (including a reference to an application directory) that was found at compile time.
(expr )
A character string, or an expression that evaluates to a character string, that is to be used at run time as a window object name. The parentheses must be entered.
A compiled command using (expr) can refer to many windows, at the risk of encountering an ambiguous window name (i.e., no directory specified when versions of the window are available in two or more directories).
If neither name nor (expr) is specified, the current window is assumed.

EXPOSE

(DEFAULT) Specifies that the window is to be displayed over any other active windows already on the screen.

HIDE

Specifies that the window is to be displayed beneath any other active windows already on the screen.

Comments

WINDOW ACTIVATE makes an open window visible on the terminal screen so that the application user can interact with the window. Note, however, that an input request relating to an inactive window (from a FORM INPUT, INPUT, or MENU INPUT command) automatically activates that window.

WINDOW ACTIVATE does not make the specified window the current window. If the specified window is already the current window, it remains the current window.

Separating the opening of a window (WINDOW OPEN) from the presentation of a window to the application user (WINDOW ACTIVATE) enables you to prepare the window and its contents before making the window visible. Similarly, you can keep a window open for long periods of time, activating it only when needed.

Example

window open wContracts
menu open mContracts
menu display
form open fContracts
form display
window activate

Opens a window, and then opens and displays a menu and form in the window. Once the window is initialized, the WINDOW ACTIVATE command presents it to the application user.

window open wTrace
...other commands...
window activate wTrace
...other commands...
window deactivate wTrace

Activates a trace window when it is required.

 

Related Topics