Ler em inglês

Partilhar via

Caixa de diálogo Tarefa

  • Artigo

Esta seção contém informações sobre os elementos de programação usados com uma caixa de diálogo de tarefa. Um de diálogo de tarefas é semelhante, embora muito mais flexível do que uma caixa de mensagem básica.

Visão geral

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

Funções

Tópico Índice
TaskDialog Cria, exibe e opera uma caixa de diálogo de tarefas. A caixa de diálogo da 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 registo de uma função de retorno de chamada para receber notificações.
TaskDialogCallbackProc Uma função definida pelo aplicativo usada com a funçãoTaskDialogIndirect. Ele recebe mensagens da caixa de diálogo de tarefas quando vários eventos ocorrem.
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 tarefas. 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 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 Índice
TDM_CLICK_BUTTON Simula a ação de um clique de 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 uma caixa de seleção de verificação clique em uma caixa de diálogo de tarefa.
TDM_ENABLE_BUTTON Ativa ou desativa um botão de pressão em uma caixa de diálogo de tarefas.
TDM_ENABLE_RADIO_BUTTON Habilita ou desabilita um botão de opção em uma caixa de diálogo de tarefas.
TDM_NAVIGATE_PAGE Recria uma caixa de diálogo de tarefas 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 UAC (Controle de Conta de Usuário); 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 para a exibição da marca de seleção da barra de progresso e define a velocidade da marca de seleção.
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.

Notificações

Tópico Índice
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étodoTaskDialogInindirect.
TDN_CREATED Enviado por uma caixa de diálogo de tarefa após a caixa de diálogo de tarefa ter 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étodoTaskDialogInindirect.
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étodoTaskDialogInindirect.
TDN_DIALOG_CONSTRUCTED Enviado por uma caixa de diálogo de tarefa após a caixa de diálogo de tarefa ter 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étodoTaskDialogInindirect.
TDN_EXPANDO_BUTTON_CLICKED Enviado por uma caixa de diálogo de tarefa quando o usuário clica no botão expando 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étodoTaskDialogInindirect.
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étodoTaskDialogInindirect.
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étodoTaskDialogInindirect.
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étodoTaskDialogInindirect.
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étodoTaskDialogInindirect.
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 de TDF_CALLBACK_TIMER foi definido no dwFlags membro 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.
TDN_VERIFICATION_CLICKED Enviado 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 de tarefa, que pode ser registrada usando o métodoTaskDialogInindirect.

Estruturas

Tópico Índice
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.