TdxTaskbarCustomProgress.LinkedComponent Property

Links to a progress bar control to obtain progress parameters for visualization and provide two-way synchronization.

Declaration

property LinkedComponent: TComponent read; write;

Property Value

Type
TComponent

Remarks

Once the controls are linked, they visualize the same progress. That is, the linked control obtains the following attributes from the linked progress bar control and keeps them synchronized unless the LinkedComponent property is unassigned:

• Progress parameters. The control’s Position and Total properties and the linked progress bar control’s Position, Properties.Min, and Properties.Max properties are synchronized so that both controls indicate the same progress. If the linked progress bar is assigned a repository item, the repository item’s Properties.Min and Properties.Max properties will be synchronized instead.

• Progress type (completion or progress). The control’s State property is synchronized with the linked progress bar control’s Properties.Marquee property. Note that the control’s tbpsNoProgress state is not used in synchronization, as it does not correspond to any progress type. The following table shows the interconnections between the values of these properties in linked controls.

Resulting State property values		Properties.Marquee property values
		True	False
State property values	tbpsNoProgress	tbpsNoProgress (no change)	tbpsNoProgress (no change)
	tbpsIndeterminate	tbpsIndeterminate (no change)	tbpsNormal
	tbpsNormal	tbpsIndeterminate	tbpsNormal (no change)
	tbpsError	tbpsIndeterminate	tbpsError (no change)
	tbpsPaused	tbpsIndeterminate	tbpsPaused (no change)

Note

The synchronization is two-way. That is, property value changes in one control will be reflected in the related properties of the linked control.