Skip to main content

TcxCustomProgressBarProperties.OverloadBeginColor Property

Specifies the color of the overload bar.

Declaration

property OverloadBeginColor: TColor read; write; default $008080FF;

Property Value

Type Default
TColor $008080FF

Remarks

If the ShowOverload property value is True, the control displays the overload bar in the range specified by the OverloadValue and Position properties. The overload bar (as well as the rest of the progress bar) can either use solid or gradient filling. If the BarStyle property is set to cxbsSolid or cxbsLEDs, the overload bar is filled with a solid color specified by the OverloadBeginColor property. If the BarStyle property value is either cxbsGradient or cxbsGradientLEDs, the overload bar is filled with the gradient whose starting and ending colors are specified by the OverloadBeginColor and OverloadEndColor properties.

The filling of the rest of the bar is specified by the BeginColor and EndColor properties. The image below shows the relationship between the relevant properties.

The table below shows examples of changing the OverloadBeginColor property value. Assume that the BarStyle property value is cxbsGradient and the OverloadEndColor property is set to clWhite.

Value Sample
clRed
clGreen
clFuchsia

Note

The overload bar cannot be displayed when the control is painted using the native style. Use the Style.LookAndFeel.NativeStyle property to control whether native painting is used.

The default value of the OverloadBeginColor property is $008080FF.

See Also