A hiperligação é um widget personalizado criado para complementar o widget de SWT padrão definido quando é utilizado no contexto dos Formulários de UI. A hiperligação é um controlo de texto seleccionável que funciona como a hiperligação de um browser da Web:
Hyperlink link = toolkit.createHyperlink(form.getBody(), "Click here.", SWT.WRAP); link.addHyperlinkListener(new HyperlinkAdapter() { public void linkActivated(HyperlinkEvent e) { System.out.println("Link activated!"); } }); link.setText("Ligação exemplo");
As hiperligações desencadeiam objectos HyperlinkEvent
quando os utilizadores interagem com elas. Ao adicionar um HyperlinkListener
, os clientes podem capturar quando o rato entra, quando o rato sai da ligação, e quando a activa (quer por clique do rato quer pela tecla 'Enter').
As hiperligações criadas pelo kit de ferramentas do formulário são automaticamente inseridas num grupo de hiperligações. O HyperlinkGroup
gere as propriedades comuns das hiperligações como, por exemplo, cores de primeiro plano normais de à passagem do rato, estilo de sublinhados, etc., para todas as ligações que pertençam ao grupo.
Dado que muitas hiperligações estão combinadas com uma imagem pequena, os
Formulários de UI disponibilizam uma subclasse chamada
ImageHyperlink
que adiciona a capacidade de combinar texto e
imagem num único controlo clicável. Esta classe também pode ser utilizada quando for necessária uma imagem de hiperligação (sem texto). Se a imagem não estiver definida, a ImageHyperlink
comporta-se de modo idêntico à Hyperlink
.