Boîte de dialogue Tâche

Cette section contient des informations sur les éléments de programmation utilisés avec une boîte de dialogue de tâche. Une boîte de dialogue de tâche est similaire, bien que beaucoup plus flexible qu’une boîte de message de base.

Vues d'ensemble

Rubrique	Contenu
À propos des boîtes de dialogue de tâche	Décrit les éléments d’une boîte de dialogue de tâche.

Fonctions

Rubrique	Contenu
TaskDialog	Crée, affiche et gère une boîte de dialogue de tâche. La boîte de dialogue de tâche contient le texte et le titre du message définis par l’application, des icônes et toute combinaison de boutons d’envoi prédéfinis. Cette fonction ne prend pas en charge l’inscription d’une fonction de rappel pour recevoir des notifications.
TaskDialogCallbackProc	Fonction définie par l’application utilisée avec la fonction TaskDialogIndirect . Il reçoit des messages de la boîte de dialogue de tâche lorsque différents événements se produisent. Le type PFTASKDIALOGCALLBACK définit un pointeur vers cette fonction de rappel. TaskDialogCallbackProc est un espace réservé pour le nom de fonction défini par l’application.
TaskDialogIndirect	Crée, affiche et gère une boîte de dialogue de tâche. La boîte de dialogue de tâche contient des icônes définies par l’application, des messages, un titre, une zone de case activée de vérification, des liens de commande, des boutons pousseurs et des cases d’option. Cette fonction peut inscrire une fonction de rappel pour recevoir des messages de notification.

Messages

Rubrique	Contenu
TDM_CLICK_BUTTON	Simule l’action d’un clic de bouton dans une boîte de dialogue de tâche.
TDM_CLICK_RADIO_BUTTON	Simule l’action d’un clic de case d’option dans une boîte de dialogue de tâche.
TDM_CLICK_VERIFICATION	Simule l’action d’une case à cocher de vérification dans une boîte de dialogue de tâche.
TDM_ENABLE_BUTTON	Active ou désactive un bouton d’envoi dans une boîte de dialogue de tâche.
TDM_ENABLE_RADIO_BUTTON	Active ou désactive une case d’option dans une boîte de dialogue de tâche.
TDM_NAVIGATE_PAGE	Recrée une boîte de dialogue de tâche avec de nouveaux contenus, en simulant les fonctionnalités d’un Assistant multipage.
TDM_SET_BUTTON_ELEVATION_REQUIRED_STATE	Spécifie si un bouton de boîte de dialogue de tâche donné ou un lien de commande doit avoir une icône de bouclier de contrôle de compte d’utilisateur (UAC) ; autrement dit, si l’action appelée par le bouton nécessite une élévation.
TDM_SET_ELEMENT_TEXT	Mises à jour un élément de texte dans une boîte de dialogue de tâche.
TDM_SET_MARQUEE_PROGRESS_BAR	Indique si la barre de progression hébergée doit être affichée en mode chapiteau.
TDM_SET_PROGRESS_BAR_MARQUEE	Démarre et arrête l’affichage du chapiteau de la barre de progression, puis définit la vitesse du chapiteau.
TDM_SET_PROGRESS_BAR_POS	Définit la position actuelle d’une barre de progression.
TDM_SET_PROGRESS_BAR_RANGE	Définit les valeurs minimales et maximales pour la barre de progression hébergée.
TDM_SET_PROGRESS_BAR_STATE	Définit l’état actuel de la barre de progression.
TDM_UPDATE_ELEMENT_TEXT	Mises à jour un élément de texte dans une boîte de dialogue de tâche.
TDM_UPDATE_ICON	Actualise l’icône d’une boîte de dialogue de tâche.

Notifications

Rubrique	Contenu
TDN_BUTTON_CLICKED	Envoyé par une boîte de dialogue de tâche lorsque l’utilisateur sélectionne un bouton ou un lien de commande dans la boîte de dialogue de tâche. Ce code de notification est reçu uniquement par le biais de la fonction de rappel de la boîte de dialogue de tâche, qui peut être inscrite à l’aide de la méthode TaskDialogIndirect .
TDN_CREATED	Envoyé par une boîte de dialogue de tâche après la création de la boîte de dialogue de tâche et avant son affichage. Ce code de notification est reçu uniquement par le biais de la fonction de rappel de la boîte de dialogue de tâche, qui peut être inscrite à l’aide de la méthode TaskDialogIndirect .
TDN_DESTROYED	Envoyé par une boîte de dialogue de tâche lorsqu’elle est détruite et que son handle de fenêtre n’est plus valide. Ce code de notification est reçu uniquement par le biais de la fonction de rappel de la boîte de dialogue de tâche, qui peut être inscrite à l’aide de la méthode TaskDialogIndirect .
TDN_DIALOG_CONSTRUCTED	Envoyé par une boîte de dialogue de tâche après la création de la boîte de dialogue de tâche et avant son affichage. Ce code de notification est reçu uniquement par le biais de la fonction de rappel de la boîte de dialogue de tâche, qui peut être inscrite à l’aide de la méthode TaskDialogIndirect .
TDN_EXPANDO_BUTTON_CLICKED	Envoyé par une boîte de dialogue de tâche lorsque l’utilisateur clique sur le bouton expando de la boîte de dialogue de tâche. Ce code de notification est reçu uniquement par le biais de la fonction de rappel de la boîte de dialogue de tâche, qui peut être inscrite à l’aide de la méthode TaskDialogIndirect .
TDN_HELP	Envoyé par une boîte de dialogue de tâche lorsque l’utilisateur appuie sur F1 sur le clavier alors que la boîte de dialogue de tâche a le focus. Ce code de notification est reçu uniquement par le biais de la fonction de rappel de la boîte de dialogue de tâche, qui peut être inscrite à l’aide de la méthode TaskDialogIndirect .
TDN_HYPERLINK_CLICKED	Envoyé par une boîte de dialogue de tâche lorsque l’utilisateur clique sur un lien hypertexte dans le contenu de la boîte de dialogue de tâche. Ce code de notification est reçu uniquement par le biais de la fonction de rappel de la boîte de dialogue de tâche, qui peut être inscrite à l’aide de la méthode TaskDialogIndirect .
TDN_NAVIGATED	Envoyé par une boîte de dialogue de tâche lorsqu’une navigation s’est produite. Ce code de notification est reçu uniquement par le biais de la fonction de rappel de la boîte de dialogue de tâche, qui peut être inscrite à l’aide de la méthode TaskDialogIndirect .
TDN_RADIO_BUTTON_CLICKED	Envoyé par une boîte de dialogue de tâche lorsque l’utilisateur sélectionne un bouton ou un lien de commande dans la boîte de dialogue de tâche. Ce code de notification est reçu uniquement par le biais de la fonction de rappel de la boîte de dialogue de tâche, qui peut être inscrite à l’aide de la méthode TaskDialogIndirect .
TDN_TIMER	Envoyé par une boîte de dialogue de tâche environ toutes les 200 millisecondes. Ce code de notification est envoyé lorsque l’indicateur TDF_CALLBACK_TIMER a été défini dans le membre dwFlags de la structure TASKDIALOGCONFIG qui a été passée à la fonction TaskDialogIndirect . Ce code de notification est reçu uniquement par le biais de la fonction de rappel de la boîte de dialogue de tâche, qui peut être inscrite à l’aide de la méthode TaskDialogIndirect .
TDN_VERIFICATION_CLICKED	Envoyé par la boîte de dialogue de tâche lorsque l’utilisateur clique sur la zone case activée de vérification de la boîte de dialogue de tâche. Ce code de notification est reçu uniquement par le biais de la fonction de rappel de la boîte de dialogue de tâche, qui peut être inscrite à l’aide de la méthode TaskDialogIndirect .

Structures

Rubrique	Contenu
TASKDIALOG_BUTTON	Contient les informations utilisées pour afficher un bouton dans une boîte de dialogue de tâche. La structure TASKDIALOGCONFIG utilise cette structure.
TASKDIALOGCONFIG	Contient les informations utilisées pour afficher une boîte de dialogue de tâche. La fonction TaskDialogIndirect utilise cette structure.