Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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. |