Compartilhar via


Função de retorno de chamada PFTASKDIALOGCALLBACK (commctrl.h)

A função TaskDialogCallbackProc é uma função definida pelo aplicativo usada com a função TaskDialogIndirect . Ele recebe mensagens da caixa de diálogo da tarefa quando ocorrem vários eventos.

O tipo PFTASKDIALOGCALLBACK define um ponteiro para essa função de retorno de chamada. TaskDialogCallbackProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PFTASKDIALOGCALLBACK Pftaskdialogcallback;

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

Parâmetros

[in] hwnd

Tipo: HWND

Manipule para a janela TaskDialog. Não continue enviando mensagens para o hwnd depois que o procedimento de retorno de chamada retornar de ter sido chamado com TDN_DESTROYED.

[in] msg

Tipo: UINT

Uma das notificações a seguir.

Notification Uso
TDN_BUTTON_CLICKED Indica que um botão foi selecionado. A ID de comando do botão é especificada pelo wParam.
TDN_CREATED Indica que a caixa de diálogo Tarefa foi criada.
TDN_DESTROYED Indica que a caixa de diálogo Tarefa foi destruída.
TDN_DIALOG_CONSTRUCTED Indica que a Caixa de Diálogo da Tarefa foi criada, mas ainda não foi exibida.
TDN_EXPANDO_BUTTON_CLICKED Indica que o botão expando foi selecionado.
TDN_HELP Indica que a tecla F1 foi pressionada enquanto a Caixa de Diálogo de Tarefa tem o foco.
TDN_HYPERLINK_CLICKED Indica que um hiperlink foi selecionado. Um ponteiro para o texto do link é especificado por lParam.
TDN_NAVIGATED Indica que a navegação ocorreu.
TDN_RADIO_BUTTON_CLICKED Indica que um botão de opção foi selecionado. A ID de comando do botão de opção é especificada pelo wParam.
TDN_TIMER Indica que o temporizador da Caixa de Diálogo da Tarefa foi acionado. O tempo decorrido total é especificado por wParam. Você pode atualizar a barra de progresso enviando uma mensagem TDM_SET_PROGRESS_BAR_POS para a janela especificada pelo parâmetro hwnd .
TDN_VERIFICATION_CLICKED Indica que a caixa de marcar de verificação da Caixa de Diálogo da Tarefa foi selecionada.

[in] wParam

Tipo: WPARAM

Especifica informações adicionais de notificação. O conteúdo desse parâmetro depende do valor do parâmetro uNotification .

[in] lParam

Tipo: LPARAM

Especifica informações adicionais de notificação. O conteúdo desse parâmetro depende do valor do parâmetro uNotification .

lpRefData

Tipo: LONG_PTR

Ponteiro para dados específicos do aplicativo. Esses são os dados apontados pelo membro lpCallbackData da estrutura TASKDIALOGCONFIG usada para criar a caixa de diálogo da tarefa.

Retornar valor

Tipo: HRESULT

O valor retornado é específico para a notificação que está sendo processada. Ao responder a um clique de botão, sua implementação deverá retornar S_FALSE se a Caixa de Diálogo da Tarefa não for fechada. Caso contrário, retorne S_OK.

Comentários

Um aplicativo deve registrar essa função de retorno de chamada passando seu endereço no membro pfCallback da estrutura TASKDIALOGCONFIG que é passada por meio de ponteiro por meio de TaskDialogIndirect.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commctrl.h (inclua Commctrl.h)