Vcl.ComCtrls.TProgressBar.Position

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

property Position: Integer read GetPosition write SetPosition default 0;

C++

__property int Position = {read=GetPosition, write=SetPosition, default=0};

Properties

Type Visibility Source Unit Parent
property published
Vcl.ComCtrls.pas
Vcl.ComCtrls.hpp
Vcl.ComCtrls TProgressBar

Description

Specifies the current position of the progress bar.

You can read Position to determine how far the process tracked by the progress bar has advanced from Min toward Max. Set Position to cause the progress bar to display a position between Min and Max. For example, when the process tracked by the progress bar completes, set Position to Max so that it appears completely filled.

When a progress bar is created, Min and Max represent percentages, where Min is 0 (0% complete) and Max is 100 (100% complete). If these values are not changed, Position is the percentage of the process that has already been completed.

Note: On Windows operation systems with a common controls library (comctl32.dll) lower than version 4.70, the value of Position is treated as a 16-bit number. This means that the maximum value allowed by Position is 65,535.

See Also

Code Examples