Sobre as caixas de diálogo de tarefas
Uma caixa de diálogo de tarefa é uma caixa de diálogo que pode ser usada para exibir informações e receber informações simples do usuário. Como uma caixa de mensagem, ele é formatado pelo sistema operacional de acordo com os parâmetros que você definiu. No entanto, uma caixa de diálogo de tarefa tem muito mais recursos do que uma caixa de mensagem.
Observação
Os diálogos de tarefas requerem o modelo STA (Apartamento de Thread Único).
Partes de um diálogo de tarefa
Uma caixa de diálogo de tarefa é composta por vários elementos, sendo a maioria opcional. A ilustração a seguir mostra as várias partes de uma caixa de diálogo de tarefa.
Na ilustração a seguir, o usuário clicou no botão ao lado do texto de controle recolhido, fazendo com que o texto alternativo seja exibido lá e no rodapé.
As ilustrações mostram as seguintes partes:
| Parte | Descrição | Membro TASKDIALOGCONFIG |
|---|---|---|
| Título da janela | Título da janela. | pszWindowTitle |
| Ícone principal | Um ícone grande que indica a finalidade da caixa de diálogo de tarefa. | hMainIcon ou pszMainIcon |
| Instrução principal | Texto principal. | pszMainInstruction |
| Conteúdo | Texto extra. | pszContent |
| Barra de progresso | Uma barra animada que mostra o progresso de alguma tarefa. | dwFlags |
| Botões de opção | Opções definidas pelo aplicativo para o usuário. | pRadioButtons |
| Botão personalizado | Um botão que não é um dos botões comuns. Pode ser um botão normal ou, como mostrado na ilustração, um link de comando com até duas linhas de texto. | pButtons |
| Botão Expandir/recolher | Um botão que pode ser usado para alternar entre o texto de controlo reduzido definido pela aplicação (como "Ver mais detalhes") e o texto de controlo expandido, que pode ocupar duas ou mais linhas. Quando o texto de controle é expandido, o texto adicional em pszExpandedInformation também é mostrado, após o texto do conteúdo ou (como mostrado na segunda ilustração) no rodapé. | pszCollapsedControlText e pszExpandedControlText |
| Caixa de verificação | Uma caixa de seleção, acompanhada de texto definido pelo aplicativo, para opções simples, como "Não mostrar esta caixa de diálogo novamente". | pszVerificationText |
| Ícone de rodapé | Um pequeno ícone que significa a finalidade do texto do rodapé. | hFooterIcon ou pszFooterIcon |
| Texto do rodapé | Texto adicional. Nas ilustrações, o texto contém um hiperlink. | pszFooter |
| Botão comum | Um botão padrão; nas ilustrações, o botão OK. | dwCommonButtons |