Esimerkki - Kenttien aputoiminto

Johdanto

Kenttien aputoiminnon esimerkki osoittaa, kuinka voit org.eclipse.jface.fieldassist-tuen avulla antaa tehtäviin liittyvää apua tekstikentissä. Esimerkkivalintaikkunassa on kuvattu, kuinka voit määrittää kenttiin koristelut, jotka osoittavat pakolliset kentät, virheitä ja varoituksia sisältävät kentät sekä kentät, joissa on sisällönhallinnan aputoiminto. Esimerkissä on myös oletusasetussivu, jonka avulla voit määrittää koristelut ja sisällönhallinnan aputoiminnon tuen.

Esimerkin ajo

Kun lisäosa asennetaan, kenttien aputoiminto tulee näkyviin toimintopalkkiin. Valitse valikkovaihtoehto "Avaa kenttien aputoiminnon valintaikkuna..." Kenttien aputoiminnon valintaikkuna tulee näkyviin. Valintaikkunan kokoonpanoa voi määrittää esimerkin oletusasetusten avulla.

Kenttien aputoiminnon oletusasetusten määritys

Käytettävissä on kaksi oletusasetussivua, joiden avulla voit määrittää valintaikkunan toimintaa. Kenttien aputoiminnon esimerkkioletusasetukset -sivun avulla voit määrittää, kuinka valintaikkuna merkitsee kentät, joissa on virheitä tai varoituksia, pakolliset kentät ja sisällönhallinnan aputoiminnon. Kentät voi merkitä värien ja koristelujen yhdistelmien avulla. Tämä oletusasetussivu on tarkoitettu osoittamaan koristelujen määrityksen tarjoamia mahdollisuuksia. Se on suunnattu lähinnä ohjelmoijille, jotka haluavat kokeilla kenttien aputoimintoa. Se ei ole tarkoitettu esimerkiksi hyvästä oletusasetussivusta, koska käyttäjät voivat hallita merkintöjä.

Sisällönhallinnan aputoiminnon oletusasetukset -sivulla voit määrittää, kuinka sisällönhallinnan aputoiminto asennetaan valintaikkunan tekstikenttään. Useimmat kenttien aputoiminnon sovellusohjelmaliittymässä (ContentProposalAdapter) käytettävissä olevista valinnoista voi määrittää tällä sivulla. Huomaa, että on mahdollista määrittää sisällönhallinnan aputoiminto niin, että se haittaa käyttäjää. Jos esimerkiksi sisällönhallinnan aputoiminto määritetään aktivoitumaan automaattisesti kaikkien kirjainten kohdalla pitkän viiveen kera, tulos on haitallinen. Voi olla hämmentävää käyttää kumuloituvaa ehdotusten suodatusta, jos suodatusnäppäimiä ei välitetä takaisin ohjaukseen. Syy siihen, että sovellusohjelmaliittymä esitetään oletusasetussivulla, on, että kenttien aputoiminnon ohjelmoija voi kokeilla kaikkia mahdollisia yhdistelmiä. Ei ole tarkoitus, että mikään näistä yhdistelmistä päätyisi käyttäjän käyttöön, vaan että kehittäjä valitsee parhaan arvojen yhdistelmän, joka toteuttaa tietynlaisen sisällönhallinnan aputoiminnon.

Valintaikkunan käyttö

Esimerkkivalintaikkunassa on näkyvissä useita erilaisia kenttiä:

Esimerkki lähdekoodista

Esimerkin valintaikkuna ei ole kovin monimutkainen, vaan sen on tarkoitus osoittaa, kuinka ohjelmoida kenttien aputoiminto. Seuraavassa on joitakin lähdekoodiin liittyviä huomautuksia: