CTaskDialog::SetProgressBarMarquee

Artikel
02/26/2013

Konfiguriert eine Laufschriftleiste für CTaskDialog und fügt sie dem Dialogfeld hinzu.

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

Parameter

[in] bEnabled
TRUE, um die Laufschriftleiste zu ermöglichen, FALSE, um die Laufschriftleiste zu deaktivieren und von CTaskDialog zu entfernen.
[in] nMarqueeSpeed
Eine ganze Zahl, die die Geschwindigkeit der Laufschriftleiste angibt.

Hinweise

Die Laufschriftleiste wird unter der Text CTaskDialog-Klasse.

Verwenden Sie nMarqueeSpeed, um die Geschwindigkeit der Laufschriftleiste festzulegen, größere Werte geben ein langsamer an.Der Wert 0 für nMarqueeSpeed stellt die Laufschrift erstellt, Verschiebung mit der standardmäßigen Geschwindigkeit für Windows Vista abzuhalten.

Diese Methode löst eine Ausnahme mit dem STELLEN SEH SICHER (MFC)-Makro aus, wenn nMarqueeSpeed kleiner als 0 ist.

Beispiel

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