## NAME

progressbar -
Provide progress feedback

## SYNOPSIS

    ttk::progressbar pathName ?options?

## STANDARD OPTIONS

## OPTIONS

Name | Database name | Database class
--- | --- | ---
-orient | orient | Orient
| One of horizontal or vertical. Specifies the orientation of the progress bar.
-length | length | Length
| Specifies the length of the long axis of the progress bar (width if horizontal, height if vertical).
-mode | mode | Mode
| One of determinate or indeterminate.
-maximum | maximum | Maximum
| A floating point number specifying the maximum -value. Defaults to 100.
-value | value | Value
| The current value of the progress bar. In determinate mode, this represents the amount of work completed. In indeterminate mode, it is interpreted modulo -maximum; that is, the progress bar completes one "cycle" when the -value increases by -maximum.
-variable | variable | Variable
| The name of a Tcl variable which is linked to the -value. If specified, the -value of the progress bar is automatically set to the value of the variable whenever the latter is modified.
-phase | phase | Phase
| Read-only option. The widget periodically increments the value of this option whenever the -value is greater than 0 and, in determinate mode, less than -maximum. This option may be used by the current theme to provide additional animation effects.

## DESCRIPTION

A progress bar widget shows the status of a long-running operation. They can operate in two modes: determinate mode shows the amount completed relative to the total amount of work to be done, and indeterminate mode provides an animated display to let the user know that something is happening.

## WIDGET COMMAND

pathName cget option
  Returns the current value of the specified option; see widget(n).
pathName configure ?option? ?value option value ...?
  Modify or query widget options; see widget(n).
pathName instate statespec ?script?
  Test the widget state; see widget(n).
pathName state ?stateSpec?
  Modify or query the widget state; see widget(n).
pathName step ?amount?
  Increments the -value by amount. amount defaults to 1.0 if omitted.

## UTILITY PROCEDURES

    tile::progressbar::start pb
    tile::progressbar::stop pb

These two procedures are used for progressbars that update "on their own" without further programmatic intervention. tile::progressbar::start configures a progress bar to use indeterminate mode and sets up a recurring timer event that periodically steps the progress bar. tile::progressbar::stop cancels any active timer callback for the progress bar and sets the -value to 0.

## SEE ALSO

widget(n)