Implementando o recurso de ajuda em sistemas Windows Forms
Este artigo tem o objetivo de demonstrar o funcionamento de dois controles presentes na Toolbox do Visual Studio.Net para implementação de ajuda em nossos sistemas: HelpProvider e o ToolTip.
O controle HelpProvider é usado para associar um arquivo de ajuda ( arquivos .col /.chm /.htm /.html ) as aplicações Windows Forms ou associar uma ajuda para um determinado controle, da forma que quando o usuário digitar a tecla F1 sobre o controle no qual estiver o foco, será exibida um janela apresentando a ajuda especifica ao controle.
Figura 1 – Exemplo do HelpProvider.
O controle ToolTip é utilizado em aplicações Windows para inserir um texto a um determinado controle, exibindo uma dica quando o usuário arrastar o mouse sobre o mesmo.
Figura 2 – Exemplo do ToolTip.
Inicialmente vou demonstrar o uso do controle HelpProvider, para isso arraste o componente HelpProvider presente na tab Components da ToolBox para o seu formulário e o controle será incluído automaticamente no tray do formulário Windows.
Figura 3 – Componentes HelpProvider e ToolTip incluído na Tray do Formulário Windows.
Para definir um arquivo de ajuda, vá até a propriedade HelpNamespace do HelpProvider e informe o caminho do arquivo fonte de ajuda. Conforme já dito anteriormente, esse arquivo pode ser um arquivo .htm/.html/.chm .
Para abrir a seção específica da ajuda, especifique a propriedade ShowHelp on HelpProvider1 do formulário para True
Cada componente HelpProvider mantém referências para os controles associados. Pra definir a palavra-chave ou o tópico para ajuda, alteramos a propriedade HelpKeyword on HelpProvider1.
Figura 4 – Janela de propriedades do controle TextBox1 exibindo as propriedades associadas ao componente HelpProvider1.
Além da associação de um arquivo de ajuda, podemos associar uma ajuda específica a um controle usando o a propriedade HelpString on HelpProvider1. A string que você associar ao controle será exibida em uma janela quando o usuário pressionar a tecla F1 enquanto o controle tiver o foco. Você poderá configurar a propriedade HelpString para cada controle no formulário no qual desejar uma ajuda. Uma outra alternativa para exibir ajuda, é habilitar o botão de ajuda do formulário definindo a propriedade HelpButton. Quando o usuário clicar no botão (?) o cursor do seu mouse será alterado para exibir o (?). Clique no campo no qual a propriedade HelpString está definida e a janela de ajuda será exibida.
Agora irei demonstrar o uso do ToolTip. No Visual Basic .NET o controle ToolTip é usado para controlar as dicas para todos os controles em um formulário. Aarraste o componente ToolTip presente na tab Common Controls da ToolBox para o seu formulário e o controle será incluído automaticamente no tray do formulário Windows.
Figura 5 – Janela de propriedades do controle ToolTip.
Na figura acima temos as propriedades do controle ToolTip. Neste artigo vou abordar as seguintes propriedades:
§ Initial Delay: define o intervalo de tempo para que a dica da tooltip seja exibida;
§ IsBallon: define se o tooltip terá um formato de balão;
§ ToolTipIcon: define um ícone para o tooltip;
§ ToolTipTitle: define o título do tooltip.
Assim como o HelpProvider, o componente ToolTip mantém referências para os controles associados. Pra definir uma dica através do ToolTip, alteramos a propriedade ToolTip on ToolTip1 do controle desejado.
Figura 6 – Janela de propriedades do controle TextBox1 exibindo as propriedades associadas ao componente ToolTip1.
Chegamos ao final do artigo. Podemos verificar que o Visual Studio.Net possui controles que auxiliam o usuário na utilização dos nossos sistemas, e que se bem configurados podem evitar grandes dores de cabeça no suporte a usuários.
Até o próximo,
Regilan Meira