manipulating-the-progress-control.md

description	title	ms.date	helpviewer_keywords	ms.assetid
Learn more about: Manipulating the Progress Control	Manipulating the Progress Control	11/04/2016	CProgressCtrl class [MFC], working with progress controls [MFC], manipulating CProgressCtrl class [MFC], manipulating controlling progress controls [MFC] CProgressCtrl class [MFC], using	9af561d1-980b-4003-a6da-ff79be15bf23

Manipulating the Progress Control

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

• 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 SetStep 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 StepIt 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

1. Use the OffsetPos 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

1. Use the SetPos 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 GetPos.

See also

Using CProgressCtrl
Controls