Eksempel - Field Assist

Innledning

Field Assist-eksempelet viser hvordan du bruker støtten i org.eclipse.jface.fieldassist til å gi oppgaveassistanse i tekstfelt. En eksempeldialogboks viser hvordan du konfigurerer feltdekorasjoner til å vise obligatoriske felt, felt med feil og advarsler og felt som gir innholdshjelp. Eksempelet inneholder også en preferanseside som gjør det mulig for deg å konfigurere dekorasjonene og innholdshjelpstøtten.

Kjøre eksempelet

Når plugin-modulen installeres, skal du kunne se en Field Assist-handling på handlingslinjen. Velg menypunktet "Open Field Assist Dialog..." Dermed åpnes dialogboksen Field Assist. Dialogboksen kan konfigureres med eksempelpreferanser.

Definere Field Assist-preferanser

Det er to preferansesider der du kan definere virkemåten til dialogboksen. På siden Field Assist Example Preferences kan du konfigurere hvordan dialogboksen annoterer felt med feil og advarsler, obligatoriske felt og innholdshjelp. En kombinasjon av farger og dekorasjoner kan brukes til å annotere feltene. Denne preferansesiden er ment å vise hva som er mulig når du konfigurerer dekorasjoner. Det er beregnet på programmerere som prøver ut felthjelp (Field Assist), snarere enn å fungere som eksempel på en god preferanseside for å la sluttbrukere kontrollere annotasjonene.

På siden Content Assist Preferences kan du konfigurere hvordan innholdshjelpen skal installeres, i dialogboksens tekstfelt. De fleste alternativene i APIet Field Assist (ContentProposalAdapter) kan konfigureres på denne siden. Merk at det er mulig å konfigurere innholdshjelpen på uønskede måter. For eksempel er det ikke ønskelig å definere innholdshjelpen til å selvaktiveres på alle tegn med en lang forsinkelse. Det kan være forvirrende å bruke kumulativ forslagsfiltrering når filternøklene ikke spres tilbake til kontrollen. Formålet med å eksponere APIet på preferansesiden er å gjøre det mulig for felthjelpprogrammereren å prøve alle mulige kombinasjoner. Det er ikke meningen av noen av disse preferansene skal eksponeres for sluttbrukeren, men at utvikleren skal velge den beste kombinasjonen av disse verdiene og sørge for en viss stil på innholdshjelpen.

Bruke dialogboksen

Eksempeldialogboksen viser flere forskjellige typer felt:

Eksempel på kildekode

Eksempeldialogboksen er ikke spesielt kompleks, men den er ment å vise hvordan felthjelp programmeres. Her er noen merknader om kildekoden: