HIDE WINDOW

From Recital Documentation Wiki
Revision as of 07:09, 30 April 2009 by Barrymavin (Talk | contribs)

Jump to: navigation, search

Class

Screen Windows


Purpose

Remove a window or group of windows from view


Syntax

HIDE WINDOW <window-name> | <window-name list> | ALL


See Also

ACTIVATE SCREEN, ACTIVATE WINDOW, CLEAR WINDOWS, DEACTIVATE WINDOW, DEFINE 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(), WONTOP(), WOUTPUT(), WROWS(), WVISIBLE()


Description

The HIDE WINDOW command is used to temporarily remove, or 'hide', a window or group of windows from the screen. A window is an area of the screen designated for output and input. There is no limit to the number of defined windows. Windows are defined with the DEFINE WINDOW command, and are activated with the ACTIVATE WINDOW command.

The <window-name> is the name of the window as previously specified with the DEFINE WINDOW command. A <window-name list> is a list of window names, each separated by a comma. To hide all currently defined windows, use the ALL keyword.

The HIDE WINDOW command does not deactivate windows. Output may be directed to a hidden window, as long as that window is active. Output to a hidden window remains hidden until the window is revealed with either the SHOW WINDOW or ACTIVATE WINDOW commands.

The HIDE WINDOW command may be used in a hot key procedure to switch the screen display from windows to full screen. Full screen display is enabled with the ACTIVATE SCREEN command. Hot keys enable users, while running an application that is waiting for keyboard input, to press a key to execute a specified procedure.


Example

// winproc.prg
 
procedure hide_win
  activate screen
  display all fields name, event
  hide window browse
return
 
procedure show_win
  show windows
  activate window command
return 
 
set procedure to winproc
set key -1 to hide_win
set key -2 to show_win
set status off
clear
define window browse;
   from 2,2 to 12,43;
   title "BROWSE";
   color n/bg;
   float;
   grow;
   shadow
activate window browse

Products

Recital Mirage Server, Recital Terminal Developer