613-518-1166 info@zimdatabases.com

ZIM Language Reference

WINDOW ACTIVATE

< All Topics

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.

 

See Also

$iswinopen

ThisWindow

WINDOW CLEAR

WINDOW DEACTIVATE

WINDOW DISPLAY

WINDOW MOVE

WINDOW SCROLL

WINDOW SET

WINDOW SIZE

Was this article helpful?
0 out Of 5 Stars
5 Stars 0%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%
How can we improve this article?
Table of Contents