966
Appendix A: System Routines — Status Line
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
ST_progressBar
Declaration:
void
ST_progressBar
(ST_PROGRESS_BAR *
pb
, long
low
, long
high
)
Category(ies):
Status Line
Description:
Creates a progress bar indicator in the status line. A bar will be displayed
showing relative progress between values
low
and
high
. A time-consuming
process can create a progress bar, then, through subsequent calls to
ST_progressUpdate
or
ST_progressIncrement
, indicate how much work
the process has accomplished.
Inputs:
low
— Low end of progress. A progress value of
low
displays an empty
progress bar.
high
— High end of progress. A progress value of
high
displays a solid
(filled) progress bar. Progress values between
low
and
high
display a proportionally filled progress bar.
Outputs:
pb
— Progress bar structure. This routine initializes the progress bar
structure and clears the status line indicators.
Assumptions:
None
Side Effects:
None
Availability:
On AMS 2.00 and higher.
TI-89 / TI-92 Plus
Differences:
None
See Also: ST_progressDismiss
,
ST_progressIncrement
,
ST_progressUpdate
Example:
ST_PROGRESS_BAR pb;
.
.
.
ST_progressBar(&pb, 0, 100); /* show progress from 0 to 100 */
for (j = 0; j <= 100; j += 1)
{
.
. /* Do some work */
.
ST_progressUpdate(&pb, j);
}
ST_progressDismiss(&pb);