UserGuide

Desktop Progress Bar

From Xojo Documentation

Progress Bars are designed to indicate that some function of your application is progressing (hence the name) towards its goal or to show capacity. A Progress Bar can only be displayed horizontally.

Progress Bar Library Icon

Properties

Maximum

Specifies the maximum value of the Progress Bar.

Value

The current value of the Progress Bar.

Indeterminate Progress Bar

The Indeterminate Progress Bar is a Progress Bar with its maximum property set to 0. On Windows and Linux, an indeterminate progress bar takes the form of a single block that moves back and forth. On Mac, an interdeterminate progress bar pulses slightly. When this progress bar is visible it always shows its indeterminate state. To hide it, set its Visible property to False.

Usage

To update a ProgressBar you will typically use a Timer. The Timer can periodically check the status of a long-running process and then update the state of the ProgressBar. This Timer is called every 500ms and updates the value of the ProgressBar until it reaches the maximum:

CopiedItems = CopiedItems + 1
CopyProgressBar.Value = CopiedItems

See Also

ProgressBar class; UserGuide:Desktop Progress Wheel topic