TcxCustomProgressBarProperties.EndColor Property

Specifies the ending color of the gradient if gradient filling is used.

Declaration

property EndColor: TColor read; write; default clWhite;

Property Value

Type	Default
TColor	clWhite

Remarks

The progress bar is filled using a gradient only when the BarStyle property is set either to cxbsGradient or cxbsGradientLEDs. In such an instance, the BeginColor and EndColor properties specify the starting and ending colors of the gradient respectively. If these two properties are set to the same value, the progress bar has a solid fill. The progress bar is also solid when the BarStyle property value is cxbsSolid or cxbsLEDs. The color of the bar is specified by the BeginColor property.

Note that you can display an overload bar within the progress bar control. Set the ShowOverload property to True for this purpose. The overload bar is displayed in the range specified by the OverloadValue and Position properties. Its style can be customized using the OverloadBeginColor and OverloadEndColor properties. The image below shows the relationship between the relevant properties.

The table below illustrates various values of the EndColor property. It assumes that the BarStyle property value is cxbsGradient, the BeginColor property is set to clNavy and the overload bar is disabled.

Value	Sample
clWhite
clFuchsia
clBlue

Note

The EndColor property is ignored when using native painting. In this instance, the progress bar’s color is specified by the currently applied Windows® theme. Use the Style.LookAndFeel.NativeStyle property to specify whether native painting is used.

The default value of the EndColor property is clWhite.