Dialog Boxes; Dialog Routines - Texas Instruments TI-89 Developer's Manual

108
PopupText
QMenuTopSelect
11.4.

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.
11.4.1.

Dialog Routines

Dialog
DialogAdd
DialogDo
DialogNew
DlgMessage
DlgNotice
DrawStaticButton — Utility routine to draw dialog box style buttons at the
VarNew
VarOpen
VarSaveAs
TI-89 / TI-92 Plus Developer Guide
Chapter 11: Creating the User Interface
— Return a pointer to the text of a dynamically created
pop-up.
— Return the currently selected top-level menu item as
set by MenuTopSelect.
— Open a dialog box and handle all keys pressed by the
user until the dialog box is closed, returning any
modified dialog box items.
— Add an item to a dynamic dialog box.
— Works like Dialog only for dynamically created dialog
boxes.
— There are several utility routines for working with and
creating standard dialog boxes.
— Execute a system created dialog with a title and a
word-wrapped message.
— Macro: DlgMessage (Title, Msg, PDB_OK, 0).
bottom of a window.
— Create a standard NEW dialog box.
— Create a standard OPEN dialog box.
— Create a standard SAVE COPY OF dialog box.
Not for Distribution Beta Version January 26, 2001