The TcxProgressBarProperties object is a helper object that contains properties specific to the TcxProgressBar component. To obtain the TcxProgressBarProperties object from scripts, use the TcxProgressBar.Properties property.

The Min and Max properties specify a range of values that the progress bar can represent.

The progress bar appearance is specified by the BarStyle, BeginColor and EndColor properties. The Orientation and TextOrientation properties let you adjust the orientation of the progress bar and the text displayed in it.

To enable the overload bar feature, set the ShowOverload property to True. If this feature is enabled, you can use the OverloadValue, OverloadBeginColor and OverloadEndColor properties to specify the appearance of the overload bar.

To enable the peak mark feature, set the ShowPeak property to True. To specify the peak mark appearance, you can use the PeakValue, PeakColor and PeakSize properties.

With the Marquee property, you can enable the Marquee mode to make the progress bar display the animated progress block indicating activity, not the completion percentage. The BarStyle property also obtains Windows style progress bars that have additional animated highlight elements.

To configure the animation elements' settings, use the AnimationPath, AnimationRestartDelay and AnimationSpeed properties.

To obtain the bar's text, use the Text property.

TcxProgressBarProperties Properties

TcxProgressBarProperties Properties

Name	Description
`AnimationPath`	Specifies the progress bar element's animation path.
`AnimationRestartDelay`	Specifies the delay before the progress bar's animation restarts.
`AnimationSpeed`	Specifies the progress bar's animation speed.
`BarBevelOuter`	Specifies the bevel appearance.
`BarStyle`	Specifies the bar appearance.
`BeginColor`	Specifies the color of the progress bar.
`BorderWidth`	Specifies the distance between the control’s borders and the area where the progress bar is drawn.
`EndColor`	Specifies the second color for the gradient fill of the progress bar.
`ForegroundImage`	Specifies the custom image displayed on a bar’s surface.
`Marquee`	Specifies whether the Marquee mode is enabled.
`Max`	Determines the maximum position represented by the progress bar.
`Min`	Determines the minimum position represented by the progress bar.
`Orientation`	Indicates whether the bar is positioned vertically or horizontally.
`OverloadBeginColor`	Specifies the color of the overload bar.
`OverloadEndColor`	Specifies the second color for the gradient fill of the overload bar.
`OverloadValue`	Determines the position where the overload bar starts.
`PeakColor`	Specifies the color where the peak area is marked.
`PeakSize`	Specifies the width of the peak mark.
`PeakValue`	Specifies the value that indicates the critical or peak position of the progress.
`Property`	Obtains or sets the value of the property specified by its index.
`PropertyByName`	Obtains or sets the value of the property with the specified name.
`PropertyCount`	Returns the number of object properties.
`PropertyName`	Returns the property name by index.
`ShowOverload`	Indicates whether the overload bar is displayed.
`ShowPeak`	Indicates whether the peak mark is displayed.
`ShowText`	Indicates whether the text representation of the progress state is displayed.
`ShowTextStyle`	Determines what information is represented as text: actual position or percentage of completion.
`SolidTextColor`	Specifies whether the text color depends on the background color.
`Text`	Specifies the text displayed in the progress bar.
`TextOrientation`	Indicates whether the text label is positioned vertically or horizontally.
`Transparent`	Specifies whether the component’s background is transparent.
`TransparentImage`	Specifies whether the image background should be treated as transparent.

TcxProgressBarProperties Methods

TcxProgressBarProperties Object

See Also