Odsyłacz hipertekstowy jest niestandardowym widgetem utworzonym w celu uzupełnienia standardowego zestawu widgetów SWT używanych w kontekście formularzy interfejsu użytkownika. Odsyłacz hipertekstowy jest wybieralnym tekstowym polem sterującym, którego zachowanie jest takie samo, jak odsyłacza hipertekstowego przeglądarki WWW:
Hyperlink link = toolkit.createHyperlink(form.getBody(), "Kliknij tutaj.", SWT.WRAP); link.addHyperlinkListener(new HyperlinkAdapter() { public void linkActivated(HyperlinkEvent e) { System.out.println("Odsyłacz aktywowany!"); } }); link.setText("Przykładowy odsyłacz");
Wybrane przez użytkowników odsyłacze hipertekstowe wyzwalają obiekty
HyperlinkEvent
. Dzięki dodaniu klasy HyperlinkListener
, klienci
mogą przechwytywać zdarzenia umieszczenia wskaźnika myszy na odsyłaczu i jego usunięcia z
odsyłacza oraz aktywowania odsyłacza przez kliknięcie myszą lub naciśnięcie klawisza Enter.
Odsyłacze hipertekstowe utworzone przez przybornik formularza są automatycznie wstawiane
do grupy odsyłaczy hipertekstowych. Klasa HyperlinkGroup
zarządza wspólnymi
właściwościami odsyłaczy hipertekstowych, jak kolory pierwszego planu (normalny i gdy na odsyłaczu
zostanie umieszczony wskaźnik myszy), style podkreślenia itp. wszystkich odsyłaczy należących do grupy.
Ponieważ wiele odsyłaczy hipertekstowych jest łączonych z niewielkimi obrazami, formularze
interfejsu użytkownika udostępniają podklasę ImageHyperlink
dodającą możliwość
łączenia tekstu i obrazu w jedno pole sterujące, które można kliknąć. Ta klasa może być także
używana w przypadku konieczności użycia tylko obrazu odsyłacza hipertekstowego (bez tekstu).
Jeśli obraz nie zostanie określony, podklasa ImageHyperlink
zachowuje się
tak samo, jak klasa Hyperlink
.