TDM_UPDATE_ICON mensagem

Atualiza o ícone de uma caixa de diálogo de tarefa.

Parâmetros

wParam [in]

Indica qual elemento de ícone atualizar. Esse parâmetro deve ser um dos seguintes valores:

Valor	Significado
TDIE_ICON_MAIN	Ícone principal.
TDIE_ICON_FOOTER	Ícone do rodapé.

lParam [in]

Um ponteiro para uma cadeia de caracteres (PCWSTR) ou identificador para um ícone (HICON) a ser exibido. Se lParam for NULL, nenhum ícone será exibido, independentemente do valor de wParam.

Se o valor de wParam for TDIE_ICON_MAIN e o sinalizador TDF_USE_HICON_MAIN estiver definido no membro dwFlags da estrutura TASKDIALOGCONFIG usada para criar a caixa de diálogo de tarefa, lParam deverá conter um identificador para um ícone (HICON) a ser exibido.

Se o valor de wParam for TDIE_ICON_FOOTER e o sinalizador TDF_USE_HICON_FOOTER for definido no membro dwFlags da estrutura TASKDIALOGCONFIG usada para criar a caixa de diálogo de tarefa, lParam deverá conter um identificador para um ícone (HICON) a ser exibido.

Se os sinalizadores TDF_USE_HICON_MAIN ou TDF_USE_HICON_FOOTER não estiverem definidos no membro dwFlags , lParam deverá apontar para uma cadeia de caracteres Unicode (PCWSTR) terminada em nulo que contenha um identificador de recurso válido passado pela macro MAKEINTRESOURCE . O ícone é exibido com base no valor de wParam: se o valor for TDIE_ICON_MAIN, o ícone será exibido no cabeçalho; se o valor for TDIE_ICON_FOOTER, o ícone será exibido no rodapé. O recurso deve ser do módulo de recurso do aplicativo (especificado no membro hInstance da estrutura TASKDIALOGCONFIG ) ou se hInstance for NULL, do módulo de recursos do sistema (imageres.dll). Para identificar um recurso do sistema, use um identificador de sistema válido passado pela macro MAKEINTRESOURCE ou um dos seguintes valores predefinidos de commctrl.h:

Valor	Significado
TD_ERROR_ICON	Um ícone de sinal de parada.
TD_WARNING_ICON	Um ícone de ponto de exclamação.
TD_INFORMATION_ICON	Uma letra minúscula "i" em um ícone de círculo.
TD_SHIELD_ICON	Um ícone de escudo de segurança.

Valor retornado

O valor retornado é ignorado.

Comentários

O layout da caixa de diálogo da tarefa com o ícone pode falhar e isso pode não ser refletido no valor retornado. Um valor retornado de S_OK reflete apenas que a caixa de diálogo da tarefa recebeu a mensagem e tentou processá-la. Se o layout da caixa de diálogo da tarefa falhar, a caixa de diálogo será fechada e um código HRESULT será retornado na função de retorno de chamada registrada. Para obter mais informações sobre a sintaxe da função de retorno de chamada, consulte TaskDialogCallbackProc.

Se a caixa de diálogo da tarefa for criada sem um rodapé (ou seja, os membros de rodapé apropriados da estrutura TASKDIALOGCONFIG usada para criar a caixa de diálogo da tarefa serão NULL) e essa mensagem será enviada, um rodapé não será adicionado dinamicamente à caixa de diálogo da tarefa. O mesmo vale para enviar essa mensagem para atualizar um ícone de cabeçalho quando uma caixa de diálogo de tarefa é criada sem um cabeçalho. Para adicionar um cabeçalho ou rodapé em tempo de execução, use a funcionalidade TDM_NAVIGATE_PAGE .

Requisitos