Popupclear - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Menus

PopupClear

Declaration: HANDLE PopupClear (HANDLE pH )
Category(ies): Menus
Description: Clear all entries of a dynamically created pop-up. Return the existing
handle.
pH — HANDLE created by PopupNew.
Inputs:
Outputs: The existing handle is always returned.
The memory allocated to the pH HANDLE is not released until the next call
Assumptions:
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 );
AddSymsToOpenPopup( hOpenVar, StrToTokN( FolderName, TokenizedName ) );
return DB_REDRAW; /* changed drop-down, must redraw */
TI-89 / TI-92 Plus Developer Guide
/* empty pop-up, keep same handle */
Not for Distribution
903
Beta Version January 26, 2001