CTaskDialog::SetProgressBarRange
プログレス バーの範囲を調整します。
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();
必要条件
ヘッダー: afxtaskdialog.h
参照
関連項目
CTaskDialog::SetProgressBarPosition