Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxCustomProgressBarProperties.OverloadBeginColor Property

Specifies the color of the overload bar.

#Declaration

Delphi
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