IASProgressBar::put_RangeColor

This method sets the color assigned to a range.

Syntax

HRESULT put_RangeColor( long lRangeIndex OLE_COLOR clr );

Parameters

lRangeIndex
Long integer that indicates the index of the desired range.
clr
Range color.

Return Values

NOERROR indicates success. E_INVALIDARG indicates that an invalid argument has been entered.

Remarks

Progress bars can be broken into two or more ranges, each of a different color. For example, if a progress bar can take a value between 0 and 10 and is divided into three ranges: red, green, and blue, then the RangeCount property is 3, and the related properties are listed in the following table.

Index
Color
RangeValue
Range
0 Red 0 0 - 3
1 Green 4 4 - 7
2 Blue 8 8-10

Use the RGB macro to set the components of clr before passing clr to the method.

See Also

IASProgressBar, IASProgressBar::get_RangeColor, IASProgressBar::get_RangeValue, RGB