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, chame sua função de criação e especifique um ponteiro para uma estrutura que contenha 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
Color	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 a 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 a estrutura FINDREPLACE . Para obter mais informações, consulte Caixas de diálogo Localizar e Substituir.
Fonte	Exibe uma caixa de diálogo na qual o usuário pode selecionar uma família de fontes e 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 a 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 name-space 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 que o usuário filtre os nomes de arquivo exibidos. Use a função GetOpenFileName e a estrutura OPENFILENAME . Para obter mais informações, consulte Abrir e salvar como caixas de diálogo.
Configuraçã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 a estrutura 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 a estrutura PRINTDLG . Para obter mais informações, consulte Caixa de diálogo Imprimir. Para exibir uma folha de propriedades Print em vez de uma caixa de diálogo Imprimir , use a função PrintDlgEx com a estrutura PRINTDLGEX . 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 do driver adicionais seguindo 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 para localizar 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ção ReplaceText e a estrutura FINDREPLACE . Para obter mais informações, consulte Caixas de diálogo Localizar e Substituir.
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 que o usuário filtre os nomes de arquivo exibidos. Use a função GetSaveFileName e a estrutura OPENFILENAME . Para obter mais informações, consulte Abrir e salvar como caixas de diálogo.

Embora uma caixa de diálogo Configuração de Impressão esteja disponível, ela foi substituída pela caixa de diálogo Configuraçã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 Configuraçã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 retornar. As caixas de diálogo Localizar e Substituir são modeless; a função retorna antes que a caixa de diálogo seja fechada. Se você usar as caixas de diálogo Localizar e Substituir, também deverá usar a função IsDialogMessage no loop de mensagem main do aplicativo para garantir que essas caixas de diálogo processem corretamente a entrada do teclado, como as teclas TAB e ESC.