Caixa de diálogo Tarefa

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 de tarefa é semelhante, embora muito mais flexível do que uma caixa de mensagem básica.

Visões gerais

Tópico	Contents
Sobre caixas de diálogo de tarefas	Descreve os elementos de uma caixa de diálogo de tarefa.

Funções

Tópico	Contents
TaskDialog	Cria, exibe e opera uma caixa de diálogo de tarefa. A caixa de diálogo de tarefa contém texto e título da mensagem definidos pelo aplicativo, ícones e qualquer combinação de botões predefinidos. Esta função não suporta o 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 de tarefa quando vários eventos ocorrem. O tipo de retorno de chamada PFTASKDIALOGDEFINE um ponteiro para essa função de retorno de chamada. TaskDialogCallbackProc é um espaço reservado para o nome da função definida pelo aplicativo.
TaskDialogIndireto	Cria, exibe e opera uma caixa de diálogo de tarefa. A caixa de diálogo de tarefa contém ícones definidos pelo aplicativo, mensagens, título, caixa de seleção de verificação, links de comando, botões de pressão e botões de opção. Esta função pode registrar uma função de retorno de chamada para receber mensagens de notificação.

Mensagens

Tópico	Contents
TDM_CLICK_BUTTON	Simula a ação de um clique em um botão em uma caixa de diálogo de tarefa.
TDM_CLICK_RADIO_BUTTON	Simula a ação de um clique no botão de opção em uma caixa de diálogo de tarefa.
TDM_CLICK_VERIFICATION	Simula a ação de um clique na caixa de seleção de verificação em uma caixa de diálogo de tarefa.
TDM_ENABLE_BUTTON	Habilita ou desabilita um botão de pressão em uma caixa de diálogo de tarefa.
TDM_ENABLE_RADIO_BUTTON	Habilita ou desabilita um botão de opção em uma caixa de diálogo de tarefa.
TDM_NAVIGATE_PAGE	Recria uma caixa de diálogo de tarefa com novos conteúdos, simulando a funcionalidade de um assistente de várias páginas.
TDM_SET_BUTTON_ELEVATION_REQUIRED_STATE	Especifica se um determinado botão de diálogo de tarefa ou link de comando deve ter um ícone de escudo do Controle de Conta de Usuário (UAC); ou seja, se a ação invocada pelo botão requer elevação.
TDM_SET_ELEMENT_TEXT	Atualiza um elemento de texto em uma caixa de diálogo de tarefa.
TDM_SET_MARQUEE_PROGRESS_BAR	Indica se a barra de progresso hospedada deve ser exibida no modo de letreiro.
TDM_SET_PROGRESS_BAR_MARQUEE	Inicia e interrompe a exibição do letreiro da barra de progresso e define a velocidade do letreiro.
TDM_SET_PROGRESS_BAR_POS	Define a posição atual de uma barra de progresso.
TDM_SET_PROGRESS_BAR_RANGE	Define os valores mínimo e máximo para a barra de progresso hospedada.
TDM_SET_PROGRESS_BAR_STATE	Define o estado atual da barra de progresso.
TDM_UPDATE_ELEMENT_TEXT	Atualiza um elemento de texto em uma caixa de diálogo de tarefa.
TDM_UPDATE_ICON	Atualiza o ícone de uma caixa de diálogo de tarefa.

Notifications

Tópico	Contents
TDN_BUTTON_CLICKED	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 de tarefa. 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.
TDN_CREATED	Enviado por uma caixa de diálogo de tarefa depois que a caixa de diálogo de tarefa tiver sido criada 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 de tarefa, que pode ser registrada usando o método TaskDialogIndirect.
TDN_DESTROYED	Enviado 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 de tarefa, que pode ser registrada usando o método TaskDialogIndirect.
TDN_DIALOG_CONSTRUCTED	Enviado por uma caixa de diálogo de tarefa depois que a caixa de diálogo de tarefa tiver sido criada 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 de tarefa, que pode ser registrada usando o método TaskDialogIndirect.
TDN_EXPANDO_BUTTON_CLICKED	Enviado por uma caixa de diálogo de tarefa quando o usuário clica no botão expandir da caixa de diálogo de tarefa. 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.
TDN_HELP	Enviado por uma caixa de diálogo de tarefa quando o usuário pressiona F1 no teclado enquanto a caixa de diálogo de 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 de tarefa, que pode ser registrada usando o método TaskDialogIndirect.
TDN_HYPERLINK_CLICKED	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 de tarefa. 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.
TDN_NAVIGATED	Enviado por uma caixa de diálogo de tarefa quando ocorre 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 de tarefa, que pode ser registrada usando o método TaskDialogIndirect.
TDN_RADIO_BUTTON_CLICKED	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 de tarefa. 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.
TDN_TIMER	Enviado por uma caixa de diálogo de tarefa aproximadamente a cada 200 milissegundos. Esse código de notificação é enviado quando o sinalizador TDF_CALLBACK_TIMER foi definido no membro dwFlags da estrutura TASKDIALOGCONFIG que foi passada para a função TaskDialogIndirect. 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.
TDN_VERIFICATION_CLICKED	Enviado pela caixa de diálogo de tarefa quando o usuário clica na caixa de seleção de verificação da caixa de diálogo de tarefa. 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.

Estruturas

Tópico	Contents
TASKDIALOG_BUTTON	Contém informações usadas para exibir um botão em uma caixa de diálogo de tarefa. A estrutura TASKDIALOGCONFIG usa essa estrutura.
TASKDIALOGCONFIG	Contém informações usadas para exibir uma caixa de diálogo de tarefa. A função TaskDialogIndirect usa essa estrutura.