Classe ColorDialog em C#
Um controle ColorDialog é utilizado para selecionar uma cor de uma paleta de cores disponível, e também para definir cores personalizadas. Essas cores podem então serem aplicadas em outros objetos do formulário, dinamicamente.
É possível criar um controle ColorDialog usando o designer de formulários durante o design da aplicação, ou então usando a classe ColorDialog no código em tempo de execução (runtime), dinamicamente.
Modo de Design
Para criar um ColorDialog em modo de design, simplesmente arraste o controle apropriado para um form. Você encontrará o ColorDialog na Toolbox -> Dialogs:
Modo Run-time
Para criar um controle a ColorDialog em tempo de execução basta criar uma instância da classe ColorDialog, ajustar suas propriedades e adicionar a classe aos controles do Form.
Primeiro criamos a instância da classe ColorDialog. O trecho de código a seguir permite criar um objeto de controle ColorDialog de nome cdgCaixaCores:
ColorDialog cdgCaixaCores = new ColorDialog();
A seguir temos algumas das propriedades que podem ser cofiguradas no controle em runtime:
- AllowFullOpen – Habilitar ou desabilitar o botão Definir Cores Personalizadas
- Color – A cor selecionada no controle.
- FullOpen – O valor true significa que a seção Definir Cores Personalizadas será exibida por padrão ao abrir o ColorDialog.
- SolidColorOnly – Indica se a caixa restringirá a escolha de cores sólidas pelos usuários.
- AnyColor – Se a caixa mostrará todas as cores definidas no conjunto de cores básicas.
Exemplos de configuração dessas propriedades:
cdgCaixaCores.AnyColor = true; // Caixa mostra todas as cores definidas cdgCaixaCores.SolidColorOnly = false; // Usuário poderá escolher cores não sólidas cdgCaixaCores.Color = Color.Red; // Cor vermelha selecionada no controle.
Usando o controle ColorDialog
Crie um novo projeto para Windows Forms no Visual Studio e insira no formulário os seguintes controles:
- Botão com propriedade Name igual a btnCorFundo; Texto: Cor de Fundo
- Botão com propriedade Name igual a btnCorTexto; Texto: Cor do Texto
- ColorDialog com propriedade Name igual a cdgCaixaCores
- TextBox com propriedade Name igual a txtCores; Fonte tamanho 16.
Veja nosso projeto na figura a seguir:
Vamos programar os botões:
// Evento Click do Botão Cor de Fundo - usando o controle da ToolBox: if (cdgCaixaCores.ShowDialog() == DialogResult.OK) { txtCores.BackColor = cdgCaixaCores.Color; // Muda a cor de fundo da caixa de texto. } // Evento Click no Botão Cor do Texto (criando um ColorDialog dinamicamente e configurando): ColorDialog cdgCores2 = new ColorDialog(); cdgCores2.AllowFullOpen = false; cdgCores2.AnyColor = true; cdgCores2.SolidColorOnly = false; cdgCores2.Color = Color.Blue; if (cdgCores2.ShowDialog() == DialogResult.OK) { txtCores.ForeColor = cdgCores2.Color; // Alterando a cor do texto digitado na caixa de texto }
Para testar, execute o programa, digite uma frase na caixa de texto e clique nos botões para alterar a cor de fundo e de fonte, selecionadas no caixa de diálogo de cores:
1 – Abrindo o programa e digitando uma frase na caixa de texto:
2 – Clique no botão Cor de Fundo para selecionar uma cor para o background da caixa de texto:
3 – Após selecionar a cor e clicar em OK, a cor será aplicada ao fundo da caixa de texto. Clique então no botão Cor do Texto para selecionar uma cor para a frase digitada:
4 – Clique em OK na caixa de diálogo de cor e verifique que a formatação desejada foi aplicada na caixa de texto:
É isso aí! No próximo tutorial vamos aprender a utilizar mais controles para Windows Forms. Até!