Dialog - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Dialog

Dialog

Declaration: WORD Dialog (DIALOG * Dlg , short x0 , short y0 , char * FieldBuf ,
WORD * OptionList )
Category(ies): Dialog
Description: Open a dialog box and handle all keys pressed by the user until the dialog
box is closed, returning any modified dialog box items in FieldBuf or
OptionList . Dlg points to a DIALOG structure as built by the resource
compiler or dynamically by DialogNew and DialogAdd.
Inputs: Dlg
x0 , y0
FieldBuf
OptionList
Note that both FieldBuf and OptionList are modified by Dialog whether the
user presses ¸to accept the dialog box or N to cancel it. Copies of
either structure are not made. It is left to the caller to use the changes in
these structures if the dialog box is accepted or to toss them if the dialog
box is canceled.
Outputs: KB_ENTER
KB_ESC
DB_MEMFULL — Not enough memory to open the menu for the dialog
Assumptions: If Dlg points to a dynamically created dialog box, the heap block that stores
the DIALOG structure must be locked.
Side Effects: May cause heap compression.
Availability: All versions of the TI-89 / TI-92 Plus.
TI-89 / TI-92 Plus Developer Guide
— Pointer to a DIALOG structure.
— Specifies the upper left corner of the dialog. If x0 is
equal to L1 then the dialog box is centered
horizontally. If y0 is equal to L1 then the dialog box is
centered vertically.
— Points to a buffer for any edit fields in the dialog box
or NULL if there are no edit fields. The indexes into
FieldBuf are specified by each edit field.
— An array of WORDs, with an entry for each pop-up
field. The initial value for each of these fields as well
as the value selected by the user is stored in this
array. The index into OptionList is specified by each
pop-up field.
— User pressed ¸ to close dialog box.
— User pressed N to close dialog box.
box.
(continued)
Not for Distribution
345
Beta Version January 26, 2001