TcxCustomProgressBarProperties.ForegroundImage Property

Specifies the image used to fill the progress bar.

Declaration

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.

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.

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.