Condividi tramite


CTaskDialog::SetExpansionArea

Aggiorna l'area di espansione CTaskDialog.

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

Parametri

  • [in] strExpandedInformation
    La stringa che CTaskDialog visualizzata nella parte principale della finestra di dialogo quando l'utente fa clic sul pulsante di espansione.

  • [in] strCollapsedLabel
    La stringa che CTaskDialog visualizzata accanto al pulsante di espansione quando l'area viene compressa espansa.

  • [in] strExpandedLabel
    La stringa che CTaskDialog visualizzata accanto al pulsante di espansione nell'area espansa visualizzare.

Note

L'area di espansione Classe CTaskDialog consente di fornire informazioni aggiuntive all'utente.L'area di espansione nella parte principale CTaskDialog, trova immediatamente sotto la stringa del contenuto e titolo.

Quando CTaskDialog innanzitutto visualizzare, non sono disponibili informazioni espanse e non inserisce strCollapsedLabel accanto al pulsante di espansione.Quando l'utente fa clic sul pulsante di espansione, CTaskDialog visualizzare strExpandedInformation e modificano l'etichetta a strExpandedLabel.

Esempio

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

Requisiti

intestazione: afxtaskdialog.h

Vedere anche

Riferimenti

Classe CTaskDialog

Grafico della gerarchia

CTaskDialog::CTaskDialog