[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'Dialogs' (#lcl)

# TTaskDialogProgressBar.Position

Contains the current position for the progress bar.

## Declaration

Source position: dialogs.pp line 716

`published property TTaskDialogProgressBar.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.

## Version info

Added in LCL version 4.0.

## See also

TTaskDialogProgressBar.Max |  | Upper limit for the Position on the progress bar.
TTaskDialogProgressBar.Min |  | Lower limit for the Position on the progress bar.
TCustomTaskDialog.Flags |  | Set of options enabled for the Task dialog.
TTaskDialogFlags |  | Set type used to store values from the TTaskDialogFlag enumeration.
TTaskDialogFlag |  | Represents options that can be enabled for TTaskDialog.