Vitor Oliveira Segunda-feira, 10 de outubro de 2005

Common Dialog Box

O controle Common Dialog Box apresenta caixas de diálogos de aparência profissional dentro de seu aplicativo, para que o usuário possa fazer seleções em caixas de diálogo conhecidas e para que pareça que você passou horas em seu aplicativo, imitando as caixas de diálogo encontradas nos aplicativos Windows mais vendidos, como o Outlook.

O que Faz o controle Common Dialog Box?

- O controle Common Dialog Box talvez seja o controle mais poderoso disponível, devido à sua capacidade de se transformar em uma das diversas caixas de diálogo que você já viu em aplicativos Windows.

- O controle Combo Box é multifacetado, pois ele atua como um dos três tipos de caixas de combinação, dependendo da propriedade Style definida.

- A caixa de diálogo comum ultrapassa em muito a capacidade da caixa de combinação para assumir diferentes aparências e atender a diferentes propósitos.

Incluindo o controle Common Dialog Box:

Selecione o componente Microsoft Common Dialog Control 6.0.

Observações:

- Quando você colocar uma caixa de diálogo comum em um form, não poderá redimensioná-la, pois o controle, assim como o controle Timer, não aparecerá no form durante a execução.

- Configurar o controle CommonDialog para mostrar a caixa de diálogo Font é quase tão fácil quanto configura-lo para desempenhar funções relacionadas com arquivos. Na verdade, você pode utilizar o mesmo controle para cuidar de funções relativas a arquivos, fontes, cores e impressoras.

- Para apresentar uma caixa de diálogo em particular, seu aplicativo precisa especificar um dos seguintes métodos:

ShowOpen
ShowSave
ShowColor
ShowPrinter
ShowFont
Show Help

Veja a figura:

Método ShowOpen:

Se você vai trabalhar com um arquivo de dados, poderia apresentar a caixa de diálogo File Open, ilustrada na figura abaixo:

- Você com certeza já viu a caixa de diálogo File Open em muitos aplicativos Windows

Veja abaixo o código:

Baixar arquivos

Método ShowSave

O controle Common Dialog Box também apresenta uma caixa de diálogo relacionada a arquivo semelhante, que produz uma caixa de diálogo Salvar Como. O usuário também estará familiarizado com essa caixa de diálogo. Seu aplicativo pode controlar o tipo de arquivos apresentador (definindo um valor de tipo de extensão de nome de arquivo apropriado).

- Para exibir a caixa de diálogo Salvar Como basta chamar o método ShowSave do controle CommonDialog.

Método ShowColor

A caixa de diálogo Cor do controle CommonDialog permite ao usuário selecionar cores que podem ser usadas com a finalidade de definir a cor do texto ou a cor do plano de fundo dos seus formulários e controles. O usuário tem a opção de escolher uma das cores padrão, ou então pode criar e selecionar uma cor personalizada.

A tarefa de configurar o controle CommonDialog para a escolha de cores é basicamente idêntica ao trabalho de configura-lo para a seleção de fontes. É necessário apenas definir a propriedade Flags com o valor da constante VbCCRGBInit, e depois chamar o método ShowColor. Veja abaixo:

- Veja a caixa de diálogo Cor abaixo:

Método ShowPrinter

A caixa de diálogo Imprimir do controle CommonDialog permite ao usuário selecionar a impressora que será utilizada em um trabalho de impressão, e também especificar opções para o processo de impressão. Essas opções incluem a possibilidade de especificar a impressão de todas as páginas, de um intervalo de páginas, ou de uma seleção. Existe ainda uma opção para a especificação do número de cópias a serem impressas, bem como uma opção para impressão em um arquivo.

Para exibir a caixa de diálogo Imprimir basta chamar o método ShowPrinter do controle CommonDialog. Não é necessário definir nenhum sinalizador(flag) antes da chamada. A caixa de diálogo Imprimir básica está ilustrada na Figura abaixo:

Método ShowFont

O primeiro passo na utilização do controle CommonDialog para manipular a seleção de fontes consiste em definir um valor para a propriedade Flags. Essa propriedade informa ao controle CommonDialog se você pretende mostrar fontes de tela, fontes da impressora ou ambas.

A propriedade Flags pode ser definida de acordo com uma das três constantes especificadas na tabela a seguir:

- Se não definir um valor para a propriedade Flags, você receberá uma mensagem de erro informando que não existe nenhuma fonte instalada.

Depois de definir a propriedade Flags, você pode abrir a caixa de diálogo Font a partir do seu código, utilizando o método ShowFont.

A figura mostra a caixa de diálogo Font apresentada ao usuário.

As informações sobre as fontes escolhidas a partir do controle CommonDialog são guardadas nas propriedades do controle. Veja na tabela abaixo as propriedades do controle e os atributos de fontes que cada uma dessas propriedades tem de controlar.

As Propriedades do Controle Armazenam Atributos de Fontes

Método ShowHelp

A última caixa de diálogo que o controle Common Dialog Box pode apresentar é uma janela Help. A janela Help é vinculada a um arquivo de ajuda que você gera. Entretanto, caixa de diálogo Help do controle Common Dialog Box poderá produzir a caixa de diálogo de front-end com que seus usuários interagem.

Por que caixas de diálogo comuns?

Você não precisa usar o controle Common Dialog Box.

Uma caixa de diálogo nada mais é do que um formulário contendo controles.Você pode inserir um novo formulário em qualquer projeto (com Project | Add Form) e colocar os controles que desejar nele. A caixa de ferramentas inclui vários controles relacionados a arquivos, como o controle File List Box , que você pode colocar no formulário.

- O controle Common Dialog Box certifica-se de que suas caixas de diálogo, que imitam aquelas encontradas em numerosos outros aplicativos, tenham desempenho igual a estas.

- Usar o controle Common Dialog Box e ajustar algumas propriedades é muito mais simples e lhe proporciona muito mais tempo do que você teria se criasse essas caixas de diálogo desde o início.

Conclusão

Hoje vimos a respeito do controle Common Dialog Box.

Dependendo das propriedades que você define e dos métodos que utiliza para apresentar o controle, seus usuários verão uma de várias caixas de diálogo. As caixas de diálogo se parecem e atuam exatamente como as outras caixas de diálogo profissionais do Windows. O controle permite que você inclua poderosas caixas de diálogo com apenas algumas linha de código.

Valeu pessoal, abraços!