Appendix C: Macros — Dialog
1289
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
DlgNotice
Declaration:
WORD
DlgNotice
(const char *
Title
, const char *
Message
)
Category(ies):
Dialog
Description:
Issue a dialog with a given
Title
, a word-wrapped
Message
, and a single
OK button. The
Message
string may contain newline constants. The dialog
box will be sized to fit the screen with a predefined width for the TI
-
89 and
the TI
-
92 Plus.
Inputs:
Title
— String pointer for title of dialog box (no title if NULL).
Message
— String pointer message to be word wrapped in dialog
box.
Outputs:
KB_ENTER — User pressed
¸
to close dialog box.
KB_ESC — User pressed
N
to close dialog box.
Assumptions: Access_AMS_Global_Variables
is defined. If there is not enough memory
for the dialog box, a low memory version will be used (no word wrapping);
so this dialog will always succeed.
Side Effects:
May cause the heap to be compressed.
Availability:
All versions of the TI
-
89 / TI
-
92 Plus. However, on AMS 2.04 and higher,
word wrap also occurs on commas and spaces.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: DlgMessage
Example:
DlgNotice("ERROR IN SETUP", "Invalid value" );