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.TransparentImage Property

Specifies whether to add transparency to the image used to fill the progress bar.

#Declaration

Delphi
property TransparentImage: Boolean read; write; default True;

#Property Value

Type Default
Boolean True

#Remarks

If the BarStyle property is set to cxbsBitmap or cxbsBitmapLEDs, the progress bar is filled with the image specified by the ForegroundImage property. Set the TransparentImage property to True to add transparency to the image. The transparent color is obtained from the left-bottom pixel of the loaded image.

Suppose that the image specified by the ForegroundImage property is the following.

The images below show the appearance of the control when the TransparentImage property is set to False and True respectively (the BarStyle property is set to cxbsBitmap).

Note

The background color of the progress bar is specified by the Style.Color property. This color is displayed behind the transparent color.

The default value of the TransparentImage property is True.

See Also