Winhide - Texas Instruments TI-89 Developer's Manual

1174

WinHide

Declaration: void WinHide (WINDOW * w )
Category(ies): Windows
Description: Hide a window (mark it as not-visible so that it is never activated by the
system) and update the screen.
w — WINDOW struct of a previously opened window.
Inputs:
Outputs: None
Assumptions: When a window is activated (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 app's main
window is always visible since that is the only view the user has of the app.
An app 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.
Side Effects: The given window will not be activated by the system but writes to it still go
to the screen (unless it is a virtual window).
Availability: All versions of the TI-89 / TI-92 Plus.
TI-89 / TI-92 Plus
Differences: None
See Also: WinActivate, WinOpen, WinReOpen
Example:
/* The Home screen has two overlapping windows (wHome and wPrgmIO). When it deactivates
the wPrgmIO window it hides that window and activates its main window - wHome. */
WinDeactivate(&wPrgmIO);
WinHide(&wPrgmIO);
WinActivate(&wHome);
TI-89 / TI-92 Plus Developer Guide
Appendix A: System Routines — Windows
Not for Distribution Beta Version January 26, 2001