Manipulating the Progress Control

OverviewSample

There are three ways to change the current position of a progress control ().

  • The position can be changed by a preset increment amount.

  • The position can be changed by an arbitrary amount.

  • The position can be changed to a specific value.

To change the position by a preset amount

  1. Use the member function to set the increment amount. By default, this value is 10. This value is typically set as one of the initial settings for the control. The step value can be negative.

  2. Use the member function to increment the position. This causes the control to redraw itself.

    Note   StepIt will cause the position to wrap. For example, given a range of 1 – 100, a step of 20, and a position of 90, StepIt will set the position to 10.

To change the position by an arbitrary amount

  • Use the member function to change the position. OffsetPos will accept negative values.

    Note   OffsetPos, unlike StepIt, will not wrap the position. The new position is adjusted to remain within the range.

To change the position to a specific value

  • Use the member function to set the position to a specific value. If necessary, the new position is adjusted to be within the range.

Typically, the progress control is used solely for output. To get the current position without specifying a new value, use .

See Also   Windows Common Controls and MFC Classes