messaggio TDM_UPDATE_ICON

Aggiorna l'icona di una finestra di dialogo attività.

Parametri

wParam [in]

Indica l'elemento icona da aggiornare. Questo parametro deve essere uno dei valori seguenti:

Valore	Significato
TDIE_ICON_MAIN	Icona principale.
TDIE_ICON_FOOTER	Icona del piè di pagina.

lParam [in]

Puntatore a una stringa (PCWSTR) o handle a un'icona (HICON) da visualizzare. Se lParam è NULL, non viene visualizzata alcuna icona, indipendentemente dal valore di wParam.

Se il valore di wParam è TDIE_ICON_MAIN e il flag TDF_USE_HICON_MAIN viene impostato sul membro dwFlags della struttura TASKDIALOGCONFIG utilizzato per creare la finestra di dialogo attività, lParam deve contenere un handle per visualizzare un'icona (HICON).

Se il valore di wParam è TDIE_ICON_FOOTER e il flag TDF_USE_HICON_FOOTER viene impostato sul membro dwFlags della struttura TASKDIALOGCONFIG utilizzato per creare la finestra di dialogo attività, lParam deve contenere un handle per visualizzare un'icona (HICON).

Se i flag TDF_USE_HICON_MAIN o TDF_USE_HICON_FOOTER non sono impostati nel membro dwFlags , lParam deve puntare a una stringa Unicode con terminazione Null (PCWSTR) che contiene un identificatore di risorsa valido passato attraverso la macro MAKEINTRESOURCE . L'icona viene visualizzata in base al valore di wParam: se il valore è TDIE_ICON_MAIN, l'icona viene visualizzata nell'intestazione; se il valore è TDIE_ICON_FOOTER, l'icona viene visualizzata nel piè di pagina. La risorsa deve essere del modulo di risorse dell'applicazione (specificato nel membro hInstance della struttura TASKDIALOGCONFIG ) o se hInstance è NULL, dal modulo di risorse del sistema (imageres.dll). Per identificare una risorsa di sistema, usare un identificatore di sistema valido passato tramite la macro MAKEINTRESOURCE o uno dei valori predefiniti seguenti da commctrl.h:

Valore	Significato
TD_ERROR_ICON	Icona del segno di arresto.
TD_WARNING_ICON	Icona punto esclamativo.
TD_INFORMATION_ICON	Lettera minuscola "i" in un'icona a forma di cerchio.
TD_SHIELD_ICON	Icona dello scudo di sicurezza.

Valore restituito

Il valore restituito viene ignorato.

Commenti

Il layout della finestra di dialogo attività con l'icona potrebbe non riuscire e questo potrebbe non essere riflesso nel valore restituito. Un valore restituito di S_OK riflette solo che la finestra di dialogo attività ha ricevuto il messaggio e ha tentato di elaborarla. Se il layout della finestra di dialogo attività ha esito negativo, la finestra di dialogo verrà chiusa e verrà restituito un codice HRESULT nella funzione di callback registrata. Per altre informazioni sulla sintassi della funzione di callback, vedere TaskDialogCallbackProc.

Se la finestra di dialogo attività viene creata senza piè di pagina, ovvero i membri del piè di pagina appropriati della struttura TASKDIALOGCONFIG utilizzata per creare la finestra di dialogo attività sono NULL e questo messaggio viene inviato, un piè di pagina non viene aggiunto dinamicamente alla finestra di dialogo attività. Lo stesso vale per l'invio di questo messaggio per aggiornare un'icona di intestazione quando viene creata una finestra di dialogo attività senza intestazione. Per aggiungere un'intestazione o un piè di pagina in fase di esecuzione, usare la funzionalità TDM_NAVIGATE_PAGE .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Commctrl.h