Sobre caixas de diálogo de tarefa
Uma caixa de diálogo de tarefa é uma caixa de diálogo que pode ser usada para exibir informações e receber entrada simples do usuário. Como uma caixa de mensagem, ela é formatada pelo sistema operacional de acordo com os parâmetros definidos. No entanto, uma caixa de diálogo de tarefa tem muito mais recursos do que uma caixa de mensagem.
Observação
As caixas de diálogo de tarefas exigem o modelo STA (single-threaded apartment).
Partes de uma caixa de diálogo de tarefa
Uma caixa de diálogo de tarefa consiste em vários elementos, a maioria dos quais são opcionais. 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 |
|---|---|---|
| Window title | Legenda da janela. | pszWindowTitle |
| Ícone principal | Um ícone grande que significa a finalidade da caixa de diálogo da tarefa. | hMainIcon ou pszMainIcon |
| Instrução principal | Texto principal. | pszMainInstruction |
| Sumário | Texto extra. | pszConteúdo |
| 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. | pRadioBotões |
| Botão Personalizado | Um botão que não é um dos botões comuns. Isso pode ser um botão normal ou, como mostrado na ilustração, um link de comando com até duas linhas de texto. | pBotões |
| Botão Expandir/recolher | Um botão que pode ser usado para alternar entre o texto de controle recolhido definido pelo aplicativo (como "Ver mais detalhes") e o texto de controle expandido, que pode estar em 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 seleção 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 de rodapé. | hFooterIcon ou pszFooterIcon |
| Texto do rodapé | Texto adicional. Nas ilustrações, o texto contém um hiperlink. | pszRodapé |
| Botão comum | Um botão padrão; nas ilustrações, o botão OK. | dwCommonButtons |