View source for HIDE WINDOW

==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()]], [[WTITLE()]], [[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==
<code lang="recital">
// 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
</code>

==Products==
Recital Mirage Server, Recital Terminal Developer
[[Category:Documentation]]
[[Category:Commands]]
[[Category:Screen Windows]]
[[Category:Screen Windows Commands]]