Het besturingselement FormText
vervult ook een zeer nuttige functie bij het toevoegen
van indelingstags aan de tekst. De verwachte hoofdtag is form
.
Deze kan een of meer van de volgende tags op lager niveau bevatten: <p>
of <li>
.
De onderliggende items kunnen op hun beurt weer een of meer van de volgende soorten items bevatten: standaardtekst, tekst tussen <b>
- of
<span>
-tags, afbeeldingen, links en SWT
-besturingselementen. Afbeeldingen worden
gedeclareerd met de code <img href="afbeeldingssleutel"/>
(geen content), terwijl
links worden uitgedrukt als <a href="href">tekst</a>
.
Voor sommige hierboven vermelde tags kunt u aanvullende kenmerken opgeven. Zo kunt u voor de tag
<a>
het kenmerk nowrap="true"
opgeven als u wilt voorkomen dat de link
doorloopt op de volgende regel. Voor de tag <p>
kunt u het kenmerk vspace="false"
(true
is de standaardinstelling) opgeven om extra ruimte tussen alinea's in te voegen. Voor de tag <li>
kunt u de volgende kenmerken opgeven:
style (stijl) - geldige waarden zijn text
(tekst), bullet
(opsommingsteken)
en image
(afbeelding). De standaardinstelling is bullet
.
value (waarde) - niet gebruikt voor bullet
. Als style
text
is, wordt in plaats van een opsommingsteken een waarde gegenereerd.
Als style image
is, vertegenwoordigt value een sleutel in de afbeeldingstabel
van een afbeelding die moet worden weergegeven in plaats van een opsommingsteken.
vspace - hiervoor geldt hetzelfde als bij de tag 'p
'.
indent (inspringen) - het aantal pixels dat de tekst moet worden ingesprongen.
bindent - het aantal pixels dat het opsommingsteken moet worden ingesprongen. (Dit aantal wordt onafhankelijk van 'indent' verwerkt. Zorg ervoor dat u deze waarden niet met elkaar verwart.)
Tags waarmee u de presentatie van de platte tekst kunt beïnvloeden zijn <b>
(werkt zoals u
zou verwachten) en <span>
. Met de laatste tag kunt u het lettertype en/of de kleur
van de tekst tussen de begin- en eindtag wijzigen. Verder kunt u zachte regeleinden toevoegen met de
tag <br/>
(dit is XML-code, dus u kunt geen begintag <br>
gebruiken
zoals in HTML-code).
Vanaf release 3.1 kunt u de code FormText
gebruiken om SWT-widgets
van tekst, hyperlinks en afbeeldingen te combineren. SWT-besturingselementen worden gedefinieerd als onderliggende items
van FormText
, waardoor FormText
in feite een soort layoutmanager wordt,
met een instructie voor de locatie waar het besturingselement moet worden geplaatst ten opzichte van de tekst die
rechtstreeks in de XML is ingebed.
Een belangrijk algemeen aandachtspunt is dat FormText
niet verantwoordelijk is
voor het laden van afbeeldingen, lettertypen, kleuren of het omzetten van links. Dit is geen
browser en het is dan ook raadzaam om deze zaken gescheiden te houden, en afbeeldingen en kleuren
elders toe te wijzen en te beheren. Zowel bij links als afbeeldingen kan het kenmerk 'href
'
worden gebruikt voor verwijzingen. Bij links moet de waarde van dit kenmerk worden aangeleverd
in de hyperlinkevent wanneer listeners worden geïnitieerd. Afbeeldingen moeten worden vastgelegd
in het tekstbesturingselement met behulp van de bijbehorende 'href'-sleutel. Op deze manier hoeven
de afbeeldingen niet door het besturingselement te worden geladen. Deze bevinden zich dan al in de
hashtabel en kunnen onmiddellijk worden weergegeven.
Voor kleuren en lettertypen geldt ongeveer hetzelfde principe. Kleuren worden al afgehandeld
door de toolkit, dus u kunt zo veel kleuren toepassen als u wilt door een unieke sleutel en
RGB-waarden te gebruiken voor het aanroepen van toolkit.getColors().createColor()
.
De enige kleuren die u hierna nog hoeft in te stellen zijn de kleuren waarnaar wordt verwezen in de 'span
'-tags,
zodat deze tijdens de rendering van het besturingselement kunnen worden gebruikt.