audio_form object
This method will pause an active speech timer of a progress bar.
bool pause_progress_timer(int control_id)
Parameters:
control_id
The control ID of the progress bar you wish to pause.
Return value:
true on success, false otherwise.
Remarks:
This function must be called once you have finished using the progress bar.
Example:

    // Make a simple form with a few buttons and a dummy progress bar.

    #include "form.bgt"

    audio_form form;
    int dummy_counter;

    void main()
    {
    dummy_counter=0;
    form.create_window("Example Form", true);
    int dummy=form.create_progress_bar("&Copying", 5, false);
    int ok=form.create_button("OK");
    int cancel=form.create_button("E&xit");
    form.activate_progress_timer(dummy);
    while(true)
    {
    form.monitor();
    wait(5);
    dummy_counter++;
    if(dummy_counter>=250)
    {
    if(form.get_progress(dummy)>=100)
    {
    form.pause_progress_timer(dummy);
    }
    else
    {
    form.set_progress(dummy, form.get_progress(dummy)+1);
    }
    dummy_counter=0;
    }
    if(form.is_pressed(ok))
    {
    exit();
    }
    if(form.is_pressed(cancel))
    {
    exit();
    }
    if((key_down(KEY_LMENU))&&(key_pressed(KEY_F4)))
    {
    exit();
    }
    }
    }