Sign in Join
FPDoc Onlineexperiment

TTaskDialogProgressBar.Position property

Member of TTaskDialogProgressBarpublishedIn unit Dialogs

Contains the current position for the progress bar.

Declaration

pascal
property Position: Integer read FPosition write SetPosition default 0;

Description

Position is an Integer property which indicates the current position on the progress bar. Position and Max are used to calculate the completion percentage for the progress bar. The default value for the property is 0 (zero).

The value in Position must be in the range Min..Max inclusive. If Position is set to a value which exceeds the allowed range, it is normalized to the Min or Max value as needed.

Changing the value in the property causes a TDM_SET_PROGRESS_BAR_POS message to be sent using the Handle for the task dialog. This allows the widgetset class to be notified when the progress bar needs to be redrawn. The message is not sent to the dialog if tfShowProgressBar has not been included in its Flags property or the Handle for the dialog has not been assigned.

Use Min to set the lower limit for the value in Position.

Use Max to set the upper limit for the value in Position.

Position, Min, and Max are not used when the task dialog is configured to use the marquee drawing style for its progress bar.

See also

An experiment, built from Lazarus main 2dfa93c66e of 10-22-2026. Not the official Lazarus documentation.