Texas Instruments TI89 Developer Guide - Page 150

108 Chapter 11: Creating the User Interface 11.4. 11.4.1. PopupText QMenuTopSelect - Return a pointer to the text of a dynamically created pop-up. - Return the currently selected top-level menu item as set by MenuTopSelect. Dialog Boxes Dialogs, like menus, can be either static or dynamic. The text strings in a dialog can be localized by using string reference numbers instead of actual text. Internally, dialogs are kept as a DIALOG structure that contain one or more DIALOG_ITEMS structures at the end. Static dialogs are created with the resource compiler and the data structures defining them reside in Flash. The only routine that handles static dialogs is the Dialog function. Dynamic dialogs are created with DialogNew and new fields can be added with DialogAdd. Dynamic dialogs are executed with the DialogDo function. Dialogs use a call-back routine to communicate with the caller as the user interacts with the dialog box. Call-backs are explained later in section 11.4.4. Dialog Call-Backs. Dialog Routines Dialog - Open a dialog box and handle all keys pressed by the user until the dialog box is closed, returning any modified dialog box items. DialogAdd - Add an item to a dynamic dialog box. DialogDo - Works like Dialog only for dynamically created dialog boxes. DialogNew - There are several utility routines for working with and creating standard dialog boxes. DlgMessage - Execute a system created dialog with a title and a word-wrapped message. DlgNotice - Macro: DlgMessage (Title, Msg, PDB_OK, 0). DrawStaticButton - Utility routine to draw dialog box style buttons at the bottom of a window. VarNew - Create a standard NEW dialog box. VarOpen - Create a standard OPEN dialog box. VarSaveAs - Create a standard SAVE COPY OF dialog box. TI-89 / TI-92 Plus Developer Guide Not for Distribution Beta Version January 26, 2001