TcxCustomProgressBarProperties.BeginColor Property

Specifies the color of the progress bar.

Declaration

property BeginColor: TColor read; write; default clNavy;

Property Value

Type	Default
TColor	clNavy

Remarks

The style of the progress bar is specified by the BarStyle property. If this property is set to cxbsSolid, cxbsLEDs, cxbsAnimation, or cxbsAnimationLEDs, the progress bar’s color is set using the BeginColor property. If the BarStyle property value is either cxbsGradient or cxbsGradientLEDs, the progress bar is filled using a gradient. The starting and ending colors of the gradient are specified by the BeginColor and EndColor properties.

Note that if the ShowOverload property value is True, the control displays the overload bar between the positions specified by the OverloadValue and Position properties. The style of this bar can be customized separately using the OverloadBeginColor and OverloadEndColor properties.

The table below shows how different values for the BeginColor property affect the appearance of the progress bar. It assumes that the EndColor property is set to clWhite and the ShowOverload property value is False.

Value	Sample (BarStyle = cxbsLEDs)	Sample (BarStyle = cxbsGradientLEDs)
clNavy
clRed
clGreen

Note

the BeginColor property is not in effect when using native painting (except for the cxbsAnimation and cxbsAnimationLEDs paint styles). Use the Style.LookAndFeel.NativeStyle property to specify whether native painting is enabled.

The default value of the BeginColor property is clNavy.