CTaskDialog::SetProgressBarMarquee

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

CTaskDialog のマーキーバーを構成し、それをダイアログボックスに追加します。

void SetProgressBarMarquee(
   BOOL bEnabled = TRUE,
   int nMarqueeSpeed = 0
);

パラメーター

[入力] bEnabled
マーキーバーを有効にするには TRUE、マーキーバーを無効にして CTaskDialog から削除するには FALSE。
[入力] nMarqueeSpeed
マーキーバーの速度を示す整数。

解説

マーキーバーは、CTaskDialog クラスのメインテキストの下に表示されます。

nMarqueeSpeed を使用して、マーキーバーの速度を設定します。値が大きいほど、より遅い速度を表します。 nMarqueeSpeed の値が 0 の場合は、マーキーバーが Windows Vista の既定の速度で移動します。

このメソッドは、nMarqueeSpeed が 0 未満の場合、ENSURE (MFC) マクロによって例外をスローします。

使用例

// 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();