Texas Instruments TI-89 - Menupopup

892
Appendix A: System Routines — Menus
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
MenuPopup
Declaration:
WORD
MenuPopup
(const MENU *
Popup
, short
x0
, short
y0
,
short
Offset
)
Category(ies):
Menus
Description:
Execute a static POPUP as defined by the resource compiler, returning
the item selected.
Inputs:
Menu
— Pointer to a MENU structure of a POPUP as defined by
the resource compiler.
x0
,
y0
— Screen coordinates of the upper left corner of the
menu. If
x0
is equal to
L
1 then the pop-up is centered
horizontally, if
y0
is equal to
L
1 then the pop-up is
centered vertically.
Offset
— Menu ID of initially selected item (0 defaults to first
item).
Outputs:
0 — Nothing selected (
N
pressed) or not enough memory
to display pop-up.
1 . . . 0xFFF — Menu ID of item selected.
Assumptions: MenuPopup
is only used for static POPUPs created by the resource
compiler.
Side Effects:
May cause heap compression.
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: PopupDo
(dynamic popups)
Example:
#include "mpopup.h"
WORD select;
if (MID_CORRECT == (select = MenuPopup( &mPopupTest, -1, -1, 3 )))
Disp("CORRECT");
// MPOPUP.R
POPUP mPopupTest, 0, 0
{
"POPUP 1", MID_1
"POPUP 2", MID_2
"SELECT THIS", MID_CORRECT
}