Nejúčinnější využití nalezne obslužný prvek FormText
při vkládání formátovacích značek do textu. Očekávána je kořenová značka form
.
Může mít jeden nebo více podřízených prvků, přičemž jde buď o <p>
, nebo o <li>
.
Každý z těchto prvků může obsahovat normální text, text mezi značkami <b>
nebo
<span>
, obrázky, odkazy a obslužné prvky SWT
. Obrázky se deklarují
s použitím <img href="klíč obrázku"/>
(bez obsahu), odkazy
se deklarují s použitím <a href="href">text</a>
.
Některé z výše uvedených značek mají přídavné atributy. Značka
<a>
akceptuje nowrap="true"
pro zablokování zalomení odkazu do nového řádku. Značka <p>
akceptuje atribut
vspace="false"
(výchozí hodnota true
), která mezi odstavce vkládá mezeru. Značka<li>
má více atributů:
style - Styl může mít hodnotu text
, bullet
nebo image
(výchozí hodnotou je bullet
)
value - Nepoužívá se pro bullet
; je-li stylem
text
, hodnota bude vykreslena místo odrážky;
je-li stylem image
, hodnota je klíčem tabulky obrázků pro obrázek, který má být vykreslen místo odrážky
vspace - Totéž jako u značky 'p
'.
indent - Počet pixelů odsazení textu
bindent - Počet pixelů odsazení odrážky (toto číslo závisí na 'indent' - nesmějí se překrývat)
Značky ovlivňující vzhled normálního textu jsou <b>
(běžná funkce) a <span>
. Druhá značka umožňuje měnit písmo anebo barvu textu uvnitř značky. Dále lze vkládat měkká zalomení řádku s použitím značky
<br/>
(povšimněte si, že zde jde o XML, tj. nemůžete použít otevírací <br>
jako v HTML).
Od verze 3.1 lze použít FormText
ke kombinaci prvků widget SWT s textem, hypertextovými odkazy a obrázky. Obslužné prvky SWT se vytvářejí jako podřízené prvky
FormText
, který použije FormText
ve funkci správce rozvržení a poskytne mu pokyn k umístění obslužného prvku, který se týká textu vloženého přímo do XML.
Sledovat lze tento společný rys: FormText
neodpovídá za
načítání obrázků, písem ani za řešení odkazů či barev. Nejde o prohlížeč a je vhodné oddělovat problémy a jednoduše přiřazovat obrázky a barvy řízené z jiného místa. Odkazy i obrázky mají atribut'href
', jehož prostřednictvím na ně lze odkazovat. Pro odkazy hodnotu tohoto atributu poskytne událost hypertextového odkazu po upozornění listenerů. Obrázky musejí být registrovány textovým obslužným prvkem s použitím odpovídajícího klíče 'href'. Obslužný prvek se tak nepotřebuje starat o načítání obrázků - má je v hašovací tabulce a může je okamžitě vykreslit.
Podobný přístup byl použit pro barvy a písma. Barvy jsou již zpracovány sadou nástrojů, a proto je můžete přiřazovat podle potřeby s použitím jedinečného klíče a hodnot RGB voláním metody toolkit.getColors().createColor()
.
Zbývá již pouze nastavit všechny barvy odkazované ve značce 'span
' tak, aby je obslužný prvek byl schopen použít při vykreslování.