TDM_UPDATE_ICON message

Actualise l’icône d’une boîte de dialogue de tâche.

Paramètres

wParam [in]

Indique l’élément d’icône à mettre à jour. Ce paramètre doit avoir l’une des valeurs suivantes :

Valeur	Signification
TDIE_ICON_MAIN	Icône principale.
TDIE_ICON_FOOTER	Icône de pied de page.

lParam [in]

Pointeur vers une chaîne (PCWSTR) ou handle vers une icône (HICON) à afficher. Si lParam a la valeur NULL, aucune icône n’est affichée, quelle que soit la valeur de wParam.

Si la valeur de wParam est TDIE_ICON_MAIN et que l’indicateur TDF_USE_HICON_MAIN est défini sur le membre dwFlags de la structure TASKDIALOGCONFIG utilisée pour créer la boîte de dialogue de tâche, lParam doit contenir un handle à une icône (HICON) à afficher.

Si la valeur de wParam est TDIE_ICON_FOOTER et que l’indicateur de TDF_USE_HICON_FOOTER est défini sur le membre dwFlags de la structure TASKDIALOGCONFIG utilisée pour créer la boîte de dialogue de tâche, lParam doit contenir un handle à une icône (HICON) à afficher.

Si les indicateurs TDF_USE_HICON_MAIN ou TDF_USE_HICON_FOOTER ne sont pas définis sur le membre dwFlags , lParam doit pointer vers une chaîne Unicode terminée par null (PCWSTR) qui contient un identificateur de ressource valide transmis via la macro MAKEINTRESOURCE . L’icône s’affiche en fonction de la valeur de wParam : si la valeur est TDIE_ICON_MAIN, l’icône s’affiche dans l’en-tête ; si la valeur est TDIE_ICON_FOOTER, l’icône s’affiche dans le pied de page. La ressource doit provenir du module de ressource de l’application (spécifié dans le membre hInstance de la structure TASKDIALOGCONFIG ), ou si hInstance a la valeur NULL, du module de ressources du système (imageres.dll). Pour identifier une ressource système, utilisez un identificateur système valide transmis via la macro MAKEINTRESOURCE ou l’une des valeurs prédéfinies suivantes à partir de commctrl.h :

Valeur	Signification
TD_ERROR_ICON	Icône de signe d’arrêt.
TD_WARNING_ICON	Icône de point d’exclamation.
TD_INFORMATION_ICON	Lettre minuscule « i » dans une icône de cercle.
TD_SHIELD_ICON	Icône de bouclier de sécurité.

Valeur retournée

La valeur de retour est ignorée.

Notes

La disposition de la boîte de dialogue de tâche avec l’icône peut échouer et cela peut ne pas être répercuté dans la valeur de retour. Une valeur de retour de S_OK reflète 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 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.

Si la boîte de dialogue de tâche est créée sans pied de page (c’est-à-dire que les membres de pied de page appropriés de la structure TASKDIALOGCONFIG utilisés pour créer la boîte de dialogue de tâche sont NULL) et que ce message est envoyé, un pied de page n’est pas ajouté dynamiquement à la boîte de dialogue de tâche. Il en va de même pour l’envoi de ce message pour mettre à jour une icône d’en-tête lorsqu’une boîte de dialogue de tâche est créée sans en-tête. Pour ajouter un en-tête ou un pied de page au moment de l’exécution, utilisez la fonctionnalité TDM_NAVIGATE_PAGE .

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