Skjemadefinisjonsside

Om denne siden

På denne skjemasiden kan du redigere strukturen og egenskapene til skjemaobjektene som utgjør det redigerte skjemaets grammatikk.

Strukturen til skjemaobjektene redigeres i seksjonen Utvidelsespunktelementer. Denne seksjonen utgjør øvre venstre del av redigeringsområdet.

Egenskaper for skjemaobjekter redigeres i <skjemaobjektenes> Detaljer-seksjoner. Disse seksjonene aktiveres i øvre høyre del av redigeringsområdet, avhengig av typen skjemaelement du velger i seksjonen Utvidelsespunktelementer.

Sideseksjoner

Denne siden består av følgende seksjoner:

Seksjonen Utvidelsespunktelementer

I denne seksjonen kan du gjøre følgende:

Denne seksjonen er tilgjengelig direkte gjennom skjemasiden Skjemadefinisjon.

Felt i seksjonen Utvidelsespunktelementer

Bruk visningsfeltet til utvidelsespunktelementet til å gjøre følgende:

Dette visningsprogrammet inneholder følgende noder:

Elementer:

Kompositører:

Attributter:

Eksempel: Utvidelseselementet angir at en sekvens av ett eller flere snarveiselementer er tillatt, siden de er lovlige underordnede. En elementreferanse brukes til å representere snarveiselementet. En sekvenskompositør brukes til å representere en sekvens av elementer.

Seksjon 2 for utvidelsespunktelementer

Eksempel: Snarveiselementet angir at et beskrivelses- eller kategori-element er tillatt, siden det er lovlig underordnet. Elementreferanser brukes til å representere beskrivelses- og kategori-elementer. En valgkompositør brukes til å representere et valg av elementer.

Seksjon 1 for utvidelsespunktelementer

Seksjonshandlinger for utvidelsespunktelementer

Klikk på Legg til element hvis du vil legge til en ny global deklarasjon til utvidelsespunktskjemaets grammatikk. Denne handlingen er tilgjengelig når en node er valgt. Merk: Elementdeklarasjonsrekkefølgen er ikke viktig.

Klikk på knappen Legg til attributt for å legge til et ny lokal attributtdeklarasjon i et valgt element i utvidelsespunktskjemaets grammatikk. Denne handlingen er tilgjengelig for alle valgte elementnoder unntatt utvidelseselementnoden. Utvidelseselementnoden har alltid samme attributter: id, navn, punkt. Merk: Attributtdeklarasjonsrekkefølgen er ikke viktig.

Du kan slette et skjemaobjekt fra utvidelsespunktskjemaets grammatikk ved å høyreklikke på en valgt node og velge Slett. Denne handlingen er tilgjengelig for alle valgte noder unntatt utvidelseselementnoden. For ikke-delte skjemaer er utvidelseselementnoden det spesielle rotelementet som brukes til å definere inngangspunktet til det redigerte skjemaets grammatikk. En utvidelse som er definert i redigeringsprogrammet for plugin-manifest, må bruke et overordnet utvidelseselement til å spesifisere sin XML-relaterte koding.

Slik oppgir du at et elements underordnede består av en sekvens eller et valg av andre elementer i utvidelsespunktskjemaets grammatikk:

  1. Velg og høyreklikk på elementnoden du vil definere som overordnet element.
  2. Velg Ny(tt) > Kompositør > Sekvens hvis du vil definere en sekvens av elementer. Velg Ny(tt) > Kompositør > Valg hvis du vil definere et valg av elementer.
  3. Velg og høyreklikk på den nye kompositørnoden.
  4. Velg det elementet fra undermenyen Ny(tt) > Referanse som du vil definere som underordnet under det overordnede elementet. Undermenyen Referanse fylles ut med alle elementer som er deklarert globalt, i utvidelsespunktskjemaets grammatikk.
  5. Gjenta trinn (3) og (4) for å spesifisere underordnede elementer. Hvis en sekvenskompositør er spesifisert, innebærer det å spesifisere tilleggselementer i sekvensen. Hvis en valgkompositør er spesifisert, innebærer dette å spesifisere tilleggselementer som valg.

Merk: For å oppgi at et element er underordnet under et annet element, må det overordnede elementet alltid bruke en foreløpig sekvens- eller valg-kompositør. Kompositørnodene er forbindelsesnoder, mens elementreferansenodene er bladnoder. Kompositørnoder bør derfor alltid angi minst en underordnet elementreferansenode.

Merk: Sekvens- og valg-kompositører kan nestes et hvilket som helst antall ganger for å lage mer komplekse grammatikker.

Merk: En grammatikk kan ikke inneholde selvrefererende sykluser. Den mest grunnleggende formen for forbudt syklus forekommer når element A krever element B som underordnet og element B krever element A som underordnet.

Du kan oppgi at et element ikke har noen underordnede og tillater at tekst spesifiseres innenfor dets XML-koder for start og slutt (tegninnhold) ved å la elementets struktur være som den er, og ikke legge til attributter, kompositører eller elementreferanser i det (elementinnhold). Merk: Et element kan ikke angi blandet innhold (både tegn- og elementinnhold).

Seksjonen Beskrivelse

I denne seksjonen kan du gi en kort beskrivelse av et element, attributter eller kompositør innen det redigerte skjemaets grammatikk.

Denne seksjonen er tilgjengelig direkte gjennom skjemasiden Skjemadefinisjon.

Seksjonen Beskrivelse

Felt i seksjonen Beskrivelse

Rediger feltet med beskrivelsesteksten hvis du vil oppgi en kort beskrivelse for gjeldende element-, attributt- eller kompositør-node som er valgt i seksjonen Utvidelsespunktelementer. Gyldige HTML-koder kan brukes etter behov i dette feltet.

Merk: Hvis du oppdaterer en beskrivelse for elementreferanse, oppdateres også beskrivelse for den globale elementdeklarasjonen som den refererer til, og omvendt.

Seksjonen Elementdetaljer

I denne seksjonen kan du redigere egenskapene til et element. Det er to typer elementer: utvidelseselement og ikke-utvidelseselement. Et utvidelseselement er den spesielle rotelementdeklarasjonen som brukes til å definere inngangspunktet til det redigerte skjemaets grammatikk. Et ikke-utvidelseselement er en global elementdeklarasjon som brukes som grunnleggende strukturell byggestein i det redigerte skjemaets grammatikk.

Du aktiverer denne seksjonen ved å velge en utvidelseselementnode eller en ikke-utvidelseselementnode i seksjonen Utvidelsespunktelementer.

Seksjonen Elementdetaljer for et utvidelseselement.

Seksjon 1 for elementdetaljer

Seksjonen Elementdetaljer for et ikke-utvidelseselement.

Seksjon 2 for elementdetaljer

Felt i seksjonen Elementdetaljer

Rediger feltet Navn hvis du vil oppgi elementnavnet.

Klikk på en av knappene sant eller usant i feltet Internt for å angi om elementet er internt eller ikke. Redigeringsprogrammet for plugin-manifest flagger enhver XML-utvidelse som er internt, med en advarsel (som standard). Dette feltet er analogt med attributtet x-internal på eksporterte pakker.

Klikk på en av knappene sann og usann i feltet Foreldet for å angi om elementet er foreldet eller ikke. Redigeringsprogrammet for plugin-manifest flagger enhver XML-utvidelse som er foreldet, med en advarsel (som standard). Dette feltet er analogt med Javadoc-koden @deprecated.

Hvis et utvidelseselement er merket som foreldet, redigerer du felte Erstatning til å spesifisere det ikke-foreldede utvidelsespunktet brukeren skal bruke i stedet for å oppnå samme funksjonalitet.

Velg et av elementets definerte attributter fra feltet Etikettegenskap for å spesifisere attributtverdi til bruk som elementets etikett i redigeringsprogrammet for plugin-manifest. Hvis for eksempel en verdi er valg, blir elementets nodeetikett i seksjonen Alle utvidelser på siden Utvidelser i redigeringsprogrammet for plugin-manifest som følger: valgt-attributt-verdi (element-navn). Hvis det ikke er valgt noen verdi, blir elementets nodeetikett som følger: (element-navn).

Velg et av elementets definerte ressurstypeattributter i feltet Ikon til å spesifisere ikonressursen som skal brukes til å representere elementets node i redigeringsprogrammet for plugin-manifest. For at elementets nodeikon skal vises riktig i seksjonen Alle utvidelser på siden Utvidelser i redigeringsprogrammet for plugin-manifest, må følgende betingelser være oppfylt:

Klikk på en av knappene sann og usann i feltet Oversettbar for å oppgi om elementets tegninnhold kan oversettes eller ikke. Dette feltet gjelder bare for elementer som ikke har noen oppgitte underordnede (elementinnhold) eller attributter og tillater at tekst spesifiseres mellom XML-kodene for start og slutt (tegninnhold). Hvis et elements tegninnhold er merket som oversettbart, kan PDE-verktøyene brukes på bidratte XML-utvidelseskoder til å eksternalisere innholdet til en egenskapsfil for støtte for flere språk.

Bruk det skrivebeskyttede feltet DTD-tilnærming hvis du vil se på en tilnærmet en til en-tilordning for elementskjemaets grammatikk til tilsvarende DTD-elementgrammatikk. En DTD (dokumenttypedefinisjon) er et mer lettleselig, mindre kraftig alternativ til XML-skjema for å oppgi et XML-dokuments formelle grammatikk. Følgende notasjon brukes til å spesifisere DTD-tilnærmingen:

Seksjonen Kompositørdetaljer

I denne seksjonen kan du redigere egenskapene til en kompositør. Det er to typer kompositører: sekvenskompositør og valgkompositør. En sekvenskompositør lar deg oppgi at et underordnet element består av en sekvens av andre elementer i det redigerte skjemaets grammatikk. En valgkompositør lar deg oppgi at et underordnet element består av et valg av andre elementer i det redigerte skjemaets grammatikk.

Denne seksjonen aktiveres ved å velge en sekvensnode eller valgnode i seksjonen Utvidelsespunktelementer.

Seksjonen Kompositørdetaljer

Felt i seksjonen Kompositørdetaljer

Rediger feltet Min. forekomster for å oppgi minste antall forekomster som denne kompositøren av andre elementer og/eller kompositører tillates å opptre i den bidratte XML-utvidelseskoden. Dette feltets verdi brukes av PDE til å validere flere begrensninger innen redigeringsprogrammet ofr plugin-manifest. Hvis element A krever nøyaktig ett element B eller element C som underordnet element, og det bruker en valgkompositør som spesifiserer minst 2 forekomster, må 2 forekomster av element B i kombinasjon med element C defineres i den bidratte XML-utvidelseskoden for å være gyldig.

Rediger feltet Maks. forekomster for å oppgi maksimalt antall forekomster som denne kompositøren av andre elementer og/eller kompositører tillates å opptre i den bidratte XML-utvidelseskoden. Dette feltets verdi brukes av PDE til å validere flere begrensninger innen redigeringsprogrammet ofr plugin-manifest. Hvis element A krever nøyaktig ett element B eller element C som underordnet element, og det bruker en valgkompositør som spesifiserer minst 2 forekomster, kan høyst 2 forekomster av element B i kombinasjon med element C defineres i den bidratte XML-utvidelseskoden for å være gyldig.

Merk av i feltet Ubundet for å oppgi at det ikke er noen begrensning på antall tillatte forekomster av denne kompositøren i den bidratte XML-utvidelseskoden.

Velg en verdi fra feltet Type for å oppgi om denne kompositøren er sekvens eller valg.

Bruk det skrivebeskyttede feltet DTD-tilnærming hvis du vil se på en tilnærmet en til en-tilordning for kompositørskjemaets grammatikk til tilsvarende DTD-kompositørgrammatikk. Notasjonen som brukes til å oppgi DTD-tilnærming, er beskrevet under overskriften Felt i seksjonen Elementdetaljer i dette dokumentet.

Seksjonen Elementreferansedetaljer

I denne seksjonen kan du redigere egenskapene til en elementreferanse. En elementreferanse er en referanse til en global elementdeklarasjon innen det redigerte skjemaets grammatikk. Elementreferanser brukes av kompositører som atomiske byggesteiner til å definere grammatikken for globale elementdeklarasjoner.

Denne seksjonen aktiveres ved å velge en elementreferansenode i seksjonen Utvidelsespunktelementer.

Seksjonen Elementreferansedetaljer

Felt i seksjonen Elementreferansedetaljer

Rediger feltet Min. forekomster for å oppgi minste antall forekomster som dette elementet tillates å opptre i den bidratte XML-utvidelseskoden. Dette feltets verdi brukes av PDE til å validere flere begrensninger innen redigeringsprogrammet ofr plugin-manifest. Hvis element A spesifiserer minst 2 forekomster, må 2 forekomster av element A være definert i den bidratte XML-utvidelseskoden for å være gyldig.

Rediger feltet Maks. forekomster for å oppgi maksimalt antall forekomster som dette elementet tillates å opptre i den bidratte XML-utvidelseskoden. Dette feltets verdi brukes av PDE til å validere flere begrensninger innen redigeringsprogrammet ofr plugin-manifest. Hvis element A spesifiserer maksimalt 2 forekomster, kan høyst 2 forekomster av element A være definert i den bidratte XML-utvidelseskoden for å være gyldig.

Merk av i feltet Ubundet for å oppgi at det ikke er noen begrensning på antall tillatte forekomster av dette elementet i den bidratte XML-utvidelseskoden.

Bruk det skrivebeskyttede feltet DTD-tilnærming hvis du vil se på en tilnærmet en til en-tilordning for elementskjemaets grammatikk til tilsvarende DTD-elementgrammatikk. Notasjonen som brukes til å oppgi DTD-tilnærming, er beskrevet under overskriften Felt i seksjonen Elementdetaljer i dette dokumentet.

Handlinger i seksjonen Elementreferansedetaljer

Klikk på element-navn-hyperlinken i feltet Referanse hvis du vil redigere egenskapene til den globale elementdeklarasjonen som dette lokale elementet refererer til. Når denne handlingen er fullført, velges den refererte elementnoden i seksjonen Utvidelsespunktelementer, og tilsvarende Elementdetaljer-seksjon aktiveres.

Seksjonen Attributtdetaljer

I denne seksjonen kan du redigere egenskapene til et attributt. Attributter sørger for tilleggsinformasjon om elementer.

Denne seksjonen deaktiveres ved å velge en obligatorisk attributt-, valgfritt attributt-, klasseattributt- eller ressursattributt-node i seksjonen Utvidelsespunktelementer.

Seksjonen Attributtdetaljer for et obligatorisk attributt av typen streng som spesifiserer en oppregningsbegrensning.

Seksjon 1 for attributtdetaljer

Seksjonen Attributtdetaljer for et valgfritt attributt av typen boolsk som spesifiserer en standardverdi.

Seksjon 2 for attributtdetaljer

Seksjonen Attributtdetaljer for et klasseattributt som angir at klassen representert ved attributtet må utvide den angitte klassen og/eller implementere den angitte grensesnittet.

Seksjon 3 for attributtdetaljer

Seksjonen Attributtdetaljer for et ressursattributt.

Seksjon 4 for attributtdetaljer

Bruke skjemaidentifikatorattributtet

Forfattere av utvidelsespunkter kan definere attributter som refererer til andre attributter. Dette oppnås ved å definere attributtene for utvidelsespunktet som typeidentifikator og velge attributtet det refererer til. Et eksempel på dette kan være utvidelsespunktet org.eclipse.ui.handlers. Attributtet commandId refererer til kommandoer definert i utvidelsespunktet org.eclipse.ui.commands.

Bruk av skjemaidentifikator

Utviklere av utvidelser som bidrar med en behandler, kan så velge fra alle gyldige identifikatorer for attributtet commandId. Advarsler utstedes for identifikatorer som ikke finnes, for å hindre den vanlige feil at IDer staves feil.

Felt i seksjonen Attributtdetaljer

Rediger feltet Navn hvis du vil oppgi attributtnavnet.

Klikk på en av knappene sann og usann i feltet Foreldet for å angi om attributtet er foreldet eller ikke. Redigeringsprogrammet for plugin-manifest flagger enhver XML-utvidelse som er foreldet, med en advarsel (som standard). Dette feltet er analogt med Javadoc-koden @deprecated.

Velg en verdi i feltet Bruk for å oppgi om attributtet må spesifiseres på sitt definerende element i den bidratte XML-utvidelseskodingen. Følgende valg finnes:

Rediger feltet Standardverdi hvis du vil oppgi standardverdien som skal brukes for et attributt når det ikke er spesifisert på sitt definerende element i den bidratte XML-utvidelseskodingen. Dette feltet gjelder bare når standardverdien fra feltet Bruk er valgt.

Velg en verdi i feltet Type for å oppgi attributtverditypen. Følgende valg finnes:

Klikk på en av knappene sann og usann i feltet Oversettbar for å oppgi om attributtets verdi kan oversettes eller ikke. Dette feltet gjelder bare når streng-verdien fra feltet Type er valgt. Hvis et attributts verdi er merket som oversettbart, kan PDE-verktøyene brukes på bidratte XML-utvidelseskoder til å eksternalisere disse verdiene til en egenskapsfil for støtte for flere språk.

Bruk feltet Begrensninger hvis du vil ha frem en liste over strengverdier som attributtet er begrenset til å bruke som sin verdi. Hvis dette feltet ikke inneholder noen verdi, er det ingen begrensninger på attributtverdien. Dette feltet gjelder bare når streng-verdien fra feltet Type er valgt. Merk: En oppregningsbegrensning på strengbasistypen brukes i det redigerte skjemaets grammatikk for å oppnå denne funksjonaliteten.

Rediger feltet Utvider for å oppgi et fullt kvalifisert klassenavn i målplattformens klassebane (f.eks. org.eclipse.ui.part.EditorPart) som må subklassifiseres av klassen som er spesifisert som attributtverdi. PDE validerer klasseattributtverdien i den bidratte XML-utvidelseskoden for å sikre at den utvider superklassen. Dette feltet gjelder bare når java-verdien fra feltet Type er valgt.

Rediger feltet Implementerer for å oppgi fullt kvalifisert grensesnittnavn for målplattformens klassebane (f.eks. org.eclipse.ui.IEditorPart) som må implementeres av den klassen som er oppgitt som attributtverdi). PDE validerer klasseattributtverdien i den bidratte XML-utvidelseskoden for å sikre at den implementerer grensesnittet. Dette feltet gjelder bare når java-verdien fra feltet Type er valgt.

Handlinger for seksjonen Attributtdetaljer

Klikk på knappen Legg til... i feltet Begrensninger. Du får frem dialogboksen Ny begrensning, der du kan legge til en ny begrensning i attributtverdien. Når denne dialogboksen er fullført, legges den nye begrensningen til på listen over strengverdier som attributtet er begrenset til å bruke som egen verdi. Denne handlingen er tilgjengelig bare når streng-verdien i feltet Type er valgt.

Velg en strengverdi i feltet Begrensninger og klikk på knappen Fjern hvis du vil fjerne en begrensning fra listen over strengverdier som attributtet er begrenset til å bruke som egen verdi. Denne handlingen er tilgjengelig bare når streng-verdien i feltet Type er valgt.

Hvis verdien som er oppgitt i feltet Utvider, refererer til et fullt kvalifisert klassenavn i målplattformens klassebane, og du klikker på hyperlinken Utvider, åpnes denne klassen i et nytt Java-kilderedigeringsprogram. Ellers vil det å klikke på hyperlinken Utvider åpne veiviseren Ny Java-klasse, slik at du kan opprette den nye klassen. Denne handlingen er tilgjengelig bare når java-verdien i feltet Type er valgt.

Hvis verdien som er oppgitt i feltet Implementerer, refererer til et fullt kvalifisert grensesnittnavn i målplattformens klassebane, og du klikker på hyperlinken Implementerer, åpnes dette grensesnittet klassen i et nytt Java-kilderedigeringsprogram. Ellers vil det å klikke på hyperlinken Implementerer åpne veiviseren Ny Java-klasse, slik at du kan opprette det nye grensesnittet. Denne handlingen er tilgjengelig bare når java-verdien i feltet Type er valgt.

Klikk på knappen Bla gjennom.... Du får frem dialogboksen Velg type, der du kan velge en eksisterende klasse i målplattformens klassebane til bruk som verdi for feltet Utvider. Denne handlingen er tilgjengelig bare når java-verdien i feltet Type er valgt.

Klikk på knappen Bla gjennom.... Du får frem dialogboksen Velg type, der du kan velge et eksisterende grensesnitt i målplattformens klassebane til bruk som verdi for feltet Implementerer. Denne handlingen er tilgjengelig bare når java-verdien i feltet Type er valgt.

Relevante linker