Texas Instruments TI-89 - Winremove

1188
Appendix A: System Routines — Windows
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
WinRemove
Declaration:
void
WinRemove
(WINDOW *
w
, BOOL
UpdateScreen
)
Category(ies):
Windows
Description:
Close a window, releasing any memory assigned to it.
Inputs:
w
— WINDOW struct of a previously opened window.
UpdateScreen
— If TRUE then the next window in the linked list of
windows is activated and the screen is updated. If
FALSE then no other window is activated and the
screen is not updated.
Outputs:
None
Assumptions:
All windows opened with
WinOpen
must be closed with either
WinClose
or
WinRemove
.
Side Effects:
None if
UpdateScreen
is FALSE, otherwise the same as
WinClose
.
Availability:
On AMS 2.00 and higher.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: WinOpen, WinClose
Example:
/* virtual windows are normally closed with WinRemove as shown in this example */
if (WinOpen(&VirtW, MakeWinRect(0,0,COL_MAX,ROW_MAX),WF_VIRTUAL | WF_NOBORDER)) {
/* . . . use VirtW . . . */
WinRemove( &VirtW, FALSE ); /* no screen update */
}