Voorbeeld - Veldhulp

Inleiding

In het voorbeeld van veldhulp ziet u hoe u de ondersteuning van org.eclipse.jface.fieldassist kunt gebruiken om taakbegeleiding in tekstvelden in te zetten. Door middel van een voorbeelddialoogvenster leert u hoe u velddecoraties kunt instellen om verplichte velden, velden met fouten en waarschuwingen en velden met contenthulp aan te duiden. Bovendien bevat het voorbeeld een voorkeurenpagina waarmee u de decoraties en de ondersteuning voor contenthulp kunt configureren.

Het voorbeeld uitvoeren

Als de plugin wordt geïnstalleerd, wordt de actie FieldAssist op de werkbalk afgebeeld. Kies in het menu de optie "Dialoogvenster Veldhulp openen..." Het dialoogvenster wordt nu geopend. U kunt het venster configureren met behulp van de voorbeeldvoorkeuren.

Voorkeuren voor veldhulp instellen

Er zijn twee voorkeurenpagina's verstrekt waarmee u het gedrag van het dialoogvenster kunt instellen. Op de pagina Voorbeeldvoorkeuren voor veldhulp kunt u aangeven hoe velden met fouten en waarschuwingen, verplichte velden en velden met contenthulp worden geannoteerd. Voor de annotatie van velden kunt u een combinatie van kleuren en lettertypen gebruiken. Deze voorkeurenpagina dient om een indruk te geven van de mogelijkheden wat het configureren van decoraties betreft. De voorkeuren zijn meer bestemd voor programmeurs die de veldhulp testen. Beschouw deze pagina niet als een goed voorbeeld van een voorkeurenpagina voor het configureren van de annotaties door eindgebruikers.

Op de pagina Voorkeuren voor contenthulp kunt u aangeven hoe contenthulp op tekstvelden wordt toegepast. De meeste van de opties die in de veldhulp-API (ContentProposalAdapter) beschikbaar zijn ingesteld, kunnen op deze pagina worden geconfigureerd. U kunt de contenthulp zodanig instellen dat deze de gebruiker tot last is. Het is bijvoorbeeld niet wenselijk contenthulp na een lange vertraging automatisch voor alle tekens te activeren. Cumulatieve suggestiefilters kunnen verwarrend zijn als de filtertoetsen niet naar de besturingsfunctie worden gedistribueerd. De API is in de voorkeurenpagina geïmplementeerd, zodat programmeurs van veldhulp alle mogelijke combinaties kunnen uitproberen. Deze voorkeuren zullen niet gauw voor de eindgebruiker beschikbaar worden gesteld. In plaats hiervan kiest de ontwikkelaar de beste combinatie van deze waarden om een bepaalde contenthulpstijl te verstrekken.

Het dialoogvenster gebruiken

In het voorbeelddialoogvenster treft u diverse veldsoorten aan:

Voorbeeldbroncode

Het voorbeelddialoogvenster is niet heel erg ingewikkeld, maar dient om te demonstreren hoe de programmering van veldhulp in zijn werk gaat. Enkele opmerkingen met betrekking tot de broncode: