TDM_NAVIGATE_PAGE message

Recrée une boîte de dialogue de tâche avec un nouveau contenu, simulant les fonctionnalités d’un Assistant multipage.

Paramètres

wParam [in]

Non utilisé. Doit être zéro.

lParam [in]

Pointeur vers une structure TASKDIALOGCONFIG qui décrit la boîte de dialogue de tâche à créer. L’application appelante doit allouer cette structure et définir ses membres. Les valeurs des membres varient en fonction du type de page vers lequel l’utilisateur accède.

Valeur retournée

La valeur de retour est ignorée.

Notes

Pour lancer une boîte de dialogue de tâche de l’Assistant, utilisez la fonction TaskDialogIndirect . Lorsque l’utilisateur navigue à l’aide de l’Assistant, envoyez ce message à la boîte de dialogue de tâche pour afficher la page suivante. Une nouvelle boîte de dialogue de tâche (ressemble à une nouvelle page) est créée avec les éléments spécifiés dans la structure pointée vers lParam. Lors de la création, l’intégralité du contenu de l’image de dialogue est détruite et reconstruite. Par conséquent, toutes les informations d’état détenues par les contrôles (par exemple, une barre de progression, un bouton développer ou une case à cocher de vérification) dans la boîte de dialogue sont perdues.

La disposition de la boîte de dialogue de tâche peut échouer et cela peut ne pas être reflété dans la valeur de retour. Une valeur de retour de S_OK indique uniquement que la boîte de dialogue de tâche a reçu le message et a tenté de le traiter. Si la disposition de la boîte de dialogue de tâche échoue (la boîte de dialogue de tâche ne peut pas être affichée), la boîte de dialogue se ferme et un code HRESULT est retourné au niveau de la fonction de rappel inscrite. Pour plus d’informations sur la syntaxe de la fonction de rappel, consultez TaskDialogCallbackProc.

Spécifications

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]
En-tête	Commctrl.h