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

Specifies the image used to fill the progress bar.

#Declaration

Delphi
property ForegroundImage: TBitmap read; write;

#Property Value

Type
TBitmap

#Remarks

The ForegroundImage property specifies the bitmap image used to fill the progress bar. The bitmap is used only when the BarStyle property is set to cxbsBitmap or cxbsBitmapLEDs. When set to cxbsBitmap, the image is displayed as is. If it exceeds the size of the progress bar, it is truncated. If the image is smaller than the progress bar’s client area, it is tiled. The image below displays an example of using a small image to fill the progress bar.

A Bitmap-Filled Progress Bar

When the BarStyle property is set to cxbsBitmapLEDs, the specified image is cut into rectangles. This mode is more likely to be used when you specify an image that fits or exceeds the control’s area (or a texture bitmap). The image below shows an example.

A Blocked Progress Bar Filled with a Bitmap

Note

If the BarStyle property is set either to cxbsBitmap or cxbsBitmapLEDs and the ForegroundImage property is not set, the progress bar displays nothing regardless of the Position property value.

See Also