TcxCustomProgressBar Class
Serves as the base for progress bar controls.
Declaration
TcxCustomProgressBar = class(
TcxCustomEdit
)Remarks
The TcxCustomProgressBar class is the ancestor of the TcxProgressBar, representing a progress bar control. It implements all the functionality needed by its descendant. The TcxProgressBar class simply publishes certain properties.
The primary features implemented by the TcxCustomProgressBar class are listed below:
Vertical orientation support (Properties.Orientation and Properties.TextOrientation);
Multiple fill styles support – solid, gradient, rectangles, bitmaps (Properties.BarStyle and Properties.ForegroundImage);
Marquee progress bar support – the bar can be animated to show activity instead of overall progress (Properties.Marquee, Properties.AnimationPath, Properties.AnimationRestartDelay, and Properties.AnimationSpeed);
Windows® Vista paint style support – the bar showing the completion progress is accentuated using an animated highlight (Properties.BarStyle, Properties.AnimationPath, Properties.AnimationRestartDelay, and Properties.AnimationSpeed);
Windows® 7 taskbar progress visualization support – the bar showing the completion or marquee progress is displayed in an application’s taskbar button via the TdxTaskbarProgress component linked to a progress bar control;
Overload bar support – the bar can be divided into two parts with different styles (Properties.ShowOverload);
Peak value support – the progress bar is capable of displaying a peak value (Properties.ShowPeak);
Three text label styles support – the progress bar can display its current position, a percentage, or arbitrary text (Properties.ShowTextStyle);
Windows® theme and skin support (Style.LookAndFeel.NativeStyle and Style.LookAndFeel.SkinName).
The images below show possible appearances of the progress bar control derived from the TcxCustomProgressBar class.
Do not create instances of the TcxCustomProgressBar class in your applications. If you need a progress bar, use the TcxProgressBar control. The TcxCustomProgressBar class should be used to derive other progress bar controls.