ProgressBar

Wire name progress

A bar showing how far along something is, or that it is merely busy.

p=new progress minimum=0 maximum=100 value=40

---

Properties

Property	Type	Default	Meaning
caption	string	—	Optional overlay text.
indeterminate	flag	false	Show indeterminate busy animation.
maximum	int	—	Maximum value.
minimum	int	—	Minimum value.
value	int	—	Current progress value.

Plus the common properties.

The defaults are minimum=0, maximum=100, value=0.

Events

progress emits no events.

A progress bar reports nothing. It is driven by the application setting value, and shows what it is told.

Value is clamped to the range

A value outside minimum…maximum is clamped rather than refused, and the clamp is re-applied when the range changes:

new progress minimum=0 maximum=10 value=99
  ->  value = 10

new progress value=50 minimum=0 maximum=10
  ->  value = 10

The second line sets value before the range that bounds it, and still ends at 10 — setting maximum re-clamps what is already there. Unlike ListView's selected, the order does not change the outcome.

Indeterminate

indeterminate replaces the filled bar with a busy animation, for work whose extent is not known. value, minimum and maximum are ignored while it is set.

Caption

caption is an overlay format, not a static label — it is the text drawn over the bar, and may contain the format placeholders the bar substitutes. Leave it unset for the default.

Behavior

A progress bar takes no focus and is skipped by Tab.

Give it an acc_name where the surrounding text does not say what is progressing; the bar reports its value, not its purpose.

See also

Label · StatusBar · Common Properties