Appendix A: System Routines — Dialog
357
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
ERD_notice
Declaration:
BOOL
ERD_notice
(UCHAR const *
title
, UCHAR const *
msg
)
Category(ies):
Dialog, Error Handling
Description:
Displays text of
msg
in a pop-up window. The window stays on the screen
after returning to the caller.
Use this routine to notify the user that a long-running operation has begun.
Call
ERD_dismissNotice
to remove the pop-up window when the
operation is complete.
Inputs:
title
— Window title.
msg
— Text of message.
Outputs:
Returns TRUE if the pop-up window is displayed. Returns FALSE if the
window could not be opened.
Assumptions:
The text of
msg
is word-wrapped as necessary to fit in the width of the
message box.
Side Effects:
May cause heap compression.
Availability:
On AMS 2.00 and higher.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: ERD_dismissNotice
Example:
BOOL bNotice;
bNotice = ERD_notice((UCHAR *)"WARNING", (UCHAR *)"Database reorganization in
progress -- do not interrupt!");
.
. /* reorganize database */
.
if (bNotice)
ERD_dismissNotice();