Fonction de rappel PFTASKDIALOGCALLBACK (commctrl.h)

Article
08/22/2023

La fonction TaskDialogCallbackProc est une 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.

Syntaxe

PFTASKDIALOGCALLBACK Pftaskdialogcallback;

HRESULT Pftaskdialogcallback(
  [in] HWND hwnd,
  [in] UINT msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam,
       LONG_PTR lpRefData
)
{...}

Paramètres

[in] hwnd

Type : HWND

Gérez vers la fenêtre TaskDialog. Ne continuez pas à envoyer des messages à hwnd après que la procédure de rappel a été appelée avec TDN_DESTROYED.

[in] msg

Type : UINT

Une des notifications suivantes.

Notification	Utilisation
TDN_BUTTON_CLICKED	Indique qu’un bouton a été sélectionné. L’ID de commande du bouton est spécifié par wParam.
TDN_CREATED	Indique que la boîte de dialogue Tâche a été créée.
TDN_DESTROYED	Indique que la boîte de dialogue Tâche a été détruite.
TDN_DIALOG_CONSTRUCTED	Indique que la boîte de dialogue Tâche a été créée, mais qu’elle n’a pas encore été affichée.
TDN_EXPANDO_BUTTON_CLICKED	Indique que le bouton expando a été sélectionné.
TDN_HELP	Indique que la touche F1 a été enfoncée alors que la boîte de dialogue Tâche a le focus.
TDN_HYPERLINK_CLICKED	Indique qu’un lien hypertexte a été sélectionné. Un pointeur vers le texte du lien est spécifié par lParam.
TDN_NAVIGATED	Indique que la navigation s’est produite.
TDN_RADIO_BUTTON_CLICKED	Indique qu’une case d’option a été sélectionnée. L’ID de commande de la case d’option est spécifié par wParam.
TDN_TIMER	Indique que le minuteur de boîte de dialogue de tâche a été déclenché. Le temps total écoulé est spécifié par wParam. Vous pouvez mettre à jour la barre de progression en envoyant un message TDM_SET_PROGRESS_BAR_POS à la fenêtre spécifiée par le paramètre hwnd .
TDN_VERIFICATION_CLICKED	Indique que la zone case activée vérification de la boîte de dialogue de tâche a été sélectionnée.

[in] wParam

Type : WPARAM

Spécifie des informations de notification supplémentaires. Le contenu de ce paramètre dépend de la valeur du paramètre uNotification .

[in] lParam

Type : LPARAM

Spécifie des informations de notification supplémentaires. Le contenu de ce paramètre dépend de la valeur du paramètre uNotification .

lpRefData

Type : LONG_PTR

Pointeur vers des données spécifiques à l’application. Il s’agit des données pointées par le membre lpCallbackData de la structure TASKDIALOGCONFIG utilisé pour créer la boîte de dialogue de tâche.

Valeur retournée

Type : HRESULT

La valeur de retour est spécifique à la notification en cours de traitement. Lorsque vous répondez à un clic sur un bouton, votre implémentation doit retourner S_FALSE si la boîte de dialogue Tâche ne doit pas se fermer. Sinon, retournez S_OK.

Remarques

Une application doit inscrire cette fonction de rappel en passant son adresse dans le membre pfCallback de la structure TASKDIALOGCONFIG qui est transmise via le pointeur via TaskDialogIndirect.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commctrl.h (include Commctrl.h)

Partager via