The TcxProgressBar component represents a line indicator that is used to show the progress state of any operation.

The current position of the progress bar is specified by the Position property. The Properties.Min and Properties.Max properties let you specify a range of values that the progress bar can display. To adjust the progress bar's appearance, use the Properties.BarStyle, Properties.BeginColor and Properties.EndColor properties.

The component has two special features: Overload Bar and Peak Mark.

Overload Bar is a bar area that can have separate color settings. It is drawn on the main progress bar area from the position specified by the Properties.OverloadValue property. With the overload bar you can have two progress bars on a single component. For example you can use the overload bar to make the progress bar more colorful (up to 4 colors in the gradient fill) or to indicate a progress of the operation that consists of a pair of consecutive processes. See Properties.ShowOverload, Properties.OverloadValue, Properties.OverloadBeginColor and Properties.OverloadEndColor for details.

Peak Mark is a mark that indicates a position value that is important for the represented operation. For instance, this can be a peak level, a critical point or a recommended value. See Properties.ShowPeak, Properties.PeakValue, Properties.PeakColor and Properties.PeakSize for details.

The TcxProgressBar component also raises a number of events that you can process in your scripts.

TcxProgressBar Properties

TcxProgressBar Properties

Name	Description
`Align`	Specifies how the component is aligned within its parent.
`Anchors`	Specifies how the component is anchored to its parent.
`AutoSize`	Specifies whether the component is automatically resized to display its entire contents.
`ChildControl`	Returns the child component by index.
`ChildControlByName`	Returns the child component by name.
`ChildControlCount`	Returns the total number of child components for the given component.
`ClientHeight`	Returns the height of the component’s client area.
`ClientWidth`	Returns the width of the component’s client area.
`Constraints`	Specifies the component’s size constraints.
`Cursor`	Specifies the cursor’s image when it is situated over the component.
`Enabled`	Specifies whether the component is enabled.
`Height`	Specifies the component’s height.
`Hint`	Specifies the text displayed when the cursor stays over the component.
`Left`	Specifies the horizontal coordinate of the component’s left edge.
`Name`	Specifies the component’s name.
`ParentColor`	Specifies whether the component uses the same background color as its parent.
`ParentFont`	Specifies whether the component uses the same font as its parent.
`ParentShowHint`	Specifies whether the component uses the parent’s `ShowHint` property value instead of its own one.
`Position`	Specifies the current progress state.
`Properties`	Returns a `TcxProgressBarProperties` object that holds specific properties of a progress bar.
`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 component properties.
`PropertyName`	Returns the property name by index.
`ShowHint`	Specifies whether to display the component’s hint.
`Style`	Specifies the style of the component.
`TabOrder`	Specifies the component’s tab index.
`TabStop`	Specifies whether the component can be selected by the `Tab` key.
`Top`	Specifies the vertical coordinate of the component’s top edge.
`Transparent`	Specifies whether the component’s background is transparent.
`Visible`	Specifies whether the component is visible on screen.
`Width`	Specifies the component’s width.

TcxProgressBar Methods

TcxProgressBar Events

Name	Description
`PropertyExists`	Checks to see if the component has the property with the specified name.
`SetFocus`	Moves the input focus to the component.

Name	Description
`OnFocusChanged`	Occurs when the component receives or loses the input focus.
`OnEnter`	Occurs when the component receives the input focus.
`OnExit`	Occurs when the component loses the input focus.
`OnMouseEnter`	Occurs when the mouse pointer enters the component.
`OnMouseLeave`	Occurs when the mouse pointer leaves the component.

TcxProgressBar Object

See Also