The purpose of this widget is to reassure the user that something is happening. It can operate in one of two modes:
determinate mode, the widget shows an
indicator that moves from beginning to end under program
indeterminate mode, the widget is animated
so the user will believe that something is in progress.
In this mode, the indicator bounces back and forth between
the ends of the widget.
In either mode, the current position of the indicator has a
numeric value. You can specify a
and you can set the indicator value directly. You may also
specify that the indicator value moves a given amount every time
a given time interval passes.
To create a new ttk
.Progressbar widget as
the child of a given
The options for this constructor are given in Table 54, “ttk
Table 54. ttk
|The widget class name. This may be specified when the widget is created, but cannot be changed later. For an explanation of widget classes, see Section 27, “Standardizing appearance”.
|The cursor that will appear when the mouse is over the checkbutton; see Section 5.8, “Cursors”.
|The size of the widget along its long axis as a dimension.
|The maximum value of the indicator; default is 100.
If your program cannot accurately depict the relative
progress that this widget is supposed to display, use
If your program has some measure of relative progress,
This options specifies the orientation: use
|The style to be used in rendering this widget; see Section 49, “Using and customizing ttk styles”.
By default, a ttk
not be included in focus traversal; see Section 53, “Focus: routing keyboard input”. To add the widget to focus
|Use this option to link a control variable to the widget so that you can get or set the current value of the indicator.
Methods on a ttk
those described in Section 46, “Methods common to all ttk widgets” plus:
Start moving the indicator every
milliseconds; the default
is 50ms. Each time, the indicator is moved as if you
This method increases the indicator value by
; the default
increment is 1.0. In determinate mode, the indicator will
never exceed the value of the
option. In indeterminate mode, the indicator will reverse
direction and count down once it reaches the maximum
This method stops the automatic progress that was started
by calling the