Partager via

Boîte de dialogue Tâche

  • Article

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 qu’elle soit beaucoup plus flexible qu’une boîte de message de base.

Aperçus

Sujet Contenu
à propos des dialogues de tâche Décrit les éléments d’une boîte de dialogue de tâche.

Fonctions

Sujet Contenu
TaskDialog Crée, affiche et exploite 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, les icônes et toute combinaison de boutons Push 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 la fonction définie par l’application.
TaskDialogIndirect Crée, affiche et exploite 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 case à cocher de vérification, des liens de commande, des boutons push et des cases d’option. Cette fonction peut inscrire une fonction de rappel pour recevoir des messages de notification.

Messages

Sujet Contenu
TDM_CLICK_BUTTON Simule l’action d’un clic sur un 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 Push 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 un nouveau contenu, 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 ou un lien de commande donné doit avoir une icône de protection 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 Met à 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 marque.
TDM_SET_PROGRESS_BAR_MARQUEE Démarre et arrête l’affichage du pointage de la barre de progression et définit la vitesse du pointage.
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 de 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 Met à 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

Sujet 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 via la fonction de rappel de 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 une fois la boîte de dialogue de tâche créée et avant son affichage. Ce code de notification est reçu uniquement via la fonction de rappel de 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 sa poignée de fenêtre n’est plus valide. Ce code de notification est reçu uniquement via la fonction de rappel de 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 une fois la boîte de dialogue de tâche créée et avant son affichage. Ce code de notification est reçu uniquement via la fonction de rappel de 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 via la fonction de rappel de 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 pendant que la boîte de dialogue de tâche a le focus. Ce code de notification est reçu uniquement via la fonction de rappel de 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 via la fonction de rappel de 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 via la fonction de rappel de 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 via la fonction de rappel de 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 de TDF_CALLBACK_TIMER a été défini dans le membre dwFlags de la structure TASKDIALOG CONFIG qui a été passée à la fonction TaskDialogIndirect. Ce code de notification est reçu uniquement via la fonction de rappel de 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 case à cocher vérification de la boîte de dialogue de tâche. Ce code de notification est reçu uniquement via la fonction de rappel de boîte de dialogue de tâche, qui peut être inscrite à l’aide de la méthode TaskDialogIndirect.

Structures

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