Esta seção contém informações sobre os elementos de programação usados com uma caixa de diálogo de tarefa. Uma caixa de diálogo tarefa é semelhante a, embora muito mais flexível do que, uma caixa de mensagem básica.
Descreve os elementos de uma caixa de diálogo de tarefa.
Funções
Tópico
Conteúdo
TaskDialog
Cria, exibe e opera uma caixa de diálogo de tarefa. A caixa de diálogo da tarefa contém texto e título de mensagem definidos pelo aplicativo, ícones e qualquer combinação de botões de push predefinidos. Essa função não dá suporte ao registro de uma função de retorno de chamada para receber notificações.
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 de 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.
TaskDialogIndirect
Cria, exibe e opera uma caixa de diálogo de tarefa. A caixa de diálogo da tarefa contém ícones definidos pelo aplicativo, mensagens, título, caixa de seleção de verificação, links de comando, botões de push e botões de opção. Essa função pode registrar uma função de retorno de chamada para receber mensagens de notificação.
Especifica se um determinado botão de caixa de diálogo de tarefa ou link de comando deve ter um ícone de escudo do UAC (Controle de Conta de Usuário). ou seja, se a ação invocada pelo botão requer elevação.
Enviado por uma caixa de diálogo de tarefa quando o usuário seleciona um botão ou link de comando na caixa de diálogo da tarefa. Esse código de notificação é recebido somente por meio da função de retorno de chamada da caixa de diálogo da tarefa, que pode ser registrada usando o métodoTaskDialogIndirect.
Enviado por uma caixa de diálogo de tarefa após a criação da caixa de diálogo da tarefa e antes de ser exibida. Esse código de notificação é recebido somente por meio da função de retorno de chamada da caixa de diálogo da tarefa, que pode ser registrada usando o métodoTaskDialogIndirect.
Enviada por uma caixa de diálogo de tarefa quando ela é destruída e seu identificador de janela não é mais válido. Esse código de notificação é recebido somente por meio da função de retorno de chamada da caixa de diálogo da tarefa, que pode ser registrada usando o métodoTaskDialogIndirect.
Enviado por uma caixa de diálogo de tarefa após a criação da caixa de diálogo da tarefa e antes de ser exibida. Esse código de notificação é recebido somente por meio da função de retorno de chamada da caixa de diálogo da tarefa, que pode ser registrada usando o métodoTaskDialogIndirect.
Enviado por uma caixa de diálogo de tarefa quando o usuário clica no botão expando da caixa de diálogo da tarefa. Esse código de notificação é recebido somente por meio da função de retorno de chamada da caixa de diálogo da tarefa, que pode ser registrada usando o métodoTaskDialogIndirect.
Enviado por uma caixa de diálogo de tarefa quando o usuário pressiona F1 no teclado enquanto a caixa de diálogo da tarefa tem foco. Esse código de notificação é recebido somente por meio da função de retorno de chamada da caixa de diálogo da tarefa, que pode ser registrada usando o métodoTaskDialogIndirect.
Enviado por uma caixa de diálogo de tarefa quando o usuário clica em um hiperlink no conteúdo da caixa de diálogo da tarefa. Esse código de notificação é recebido somente por meio da função de retorno de chamada da caixa de diálogo da tarefa, que pode ser registrada usando o métodoTaskDialogIndirect.
Enviado por uma caixa de diálogo de tarefa quando ocorreu uma navegação. Esse código de notificação é recebido somente por meio da função de retorno de chamada da caixa de diálogo da tarefa, que pode ser registrada usando o métodoTaskDialogIndirect.
Enviado por uma caixa de diálogo de tarefa quando o usuário seleciona um botão ou link de comando na caixa de diálogo da tarefa. Esse código de notificação é recebido somente por meio da função de retorno de chamada da caixa de diálogo da tarefa, que pode ser registrada usando o métodoTaskDialogIndirect.
Enviado por uma caixa de diálogo de tarefa aproximadamente a cada 200 milissegundos. Esse código de notificação é enviado quando o sinalizador de TDF_CALLBACK_TIMER foi definido no membro dwFlags da estruturaTASKDIALOGCONFIG que foi passada para a funçãoTaskDialogIndirect. Esse código de notificação é recebido somente por meio da função de retorno de chamada da caixa de diálogo de tarefa, que pode ser registrada usando o método TaskDialogIndirect.
Enviada pela caixa de diálogo da tarefa quando o usuário clica na caixa de seleção de verificação da caixa de diálogo da tarefa. Esse código de notificação é recebido somente por meio da função de retorno de chamada da caixa de diálogo da tarefa, que pode ser registrada usando o métodoTaskDialogIndirect.