CTaskDialog::ShowDialog

Article
06/10/2015

Crée et affiche CTaskDialog.

static INT_PTR ShowDialog(
   const CString& strContent,
   const CString& strMainInstruction,
   const CString& strTitle,
   int nIDCommandControlsFirst,
   int nIDCommandControlsLast,
   int nCommonButtons = TDCBF_YES_BUTTON | TDCBF_NO_BUTTON,
   int nTaskDialogOptions = TDF_ENABLE_HYPERLINKS | TDF_USE_COMMAND_LINKS,
   const CString& strFooter = _T("")
);

Paramètres

[in] strContent
La chaîne à utiliser pour le contenu d' CTaskDialog.
[in] strMainInstruction
l'instruction principale d' CTaskDialog.
[in] strTitle
Titre de la CTaskDialog.
[in] nIDCommandControlsFirst
L'ID de chaîne de la première commande.
[in] nIDCommandControlsLast
L'ID de chaîne de la dernière commande.
[in] nCommonButtons
Un masque des boutons à ajouter à CTaskDialog.
[in] nTaskDialogOptions
L'ensemble d'options à utiliser pour CTaskDialog.
[in] strFooter
La chaîne à utiliser comme pied de page.

Valeur de retour

Un entier qui correspond à la sélection a effectué par l'utilisateur.

Notes

Cette méthode statique vous permet de créer une instance de CTaskDialog, classe sans créer explicitement un objet d' CTaskDialog dans votre code. Étant donné qu'il n'y a aucun objet d' CTaskDialog , vous ne pouvez appeler les méthodes d' CTaskDialog si vous utilisez cette méthode pour afficher CTaskDialog à l'utilisateur.

Cette méthode crée des contrôles de bouton de commande à l'aide de les données du fichier de ressources de votre application. La table de chaînes dans le fichier de ressources a plusieurs chaînes avec les ID associés de chaîne. Cette méthode ajoute un contrôle bouton de commande pour chaque entrée valide dans la table de chaînes entre nIDCommandControlsFirst et nCommandControlsLast, inclus. Pour ces contrôles bouton de commande, la chaîne dans la table de chaînes est la légende du contrôle et l'ID de chaîne est l'ID du contrôle

Consultez CTaskDialog::SetOptions pour une liste d'options valides.

CTaskDialog se referme lorsque l'utilisateur sélectionne un bouton), un contrôle de liaison de commande, ou ferme CTaskDialog. La valeur de retour est l'identificateur qui indique comment l'utilisateur a fermé la boîte de dialogue.

Exemple

    // TODO: Replace the string below with the actual message to the user
    CString message("Important information to the user");
    // TODO: Replace the string below with the title of this project
    CString title("Project Title");

    CString emptyString;

    if (CTaskDialog::IsSupported())
    {
        CTaskDialog::ShowDialog(message, emptyString, title, 0, 0, 
            TDCBF_OK_BUTTON);
    }
    else
    {
        AfxMessageBox(message);
    }