ttk_progressbar

NAME

ttk::progressbar — Provide progress feedback

SYNOPSIS

DESCRIPTION

STANDARD OPTIONS

-class, undefined, undefined

-cursor, cursor, Cursor

-style, style, Style

-takefocus, takeFocus, TakeFocus

WIDGET-SPECIFIC OPTIONS

-orient, orient, Orient

-length, length, Length

-mode, mode, Mode

-maximum, maximum, Maximum

-value, value, Value

-variable, variable, Variable

-phase, phase, Phase

WIDGET COMMAND

pathName cget option

pathName configure ?option? ?value option value ...?

pathName identify x y

pathName instate statespec ?script?

pathName start ?interval?

pathName state ?stateSpec?

pathName step ?amount?

pathName stop

SEE ALSO

Name

ttk::progressbar — Provide progress feedback

Synopsis

ttk::progressbar pathName ?options?

Description

A ttk::progressbar 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.

Standard options

-class, undefined, undefined

-cursor, cursor, Cursor

-style, style, Style

-takefocus, takeFocus, TakeFocus

Widget-specific options

Command-Line Name: -orient

Database Name: orient

Database Class: Orient

One of horizontal or vertical. Specifies the orientation of the progress bar.

Command-Line Name: -length

Database Name: length

Database Class: Length

Specifies the length of the long axis of the progress bar (width if horizontal, height if vertical).

Command-Line Name: -mode

Database Name: mode

Database Class: Mode

One of determinate or indeterminate.

Command-Line Name: -maximum

Database Name: maximum

Database Class: Maximum

A floating point number specifying the maximum -value. Defaults to 100.

Command-Line Name: -value

Database Name: value

Database Class: 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.

Command-Line Name: -variable

Database Name: variable

Database Class: Variable

The name of a global 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.

Command-Line Name: -phase

Database Name: phase

Database Class: 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.

Widget command

pathName cget option

Returns the current value of the specified option; see ttk::widget(n).

pathName configure ?option? ?value option value ...?

Modify or query widget options; see ttk::widget(n).

pathName identify x y

Returns the name of the element at position x, y. See ttk::widget(n).

pathName instate statespec ?script?

Test the widget state; see ttk::widget(n).

pathName start ?interval?

Begin autoincrement mode: schedules a recurring timer event that calls step every interval milliseconds. If omitted, interval defaults to 50 milliseconds (20 steps/second).

pathName state ?stateSpec?

Modify or query the widget state; see ttk::widget(n).

pathName step ?amount?

Increments the -value by amount. amount defaults to 1.0 if omitted.

pathName stop

Stop autoincrement mode: cancels any recurring timer event initiated by pathName start.

See also

ttk::widget