CTaskDialog::SetOptions
Configure les options de CTaskDialog.
void SetOptions(
int nOptionFlag
);
Paramètres
- [in] nOptionFlag
Le jeu de balises à utiliser pour CTaskDialog.
Notes
Cette méthode efface toutes les options actuelles de CTaskDialog. Pour conserver les options actuelles, vous devez les extraire d'abord avec CTaskDialog::GetOptions et les associer avec les options que vous souhaitez définir.
Le tableau suivant répertorie les options valides.
TDF_ENABLE_HYPERLINKS
Active des liens hypertexte dans CTaskDialog.TDF_USE_HICON_MAIN
Configure CTaskDialog pour utiliser HICON pour l'icône principale. L'alternative consiste à utiliser LPCWSTR.TDF_USE_HICON_FOOTER
Configure CTaskDialog pour utiliser HICON pour l'icône de pied de page. L'alternative consiste à utiliser LPCWSTR.TDF_ALLOW_DIALOG_CANCELLATION
Permet à l'utilisateur de fermer CTaskDialog à l'aide de le clavier ou à l'aide de l'icône dans l'angle supérieur droit de la boîte de dialogue, même si le bouton Annuler n'est pas activé. Si cet indicateur n'est pas définie et le bouton Annuler n'est pas activé, l'utilisateur ne peut pas fermer la boîte de dialogue à l'aide de Alt+F4, la touche ESCAPE, ou le bouton Fermer de la barre de titre.TDF_USE_COMMAND_LINKS
Configure CTaskDialog pour utiliser des contrôles de bouton de commande.TDF_USE_COMMAND_LINKS_NO_ICON
Configure CTaskDialog pour utiliser des contrôles de bouton de commande sans afficher une icône en regard de le contrôle. TDF_USE_COMMAND_LINKS se substitue à TDF_USE_COMMAND_LINKS_NO_ICON.TDF_EXPAND_FOOTER_AREA
Indique la zone d'expansion est actuellement développé.TDF_EXPANDED_BY_DEFAULT
Détermine si la zone d'expansion est développée par défaut.TDF_VERIFICATION_FLAG_CHECKED
Indique la case à cocher de vérification est actuellement sélectionné.TDF_SHOW_PROGRESS_BAR
Configure CTaskDialog pour afficher une barre de progression.TDF_SHOW_MARQUEE_PROGRESS_BAR
Configure la barre de progression pour être une barre de progression de la bannière. Si vous activez cette option, vous devez définir TDF_SHOW_PROGRESS_BAR pour que le comportement attendu.TDF_CALLBACK_TIMER
Indique que la plage de rappel d' CTaskDialog est défini à environ 200 millisecondes.TDF_POSITION_RELATIVE_TO_WINDOW
Configure CTaskDialog à centrer par rapport à la fenêtre parente. Si cet indicateur n'est pas activée, CTaskDialog est centré par rapport à le moniteur.TDF_RTL_LAYOUT
Configure CTaskDialog pour une disposition de droite à gauche de lecture.TDF_NO_DEFAULT_RADIO_BUTTON
Indique qu'aucune case d'option est sélectionnée lorsque CTaskDialog s'affiche.TDF_CAN_BE_MINIMIZED
Permet à l'utilisateur de réduire CTaskDialog. Pour prendre en charge cette option, CTaskDialog ne peut pas être modale. MFC ne prend pas en charge cette option car MFC ne prend pas CTaskDialognon modale.
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