Tipos de caixa de diálogo

A biblioteca de caixa de diálogo comum 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ê chamar sua função de criação e especifica um ponteiro para uma estrutura que contém os valores iniciais e sinalizadores de opção. Após inicializar a caixa de diálogo, o procedimento caixa 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 as necessidades do seu 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 usada com cada tipo.

Caixa de diálogo comum Descrição
Cor Exibe cores disponíveis e, opcionalmente, permite ao usuário criar cores personalizadas. O usuário pode selecionar uma cor básica ou personalizada. Use a função ChooseColor e CHOOSECOLOR estrutura.
Localização Exibe uma caixa de diálogo na qual o usuário pode digitar a Cadeia de caracteres para localizar. O usuário também pode especificar opções de pesquisa, tais como a direção da pesquisa e se Pesquisarr é diferencia maiúscminúsc de minúsculas. Use a função FindText e a estrutura FINDREPLACE.
Fonte Exibe listas de fontes disponíveis, tamanhos e outros atributos de fonte que o usuário pode selecionar. Use o ChooseFont função e estrutura CHOOSEFONT.
Aberto Exibe listas de drives, pastas e extensões de nome de arquivo do qual o usuário pode selecionar para exibir uma lista de nomes de arquivos. O usuário pode digitar um nome de arquivo ou selecione um na lista para identificar o arquivo a ser aberto. Use o GetOpenFileName função e estrutura OPENFILENAME.
Impressão Exibe informações sobre a impressora instalada e sua configuração. O usuário pode selecionar opções de tarefa de impressão, como intervalo de páginas a serem impressas e o número de cópias e iniciar o processo de impressão. Use o PrintDlg função e estrutura de PRINTDLG.

Windows NT 5.0 e posterior: Para exibir uma folha de propriedades de impressão em vez de uma caixa de diálogo Imprimir , use a função PrintDlgEx com a estrutura PRINTDLGEX . A página Geral da folha é semelhante à caixa de diálogo Imprimir . A folha também pode ter páginas de propriedades adicionais específicas do aplicativo e específicos de driver após a página Geral.

Configurar página Exibe a atual configuração de página. O usuário pode selecionar opções de configuração de página, como orientação do papel, tamanho, fonte e as margens. Use o PageSetupDlg função e estrutura de PAGESETUPDLG.
Substituir Exibe uma caixa de diálogo na qual o usuário pode digitar a Cadeia de caracteres a localizar e a Cadeia de caracteres de substituição. O usuário pode especificar opções de pesquisa, como se Pesquisarr é diferencia maiúscminúsc de minúsculas e opções de substituição, tais como o âmbito de aplicação da substituição. Use a função ReplaceText e estrutura FINDREPLACE.
Salvar como Exibe listas de drives, pastas e extensões de nome de arquivo do qual o usuário pode selecionar para exibir uma lista de nomes de arquivos. O usuário pode digitar um nome de arquivo ou selecione um na lista para especificar o nome com o qual deseja salvar o arquivo. Use o GetSaveFileName função e estrutura OPENFILENAME.

&Notanbsp; Apesar de uma caixa de diálogo Configurar impressão também está disponível, foi superado pela caixa de diálogo Configurar página . Novos aplicativos escritos para Windows 95 ou Windows NT versões 3.51 ou posterior devem usar a caixa de diálogo Configurar página , em vez da caixa de diálogo Configurar impressão .

Todas as caixas de diálogo comuns são restritas, exceto as caixas de diálogo Localizar e Substituir . Caixas de diálogo modais devem ser fechadas pelo usuário antes que a função usada para criar a caixa de diálogo pode retornar. As caixas de diálogo Localizar e Substituir são sem janela restrita; a função retorna antes da caixa de diálogo é fechada. Se você usar as caixas de diálogo Localizar e Substituir , você também deve usar o IsDialogMessage função no loop de mensagem principal do seu aplicativo para garantir que essas caixas de diálogo processam corretamente a entrada de teclado, tais como as teclas tab e esc.

Index