Freigeben über


CTaskDialog::SetExpansionArea

Aktualisiert den Erweiterungsbereich CTaskDialog.

void SetExpansionArea(
   const CString& strExpandedInformation,
   const CString& strCollapsedLabel = _T(""),
   const CString& strExpandedLabel = _T("")
);

Parameter

  • [in] strExpandedInformation
    Die Zeichenfolge, die CTaskDialog im Hauptteil des Dialogfelds angezeigt werden, wenn der Benutzer auf die Erweiterungsschaltfläche klickt.

  • [in] strCollapsedLabel
    Die Zeichenfolge, die CTaskDialog neben der Erweiterungsschaltfläche angezeigt wird, wenn der erweiterte Bereich reduziert wird.

  • [in] strExpandedLabel
    Die Zeichenfolge, die CTaskDialog neben der Erweiterungsschaltfläche angezeigt wird, wenn der erweiterte Bereich angezeigt wird.

Hinweise

Der Erweiterungsbereich CTaskDialog-Klasse ermöglicht es Ihnen, dem Benutzer zusätzliche Informationen bereitzustellen.Der Erweiterungsbereich ist im Hauptteil CTaskDialog, sucht direkt unter der Name und die Inhaltszeichenfolge.

Wenn CTaskDialog zuerst angezeigt wird, wird es nicht der erweiterten Informationen an und setzt strCollapsedLabel neben der Erweiterungsschaltfläche.Wenn der Benutzer auf die Erweiterungsschaltfläche klickt, zeigt CTaskDialogstrExpandedInformation an und ändert die Bezeichnung zu strExpandedLabel.

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

// Setting new information to be able to reuse the dialog resource
taskDialog.SetWindowTitle(L"New title for the task dialog");
taskDialog.SetContent(L"New message to show the user.");
taskDialog.SetMainInstruction(L"Even more important!");
taskDialog.SetMainIcon(TD_ERROR_ICON);
taskDialog.SetDialogWidth(300);

// Add a footer
taskDialog.SetFooterText(L"Footer information for the dialog.");
taskDialog.SetFooterIcon(TD_INFORMATION_ICON);

// Add expansion information
taskDialog.SetExpansionArea(L"Additional information\non two lines.",
    L"Click here for more information.",
    L"Click here to hide the extra information.");

// Change the options to show the expanded information by default.
// It is necessary to retrieve the current options first.
int options = taskDialog.GetOptions();
options |= TDF_EXPANDED_BY_DEFAULT;
taskDialog.SetOptions(options);

taskDialog.DoModal();

Anforderungen

Header: afxtaskdialog.h

Siehe auch

Referenz

CTaskDialog-Klasse

Hierarchien-Diagramm

CTaskDialog::CTaskDialog