Appendix A: System Routines — Windows
1183
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
WinOpen
Declaration:
BOOL
WinOpen
(WINDOW *
w
, const WIN_RECT *
wRegion
,
WORD
Flags
, . . . )
Category(ies):
Windows
Description:
Open a new window, initializing all fields of the WINDOW structure. Link
this window into the current list of windows as the topmost window.
Inputs:
w
— Address of a WINDOW struct.
wRegion
— Screen coordinates of window’s region.
Flags
— Flags may be set as follow (note that WF_SAVE_SCR and
WF_DUP_SCR are mutually exclusive).
WF_SAVE_SCR
Save the screen region underneath the window (restore
it when the window is closed). Return FALSE if not
enough memory to allocate a save buffer.
WF_DUP_SCR
Keep a duplicate copy of all data written to the window.
Return FALSE if not enough memory to allocate a save
buffer.
WF_TTY
Write characters in TTY mode (translate ‘\n’, ‘\r’ to
newline, ‘\f’ to clear screen, and wrap at end of lines).
WF_TITLE
Pointer to title follows
Flags
as optional argument.
WF_VIRTUAL
Must also set WF_DUP_SCR, no writes to actual LCD
are done only writes to DUP_SCR.
WF_NOBORDER
Do not draw border for window.
WF_ROUNDEDBORDER
Draw a rounded border (like dialog boxes).
Outputs:
TRUE if window successfully opened, FALSE if not enough memory
(WF_DUP_SCR or WF_SAVE_SCR) or
wRegion
contains invalid window
coordinates.
(continued)