Procédure pas à pas : ajout d’une classe CTaskDialog à une application

Article
06/16/2023

Cette procédure pas à pas présente la CTaskDialog Class et vous montre comment en ajouter une à votre application.

Il CTaskDialog s’agit d’une boîte de dialogue de tâche qui remplace la boîte de message Windows dans Windows Vista ou une version ultérieure. CTaskDialog améliore la boîte de message d’origine et ajoute des fonctionnalités. La boîte de message Windows est toujours prise en charge dans Visual Studio.

Remarque

Les versions de Windows antérieures à Windows Vista ne prennent pas en charge le CTaskDialog. Si vous voulez présenter un message à un utilisateur qui exécute votre application sur une version antérieure de Windows, vous devez programmer une autre option de boîte de dialogue. Vous pouvez utiliser la méthode statique CTaskDialog::IsSupported pour déterminer au moment de l’exécution si l’ordinateur d’un utilisateur peut afficher un CTaskDialog. De plus, CTaskDialog est disponible uniquement quand votre application est générée avec la bibliothèque Unicode.

CTaskDialog prend en charge plusieurs éléments facultatifs pour collecter et afficher des informations. Par exemple, un CTaskDialog peut afficher des liens de commande, des boutons personnalisés, des icônes personnalisées et un pied de page. Par ailleurs, CTaskDialog intègre plusieurs méthodes qui vous permettent d’interroger l’état de la boîte de dialogue de tâche pour identifier les éléments facultatifs que l’utilisateur a sélectionnés.

Prérequis

Vous devez disposer des éléments suivants pour exécuter cette procédure pas à pas :

Visual Studio 2010 ou version ultérieure
Windows Vista ou version ultérieure

Remplacement d’une boîte de message Windows par un CTaskDialog

La procédure suivante illustre la façon la plus élémentaire d’utiliser CTaskDialog, qui consiste à remplacer la boîte de message Windows. Cet exemple modifie aussi l’icône associée à la boîte de dialogue de tâche. La modification de l’icône fait apparaître la CTaskDialog même chose dans la boîte de message Windows.

Pour remplacer une boîte de message Windows par un CTaskDialog

Utilisez l’Assistant Application MFC pour créer une application MFC avec tous les paramètres par défaut. Consultez la procédure pas à pas : utilisation des nouveaux contrôles Shell MFC pour obtenir des instructions sur l’ouverture de l’Assistant pour votre version de Visual Studio.
Appelez-le MyProject.
Ouvrez le fichier MyProject.cpp dans l’ Explorateur de solutions .
Ajoutez #include "afxtaskdialog.h" après la liste d’includes.
Recherchez la méthode CMyProjectApp::InitInstance. Insérez les lignes de code suivantes avant l’instruction return TRUE; . Ce code crée les chaînes que nous utilisons dans la boîte de message Windows ou dans CTaskDialog.
```
CString message("My message to the user");
CString dialogTitle("My Task Dialog title");
CString emptyString;
```
Ajoutez le code suivant à la suite du code de l’étape 4. Ce code garantit que l’ordinateur de l’utilisateur prend en charge CTaskDialog. Si la boîte de dialogue n’est pas prise en charge, l’application affiche plutôt une boîte de message Windows.
```
if (CTaskDialog::IsSupported())
{

}
else
{
    AfxMessageBox(message);
}
```
Insérez le code suivant entre parenthèses à la suite de l’instruction if de l’étape 5. Ce code crée CTaskDialog.
```
CTaskDialog taskDialog(message, emptyString, dialogTitle, TDCBF_OK_BUTTON);
```
Dans la ligne suivante, ajoutez le code suivant. Ce code définit l’icône d’avertissement.
```
taskDialog.SetMainIcon(TD_WARNING_ICON);
```
Dans la ligne suivante, ajoutez le code suivant. Ce code affiche la boîte de dialogue de tâche.
```
taskDialog.DoModal();
```

Vous pouvez éviter l’étape 7 si vous ne souhaitez CTaskDialog pas afficher la même icône que la boîte de message Windows. Si vous évitez cette étape, l’icône CTaskDialog n’a pas d’icône lorsque l’application l’affiche.

Compilez et exécutez l'application. L’application affiche la boîte de dialogue de tâche après avoir démarré.

Ajout de fonctionnalités au CTaskDialog

La procédure suivante montre comment ajouter des fonctionnalités au CTaskDialog que vous avez créé dans la procédure précédente. L’exemple de code montre comment exécuter des instructions spécifiques en fonction des sélections de l’utilisateur.

Pour ajouter des fonctionnalités au CTaskDialog

Accédez à l’ Affichage des ressources. Si vous ne voyez pas l’affichage des ressources, vous pouvez l’ouvrir dans le menu Affichage.
Développez l’ Affichage des ressources jusqu’à ce que vous puissiez sélectionner le dossier Table de chaînes . Développez-le et double-cliquez sur l’entrée Table de chaînes .
Faites défiler l’écran jusqu’au bas de la table de chaînes et ajoutez une nouvelle entrée. Modifiez l’ID en lui attribuant la valeur TEMP_LINE1. Définissez la légende en lui attribuant la valeur Command Line 1.
Ajoutez une autre nouvelle entrée. Modifiez l’ID en lui attribuant la valeur TEMP_LINE2. Définissez la légende en lui attribuant la valeur Command Line 2.
Revenez à MyProject.cpp.

À la suite de CString emptyString;, ajoutez le code suivant :

CString expandedLabel("Hide extra information");
CString collapsedLabel("Show extra information");
CString expansionInfo("This is the additional information to the user,\nextended over two lines.");

Recherchez l’instruction taskDialog.DoModal() et remplacez cette instruction par le code suivant. Ce code met à jour la boîte de dialogue de tâche et ajoute de nouveaux contrôles :

taskDialog.SetMainInstruction(L"Warning");
taskDialog.SetCommonButtons(
    TDCBF_YES_BUTTON | TDCBF_NO_BUTTON | TDCBF_CANCEL_BUTTON);
taskDialog.LoadCommandControls(TEMP_LINE1, TEMP_LINE2);
taskDialog.SetExpansionArea(
    expansionInfo, collapsedLabel, expandedLabel);
taskDialog.SetFooterText(L"This is a small footnote to the user");
taskDialog.SetVerificationCheckboxText(L"Remember your selection");

Ajoutez la ligne de code suivante qui présente la boîte de dialogue de tâche à l’utilisateur et récupère la sélection de l’utilisateur :
```
INT_PTR result = taskDialog.DoModal();
```

Insérez le code suivant après l’appel à taskDialog.DoModal(). Cette section de code traite l’entrée de l’utilisateur :

if (taskDialog.GetVerificationCheckboxState())
{
    // PROCESS IF the user selects the verification checkbox
}

switch (result)
{
case TEMP_LINE1:
    // PROCESS IF the first command line
    break;
case TEMP_LINE2:
    // PROCESS IF the second command line
    break;
case IDYES:
    // PROCESS IF the user clicks yes
    break;
case IDNO:
    // PROCESS IF the user clicks no
    break;
case IDCANCEL:
    // PROCESS IF the user clicks cancel
    break;
default:
    // This case should not be hit because closing
    // the dialog box results in IDCANCEL
    break;
}

Dans le code de l’étape 9, remplacez les commentaires qui commencent par PROCESS IF le code que vous souhaitez exécuter dans les conditions spécifiées.

Compilez et exécutez l'application. L’application affiche la boîte de dialogue de tâche qui utilise les nouveaux contrôles et des informations supplémentaires.

Affichage d’un CTaskDialog sans créer d’objet CTaskDialog

La procédure suivante montre comment afficher un CTaskDialog sans créer au préalable un objet CTaskDialog . Cet exemple est la suite des procédures précédentes.

Pour afficher un CTaskDialog sans créer d’objet CTaskDialog

Ouvrez le fichier MyProject.cpp s’il n’est pas déjà ouvert.
Accédez à la parenthèse fermante de l’instruction if (CTaskDialog::IsSupported()) .

Insérez le code suivant juste avant la parenthèse fermante de l’instruction if (avant le bloc else ) :

HRESULT result2 = CTaskDialog::ShowDialog(L"My error message",
    L"Error",
    L"New Title",
    TEMP_LINE1,
    TEMP_LINE2);

Compilez et exécutez l'application. L’application affiche deux boîtes de dialogue de tâche. La première boîte de dialogue provient de la procédure To Add Functionality à la procédure CTaskDialog ; la deuxième boîte de dialogue provient de la dernière procédure.

Ces exemples ne montrent pas toutes les options disponibles pour un CTaskDialog, mais doivent vous aider à commencer. Pour obtenir une description complète de la classe, consultez CTaskDialog Class .

Voir aussi

Boîtes de dialogue
CTaskDialog, classe
CTaskDialog ::CTaskDialog

Partager via