This class represents a dialog that shows a short message and a progress
bar. It is typically used to keep a user informed of progress through
some potentially long-running task, whilst disabling interaction with
the application or frame.
It can run in ‘determinate’ mode where the total length of the task is
known; in this case, calls to update are used
to update steps through the task. Alternatively, if the total task
length is unknown, pulse can be used to indicate
some progress. See Wx::Gauge for more information.
Optionally, it can display an ABORT and/or a SKIP button. If an
ABORT is shown, the return value from update
or pulse
can be
tested to see whether the user has chosen to abort the task. If a SKIP
button is used, use the extended methods
update_and_check and
pulse_and_check which return additional
information about whether the skip button has been pressed since the
last update.
Creates the dialog, displays it and disables user input for other
windows, or, if PD_APP_MODAL flag is not given, for its parent window
only.
PD_APP_MODAL | Make the progress dialog modal. If this flag isnot given, it is only “locally” modal – that is the input to the parentwindow is disabled, but not to the other ones. |
PD_AUTO_HIDE | Causes the progress dialog to disappearfrom screen as soon as the maximum value of the progress meter has beenreached. |
PD_SMOOTH | Causes smooth progress of the gauge control. |
PD_CAN_ABORT | This flag tells the dialog that it should have a"Cancel" button which the user may press. |
PD_CAN_SKIP | This flag tells the dialog that it should have a “Skip” button which the user may press. |
PD_ELAPSED_TIME | This flag tells the dialog that it should show elapsed time (since creating the dialog). |
PD_ESTIMATED_TIME | This flag tells the dialog that it should show estimated time. |
PD_REMAINING_TIME | This flag tells the dialog that it should show remaining time. |
Updates the dialog, optionally with a new message, as with
update but makes the gauge control run in
indeterminate mode, sets the remaining and the estimated time labels (if
present) to Unknown and moves the progress bar a bit to indicate that
some progress was made.
Just like pulse but returns a pair of boolean
values. The first of these is false if the dialog was aborted, and true
if it should continue. The second of these will be true if the SKIP
button was pressed, and otherwise false.
Can be used to continue with the dialog after the user had chosen ABORT.
Updates the dialog, setting the progress bar to the new value and, if
given, changes the message above it. Returns true unless the ABORT
button has been pressed.
If false is returned, the application can either immediately destroy the
dialog or ask the user for the confirmation and if the abort is not
confirmed the dialog may be resumed with
resume method.
Just like update but returns a pair of boolean
values. The first of these is false if the dialog was aborted, and true
if it should continue. The second of these will be true if the SKIP
button was pressed, and otherwise false.
[This page automatically generated from the Textile source at 2023-06-13 21:31:34 +0000]