Usando ToolTip

Este artigo apresenta uma funcionalidade que quase ninguém usa no dia a dia nas aplicações Windows Forms, o Tooltip.

por Mauricio Junior

Olá pessoal, gostaria de apresentar uma funcionalidade “legalzinha”, mas que quase ninguém usa no dia a dia nas aplicações Windows Forms. Esse componente exibe mensagens bonitas aos usuários.

Requisito:

Framework 3.5 SP 1

Ferramenta: Visual Studio.NET 2008

Linguagem: C#.NET

Conhecimento básico na ferramenta de desenvolvimento e linguagem

Versão do Tooltip: 2.0

O exemplo que vou mostrar junto ao artigo é apenas um sistema em login que gera a mensagem ao usuário. A partir desse exemplo, pode ser feito vários outros.

O primeiro passo foi: criar um projeto do tipo Windows Forms. Depois criei uma tela com usuário e senha, junto com ela veio um botão para se autenticar no sistema. (Referência 1.2)

Como mostrado na referência 1.1, o controle está na toolbox da ferramenta Visual Studio.NET 2008. Usei o famoso drag in drop (arrastando) para o meu formulário criado. (Referência 1.3)

Configuração do componente:

Tipo: ToolTip

Name: toolTipMensagemDeErro

IsBalloon: True (aparecer como balão)

TooltipTitle: (deixa em branco)

Essas foram as configurações que alterei no componente.

O próximo passo foi criar uma classe com um método responsável pelo aparecimento da mensagem, ou seja, uma classe genérica que, ao precisar mandar mensagem, a chamo passando os valores necessários.

Classe ToolTipHelper

public static class ToolTipHelper     {         public static void ShowToolTip(out ToolTip toolTip, Control control, string title, string message)         {             toolTip = new ToolTip();             toolTip.IsBalloon = true;             toolTip.ToolTipIcon = ToolTipIcon.Error;             toolTip.ToolTipTitle = title;             toolTip.Show(string.Empty, control, 0);             toolTip.Show(message, control, control.Width/2, control.Height, 5000);         }     }

Code 1.1

O método é do tipo público, estático (não precisa gerar uma instância), não retorna valor algum, pois é (void), mas, recebe quatro parâmetros de entrada. Um parâmetro, mais especificamente o primeiro é out, de saída.

Dentro do método, gerei uma instância do Tooltip() na primeira linha. Coloquei para virar balão, coloquei o ícone do componente; ToolTipIcon.Error, coloquei um título e mandei a mensagem. Na última linha, calculei a altura do controle, assim a posição do balão fica correta de acordo com o componente.

Voltando ao formulário, cliquei duas vezes no botão e no catch chamo o método criado anteriormente. (Code 1.2)

catch (WebserviceConfigurationException) { ToolTipHelper.ShowToolTip(out toolTipMensagemDeErro, btnSubmit, "Não autorizado", "Falha de logon no Access Manager: NDS não enviou token de autenticação"); }

Code 1.2

Testando o código

Vou testar o código feito até agora. Veja como ficou executando o programa. (Referência 1.4)

Bom, espero que tenham gostado do artigo e que tenha te ajudado de forma dinâmica. Qualquer dúvida, favor entrar em contato ou postar comentário.

Mauricio Junior