formZ SDK | 5.0 API Reference | System | User Interface (FUIM) | Progress Bar
Description
Set progress button state and title. The progress button is by default enabled with the "Cancel"
(localized) as the title. button. This function can be used to change the enabled state of the button
or to change its title.
Setting the state to FZ_FUIM_PROG_CANCEL_DISABLED disables the button and ability to cancel the
task. Setting the state to FZ_FUIM_PROG_CANCEL_SELECTED indicates that to progress has been canceled by some
specific action in the task.
Changing the title should be used with caution because the button will still act like a cancel button
(responds to clicks and cancel key shortcuts). An acceptable reason to change the title is to use
the string "Pause" to indicate that a task can be suspended and then resumed. To implement this, the
task should enter a suspended state when fz_fuim_key_cancel indicates that the process has been canceled.
Plugin Prototype
fzrt_error_td fz_fuim_prog_stage_set_cancel(
state, | |
char * | title ) |
Parameters
state [Input, Optional]
new state for the cancel button
title [Input, Optional]
title for progress button (Cancel by default)
Returns
Error codes
Availability
5.0.0.0
See Also
, fz_fuim_prog_stage_get_cancel
Function Set
Defined in