Redigeringsprogrammer med flere sider for skjemaer

Brukergrensesnittskjemaer inneholder grunnleggende støtte for redigeringsprogrammer med flere sider, som du kan bygge på.

Du bør starte byggingen av et redigeringsprogram med flere sider for brukergrensesnittskjemaer ved å utvide FormEditor:

public class SimpleFormEditor extends FormEditor {

	public SimpleFormEditor() {
	}

	protected FormToolkit createToolkit(Display display) {
		// Create a toolkit that shares colors between editors.
		return new FormToolkit(ExamplesPlugin.getDefault().getFormColors(
				display));
	}

	protected void addPages() {
		try {
		addPage(new FreeFormPage(this));
		addPage(new SecondPage(this));
		addPage(new ThirdPage(this));
		addPage(new MasterDetailsPage(this));
		addPage(new PageWithSubPages(this));
		}
		catch (PartInitException e) {
			//
		}
	}

	public void doSave(IProgressMonitor monitor) {
	}

	public void doSaveAs() {
	}

	public boolean isSaveAsAllowed() {
		return false;
	}

En enkel måte å komme i gang på, er ved å opprette sider og legge dem til som ovenfor. Hver side må implementere FormPage og overstyre metoden createFormContent(IManagedForm managedForm). Det er allerede opprettet et styrt skjema på siden, og du må opprette innhold i det dette skjemaet og dessuten registrere enhver skjemadel som skal inngå i den styrte livssyklusen.

I tillegg til å lage sider kan du legge til ett eller flere tekstredigeringsprogrammer som et alternativ til ubehandlet kilde for sidene for grafisk brukergrensesnitt. Kall opp metoden "addPage(IEditorPart, IEditorInput input)" i superklassen.

Anbefalte retningslinjer for redigeringsprogrammer med flere sider for Eclipse-skjemaer

Et skjemabasert redigeringsprogram med flere sider kan skrives på flere måter. Hvordan dette gjøres avhenger av typen innhold du redigerer, og av brukernes ferdigheter. Du kan enten:

  1. Hvis det er sjelden den gjennomsnittlige brukeren benytter redigeringsprogrammet, det er vanskelig å redigere den ubehandlede kilden manuelt eller den er kompleks, brukerne ikke er spesielt tekniske osv, bør du lage komplette sider som kan redigere hver enkelt del av innholdet uten å gå til den ubehandlede kilden. Med denne metoden brukes kildesidene bare ved tilfeldig validering og ikke ved vanlig arbeid. I så fall kan du bruke et grunnleggende tekstredigeringsprogram. Skjemaredigeringsprogrammet for PDE-utvidelsespunktet tilhører denne gruppen.

  2. Hvis brukerne er mer teknisk kyndige, ikke har problemer med å redigere filen manuelt, men gjerne vil ha litt hjelp av og til, bør du vurdere en blandingsløsning der du utarbeider et godt kilderedigeringsprogram som har alle tilleggsprogrammer, for eksempel trinnvis disposisjon, innholdshjelp, syntaksutheving osv. Legg så til kompleks, verdiøkende funksjonalitet på skjemasidene som det er vanskelig å hente fra kilden. Erfaring tilsier at det er vanskelig å overbevise erfarne brukere om å bytte fra kilderedigering hvis verdiøkningen er marginal eller usikker. Funksjoner som bare er tilgjengelig på sidene for grafisk brukergrensesnitt og som har svært høy kvalitet, tas imidlertid raskt i bruk.

Det kan være vanskelig å opprette et redigeringsprogram med flere sider sammen med en blanding av grafisk brukergrensesnitt og kildesider. Det kreves en god modell for underliggende innhold for å imøtekomme brukerens ønske om å bytte sider ofte. Modellen bør være direkte knyttet til underliggende dokument(er) slik at den er synkronisert både når brukeren oppgir teksten direkte, og når de endrer den strukturelt via sidene for grafisk brukergrensesnitt (ikke glem de indirekte endringene som oppstår i forbindelse med andre arbeidsbenkhandlinger, mens redigeringsprogrammet fortsatt kjøres).