Texas Instruments TI-89 Developer's Guide

Appendix A: System Routines — Menus
903
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
PopupClear
Declaration:
HANDLE
PopupClear
(HANDLE
pH
)
Category(ies):
Menus
Description:
Clear all entries of a dynamically created pop-up. Return the existing
handle.
Inputs:
pH
— HANDLE created by
PopupNew
.
Outputs:
The existing handle is always returned.
Assumptions:
The memory allocated to the
pH
HANDLE is not released until the next call
to
DynMenuAdd
(or
PopupAddText
).
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: PopupNew, DynMenuAdd, DynMenuChange
Example:
/* In the VarOpen dialog box, when the user selects a new folder the "drop-down"
(pop-up in a dialog box or menu) for the available variables must be repopulated.
Since the dialog box code keeps this handle, a new one cannot be created. So the
old pop-up is cleared and the new variables are added to it
*/
FolderName = (BYTE *) PopupText(hOpenFolder, VarOptList[1]);
PopupClear( hOpenVar ); /* empty pop-up, keep same handle */
AddSymsToOpenPopup( hOpenVar, StrToTokN( FolderName, TokenizedName ) );
return DB_REDRAW; /* changed drop-down, must redraw */

Texas Instruments TI-89 Specifications

General

Display size (HxV)	100 x 160 mm
Memory type	639K FLASH ROM, 188K bytes RAM
Compatible operating systems	Operating System 2.09
Battery type	AAA