Indelingsmarkup ontleden

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:

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.