Największe korzyści z użycia pola sterującego FormText
płyną
w przypadku dodania do tekstu znaczników formatowania. Oczekiwanym znacznikiem głównym jest
znacznik form
. Może on mieć jeden lub kilka elementów potomnych typu <p>
lub <li>
. Każdy z tych elementów może zawierać normalny tekst, tekst ujęty w znaczniki
<b>
lub <span>
, obrazy, odsyłacze i pola sterujące SWT
.
Obrazy są deklarowane przy użyciu znacznika <img href="klucz obrazu"/>
(bez treści), a odsyłacze są określane za pomocą znacznika <a href="odsyłacz">tekst</a>
.
Niektóre znaczniki wymienione powyżej mają dodatkowe atrybuty. Znacznik
<a>
akceptuje atrybut nowrap="true"
w celu
blokowania zawijania odsyłacza do nowego wiersza. Znacznik <p>
może
przyjąć atrybut vspace="false"
(domyślnie wartość true
),
który dodaje odstęp między akapitami. Znacznik <li>
ma więcej atrybutów:
style - może mieć wartość: text
(tekst), bullet
(znacznik podpunktu) i image
(obraz). Wartością domyślną jest bullet
.
value - ten atrybut nie jest używany w przypadku określenia wartości
bullet
; jeśli atrybut style ma wartość text
, to zamiast znacznika podpunktu zostanie
wyświetlona wartość; jeśli atrybut style ma wartość image
, to wartość reprezentuje klucz w tabeli
obrazów, określający obraz do wyświetlenia zamiast znacznika podpunktu.
vspace - określenie tego atrybutu daje taki sam wynik, jak zastosowanie znacznika p
.
indent - określa liczbę piksli wcięcia tekstu.
bindent - określa liczbę piksli wcięcia znacznika podpunktu (ta wartość jest niezależna od wartości atrybutu indent - określając ją, należy sprawdzić, czy wcięcia się nie pokrywają).
Znaczniki wpływające na wygląd normalnego tekstu to <b>
(pogrubienie)
i <span>
. Ten drugi znacznik umożliwia zmienianie czcionki i/lub koloru
tekstu znajdującego się w obrębie znacznika. Można również dodać znaki końca wiersza przy użyciu znacznika
<br/>
(w języku XML nie można używać znacznika <br>
,
jak w języku HTML).
Od wersji 3.1 pole sterujące FormText
może być używane do dodawania
widgetów SWT do tekstu, odsyłaczy hipertekstowych i obrazów. Pola sterujące
SWT są tworzone jako elementy potomne pola sterującego FormText
,
dlatego pole sterujące FormText
można traktować jako pewnego rodzaju
menedżera układu, z instrukcjami określającymi położenie pola sterującego względem
tekstu osadzonego bezpośrednio w kodzie XML.
Pole sterujące FormText
nie jest odpowiedzialne za ładowanie obrazów,
czcionek, tłumaczenie odsyłaczy lub kolorów. Nie jest ono przeglądarką, więc aby
uniknąć problemów, należy przypisać zarządzanie obrazami i kolorami do innego elementu.
Atrybut href
umożliwia odwoływanie się do odsyłaczy i obrazów. W przypadku
odsyłaczy wartość tego atrybutu jest przekazywana do zdarzenia odsyłacza hipertekstowego, gdy
są powiadamiane funkcje nasłuchiwania. Obrazy muszą być rejestrowane w tekstowym polu sterującym
przy użyciu odpowiedniego klucza href. W ten sposób pole sterujące nie musi obsługiwać
ładowania obrazów, ponieważ znajdują się one w tabeli mieszającej i mogą zostać natychmiast
wyświetlone.
Kolory i czcionki są obsługiwane w podobny sposób. Kolory są obsługiwane przez przybornik,
więc wywołując metodę toolkit.getColors().createColor()
można przydzielać
ich dowolną liczbę, określając unikalny klucz i wartości RGB.
Aby podczas wyświetlania pole sterujące mogło używać kolorów, należy już tylko ustawić wszystkie
kolory, do których odwołania znajdują się w znaczniku span
.