Usando Tooltip

ASP.NET

Saturday, January 1, 2011

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

Referência: 1.1

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)

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)

Referência: 1.3

Configuração do componente:

Tipo: ToolTip

Name: toolTipMensagemDeErro

IsBalloon: True (aparecer como balão)

TooltipTitle: (deixa em branco)

Essas foram às 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)