注
Microsoft Foundation Classes (MFC) ライブラリは引き続きサポートされています。 ただし、機能の追加やドキュメントの更新は行われません。
進行状況コントロールの現在位置を変更するには、3 つの方法があります (CProgressCtrl)。
位置は、事前設定された増分量で変更できます。
位置は任意の量で変更できます。
位置は特定の値に変更できます。
事前設定された量で位置を変更するには
SetStep メンバー関数を使用して増分量を設定します。 既定では、この値は 10 です。 通常、この値はコントロールの初期設定の 1 つとして設定されます。 ステップ値には負の値を指定できます。
StepIt メンバー関数を使用して位置をインクリメントします。 これにより、コントロール自体が再描画されます。
注
StepItは、位置をラップします。 たとえば、1 ~ 100 の範囲、20 のステップ、90 の位置を指定すると、StepItは位置を 10 に設定します。
任意の量で位置を変更するには
OffsetPos メンバー関数を使用して位置を変更します。
OffsetPosは負の値を受け入れます。注
OffsetPosは、StepItとは異なり、位置をラップしません。 新しい位置は範囲内に収まるように調整されます。
位置を特定の値に変更するには
- SetPos メンバー関数を使用して、位置を特定の値に設定します。 必要に応じて、新しい位置が範囲内に収まるように調整されます。
通常、プログレス コントロールは出力にのみ使用されます。 新しい値を指定せずに現在位置を取得するには、 GetPos を使用します。