CTaskDialog::SetExpansionArea
Met à jour la zone d'expansion d' CTaskDialog.
void SetExpansionArea(
const CString& strExpandedInformation,
const CString& strCollapsedLabel = _T(""),
const CString& strExpandedLabel = _T("")
);
Paramètres
[in] strExpandedInformation
La chaîne qu' CTaskDialog affiche au corps principal de la boîte de dialogue lorsque l'utilisateur clique sur le bouton de développement.[in] strCollapsedLabel
La chaîne qu' CTaskDialog affiche en regard de le bouton de développement lorsque la zone développée est réduite.[in] strExpandedLabel
La chaîne qu' CTaskDialog affiche en regard de le bouton de développement lorsque la zone développée s'affiche.
Notes
La zone d'expansion de De classe CTaskDialog vous permet de fournir des informations supplémentaires à l'utilisateur.La zone d'expansion est à la majeure partie d' CTaskDialog, définie immédiatement sous la chaîne de titre et de contenu.
Lorsque CTaskDialog est d'abord affiché, il n'affiche pas les informations développées et ne met pas strCollapsedLabel en regard de le bouton de développement.Lorsque l'utilisateur clique sur le bouton de développement, CTaskDialog affiche strExpandedInformation et remplace l'étiquette par strExpandedLabel.
Exemple
// 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();
Configuration requise
en-tête : afxtaskdialog.h