CTaskDialog::SetProgressBarRange

[アーティクル]
08/09/2011

プログレスバーの範囲を調整します。

void SetProgressBarRange(
   int nRangeMin,
   int nRangeMax
);

パラメーター

[入力] nRangeMin
プログレスバーの下限。
[入力] nRangeMax
プログレスバーの上限。

解説

プログレスバーの位置は、nRangeMin および nRangeMax に対する相対的な位置です。たとえば、nRangeMin が 50 で nRangeMax が 100 の場合、75 の位置はプログレスバーの中央です。 CTaskDialog::SetProgressBarPosition を使用して、プログレスバーの位置を設定します。

プログレスバーを表示するには、オプション TDF_SHOW_PROGRESS_BAR を有効にし、TDF_SHOW_MARQUEE_PROGRESS_BAR を無効にする必要があります。このメソッドは、自動的に TDF_SHOW_PROGRESS_BAR を設定し、TDF_SHOW_MARQUEE_PROGRESS_BAR をクリアします。 CTaskDialog クラスのこのインスタンスに対してオプションを手動で変更するには、CTaskDialog::SetOptions を使用します。

nRangeMin が nRangeMax 以上である場合、このメソッドは、ENSURE (MFC) マクロによって例外をスローします。また、CTaskDialog が既に表示されていて、マーキープログレスバーが使用されている場合にも、このメソッドは例外をスローします。

使用例

// TODO: Replace the strings below with the appropriate message, 
// main instruction, and dialog title
CString message("This is an important message to the user.");
CString mainInstruction("Important!\nPlease read!");
CString title("Alert Dialog");

CTaskDialog taskDialog(message, mainInstruction, title, 
    TDCBF_YES_BUTTON | TDCBF_NO_BUTTON | TDCBF_CANCEL_BUTTON );

// Add a marquee progress bar.
taskDialog.SetProgressBarMarquee();

taskDialog.DoModal();

// Remove the marquee bar and replace it with a standard progress bar
taskDialog.SetProgressBarMarquee(0);
taskDialog.SetProgressBarRange(0, 100);
taskDialog.SetProgressBarPosition(75);
taskDialog.SetProgressBarState();

taskDialog.DoModal();