WinHide Function (ROM Call 0x15)

wingraph.h

void WinHide (WINDOW *w);

Hides a window.

WinHide hides a window pointed to by w (mark it as not-visible so that it is never activated by the system) and updates the screen. When a window is activated (see WinActivate) or when it is opened (unless the WF_VIRTUAL flag is passed to WinOpen), it is marked as visible. All windows in the system are kept in a linked list. When a window in the system is closed, the next visible window in the system is activated and becomes the currently active window. Since virtual windows are never displayed on the screen they are never considered visible. An application's main window is always visible since that is the only view the user has of the application. From the other side, an application may open other windows that it does not want to ever be activated. In that case, use WinHide so that they will never be activated by the system. Although the given window will not be activated by the system, writes to it still go to the screen (unless it is a virtual window).


Uses: UpdateWindows
Used by: cmd_disp, cmd_disphome, cmd_input, cmd_inputstr, cmd_output, cmd_pause, cmd_prompt, HomeExecute, ROM Call 0x45B