Tipos comuns de caixa de diálogo
A Biblioteca de Caixas de Diálogo Comuns fornece uma função de criação e uma estrutura para cada tipo de caixa de diálogo comum. Para usar uma caixa de diálogo comum em sua forma mais simples, você chama sua função de criação e especifica um ponteiro para uma estrutura que contém valores iniciais e sinalizadores de opção. Depois de inicializar a caixa de diálogo, o procedimento da caixa de diálogo usa a estrutura para retornar informações sobre a entrada do usuário. Você também pode personalizar uma caixa de diálogo comum para atender às necessidades do aplicativo.
A tabela a seguir fornece uma breve descrição dos diferentes tipos de caixas de diálogo comuns e mostra a função e a estrutura usadas com cada tipo.
| Caixa de diálogo | Descrição |
|---|---|
|
de Cores |
Exibe as cores disponíveis e, opcionalmente, permite que o usuário crie cores personalizadas. O usuário pode selecionar uma cor básica ou personalizada. Use a função ChooseColor e estrutura CHOOSECOLOR. Para obter mais informações, consulte caixa de diálogo Cor. |
|
localizar |
Exibe uma caixa de diálogo na qual o usuário pode digitar a cadeia de caracteres a ser encontrada. O usuário também pode especificar opções de pesquisa, como a direção da pesquisa e se a pesquisa diferencia maiúsculas de minúsculas. Use a função FindText e estrutura de FINDREPLACE. Para obter mais informações, consulte Localizar e Substituir Caixas de Diálogo. |
| fonte |
Exibe uma caixa de diálogo na qual o usuário pode selecionar uma família de fontes e um estilo de fonte associado, tamanhos de ponto e outros atributos de fonte, como cor da fonte, sublinhado ou tachado. Use a função ChooseFont e estrutura CHOOSEFONT. Para obter mais informações, consulte Caixa de diálogo Fonte. |
|
Abrir |
Exibe uma caixa de diálogo na qual o usuário pode digitar ou selecionar o nome de um objeto de espaço de nome de arquivo ou shell a ser aberto. A caixa de diálogo inclui listas de unidades, diretórios e extensões de espaço de nome do shell que permitem que o usuário navegue pelo espaço de nome do shell. Ele também inclui uma lista de extensões de nome de arquivo que permite ao usuário filtrar os nomes de arquivo exibidos. Use a funçãoGetOpenFileName e estrutura de OPENFILENAME. Para obter mais informações, consulte Caixas de diálogo Abrir e Salvar como. |
|
de instalação de página |
Exibe a configuração da página atual. O usuário pode selecionar opções de configuração de página, como orientação de papel, tamanho, origem e margens. Use a função PageSetupDlg e estrutura de PAGESETUPDLG. Para obter mais informações, consulte Caixa de diálogo Configuração de Página. |
|
imprimir |
Exibe informações sobre a impressora instalada e sua configuração. O usuário pode selecionar opções de trabalho de impressão, como o intervalo de páginas a serem impressas e o número de cópias, e iniciar o processo de impressão. Use a função PrintDlg e estrutura de PRINTDLG. Para obter mais informações, consulte caixa de diálogo Imprimir. Para exibir uma folha de propriedades Imprimir em vez de uma caixa de diálogo imprimir , use a função PrintDlgEx com a estruturaPRINTDLGEX. A página Geral da folha de propriedades é semelhante à caixa de diálogo Imprimir. A folha de propriedades pode ter páginas de propriedades específicas do aplicativo e específicas do driver após a página Geral. Para obter mais informações, consulte Folha de Propriedades de Impressão. |
|
Substituir |
Exibe uma caixa de diálogo na qual o usuário pode digitar a cadeia de caracteres a ser encontrada e a cadeia de caracteres de substituição. O usuário pode especificar opções de pesquisa, como se a pesquisa diferencia maiúsculas de minúsculas e opções de substituição, como o escopo da substituição. Use a funçãoReplaceText e estrutura de FINDREPLACE. Para obter mais informações, consulte Localizar e Substituir Caixas de Diálogo. |
|
Salvar como |
Exibe uma caixa de diálogo na qual o usuário pode digitar ou selecionar o nome com o qual salvar um objeto de espaço de nome de arquivo ou shell. A caixa de diálogo inclui listas de unidades, diretórios e extensões de espaço de nome do shell que permitem que o usuário navegue pelo espaço de nome do shell. Ele também inclui uma lista de extensões de nome de arquivo que permite ao usuário filtrar os nomes de arquivo exibidos. Use a funçãoGetSaveFileName e estrutura de OPENFILENAME. Para obter mais informações, consulte Caixas de diálogo Abrir e Salvar como. |
Embora uma caixa de diálogo Configuração de Impressão esteja disponível, ela foi substituída pela caixa de diálogo de Instalação de Página. Os aplicativos devem usar a caixa de diálogo configuração de página em vez da caixa de diálogo de Instalação de Impressão.
Todas as caixas de diálogo comuns são modais, exceto as caixas de diálogo Localizar e Substituir. As caixas de diálogo modais devem ser fechadas pelo usuário antes que a função usada para criar a caixa de diálogo possa ser retornada. As caixas de diálogo Localizar e substituir são modeless; a função retorna antes do fechamento da caixa de diálogo. Se você usar as caixas de diálogo Localizar e Substituir, também deverá usar a função IsDialogMessage no loop de mensagem principal do aplicativo para garantir que essas caixas de diálogo processem corretamente a entrada do teclado, como as teclas TAB e ESC.