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. |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de