Export (0) Print
Expand All
Expand Minimize

CTaskDialog::SetProgressBarMarquee

Configures a marquee bar for the CTaskDialog and adds it to the dialog box.

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

[in] bEnabled

TRUE to enable the marquee bar; FALSE to disable the marquee bar and remove it from the CTaskDialog.

[in] nMarqueeSpeed

An integer that indicates the speed of the marquee bar.

The marquee bar appears underneath the main text of the CTaskDialog Class.

Use nMarqueeSpeed to set the speed of the marquee bar; larger values indicate a slower speed. A value of 0 for nMarqueeSpeed makes the marquee bar move at the default speed for Windows Vista.

This method throws an exception with the ENSURE (MFC) macro if nMarqueeSpeed is less than 0.

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

Header: afxtaskdialog.h

Show:
© 2014 Microsoft