Ezen az űrlap oldalon a szerkesztett séma nyelvtanát alkotó séma objektumok szerkezetét és tulajdonságait szerkesztheti.
A séma objektumok szerkesztése a Kiterjesztési pont elemek részben történik. Ez a rész a szerkesztőterület bal felső részét foglalja el.
A séma objektumok tulajdonságainak szerkesztése a <séma-objektum> Részletek részben történik. Ezek a műveletek a szerkesztőterület jobb felső részében kerülnek aktiválásra, a Kiterjesztési pont elemek részben kijelölt sémaelem típusától függően.
Az oldal a következő részekből áll:
Ebben a részben a következőket teheti:
Ez a rész közvetlenül a Séma definíció űrlap oldalon keresztül érhető el.
A kiterjesztési pont elemmegjelenítő mezőt a következőkre használhatja:
A szerkesztő az alábbi csomópontokat tartalmazza:
Elemek:
Összeállítók:
Attribútumok:
Példa: A kiterjesztés elem azt határozza meg, hogy legális utódjaként szekvencia gyorsbillentyű elemek engedélyezettek. A gyorsbillentyű elem ábrázolására elemhivatkozás kerül felhasználásra. Az elemek sorrendjét Szekvencia összeállító képviseli.
Példa: A gyorsbillentyű elem megadja, hogy legális utódjaként leírás vagy kategória elem engedélyezett. A leírás és kategória elemeket Elemhivatkozások képviselik. Az elemek kínálatát Választás összeállító képviseli.
Az Elem hozzáadása gombra kattintva a kiterjesztési pont séma nyelvtanához új globális elemdeklarációt adhat hozzá. Ez művelet akkor érhető el, ha valamelyik csomópont ki van jelölve. Megjegyzés: Az elemdeklaráció sorrendje nem fontos
Az Attribútum hozzáadása gombra kattintva a kiterjesztési pont séma nyelvtanának kijelölt eleméhez új helyi attribútumdeklarációt adhat hozzá. Ez a művelet minden kijelölt elem csomópont esetében elérhető, a kiterjesztés elem csomópontot kivéve. A kiterjesztés elem csomópont mindig ugyanazokkal az attribútumokkal rendelkezik: azonosító, név, pont. Megjegyzés: Az attribútumdeklaráció sorrendje nem fontos.
Ha a kiterjesztési pont séma nyelvtanából séma objektumot kíván törölni, akkor kattintson a jobb egérgombbal a kijelölt csomópontra, majd válassza az előugró menü Törlés menüpontját. Ez a művelet minden kijelölt csomópont esetében elérhető, a kiterjesztés elem csomópontot kivéve. Nem megosztott sémák esetében a kiterjesztés elem csomópont az a speciális fő elem, amit belépési pont meghatározására használnak a szerkesztett séma nyelvtanába. A Bedolgozó leírófájl szerkesztőben meghatározott bármely kiterjesztésnek kiterjesztés szülő elemet kell használnia az XML nyelvhez kapcsolódó kódjának meghatározására.
Ha azt kívánja megadni, hogy adott elem utódja a kiterjesztési pontban található egyéb elemek szekvenciájából vagy választásából kerül összeállításra, akkor tegye a következőket:
Megjegyzés: Ha azt kívánja megadni, hogy adott elem másik elem utódja, akkor a szülő elemnek mindig köztes Szekvencia vagy Választás összeállítót kell használnia. Az összeállító csomópontok kapcsolat csomópontok; ugyanakkor az elemhivatkozás csomópontok levél csomópontok. Ezért az összeállító csomópontoknak mindig legalább egy elemhivatkozás csomópontot meg kell határozniuk.
Megjegyzés: Szekvencia és Választás összeállítók, összetettebb nyelvtanok létrehozás céljából, tetszőleges alkalommal egymásba ágyazhatók.
Megjegyzés: Nyelvtan önmagára hivatkozó ciklusokat nem tartalmazhat. A tiltott ciklus legalapvetőbb formája akkor fordul elő, amikor az A elem B elemet követel meg utódként, a B elem pedig A elemet követel meg utódként.
Ha azt kívánja megadni, hogy adott elemnek nincsenek utódai, valamint kezdő és befejező XML címkéin belül (karakter tartalom) szöveg megadását engedélyezi, akkor egyszerűen hagyja változatlanul az elem szerkezetét és ne adjon hozzá attribútumokat, összeállítókat és elemhivatkozásokat (elem tartalom). Megjegyzés: Elem nem határozhat meg vegyes tartalmat (mind karakter, mind elem tartalmat).
Ebben a részben a szerkesztett séma nyelvtanán belül bármely elemhez, attribútumhoz vagy összeállítóhoz rövid leírást adhat meg.
Ez a rész közvetlenül a Séma definíció űrlap oldalon keresztül érhető el.
Ha a Kiterjesztési pont elemek részben kijelölt, aktuális elem, attribútum vagy összeállító csomóponthoz rövid leírást kíván megadni, akkor szerkessze a leírás attribútummezőt. A mezőn belül érvényes HTML kód igény szerint használható.
Megjegyzés: Elemhivatkozás leírásának frissítése a globális elemdeklaráció leírását is automatikusan frissíti, és ez visszafelé is igaz.
Ebben a részben elem tulajdonságait szerkesztheti. Kétféle elem létezik: kiterjesztés elem és nem kiterjesztés elem. A kiterjesztés elem az a speciális fő elemdeklaráció, amit a belépési pont meghatározására használnak a szerkesztett séma nyelvtanába. A nem kiterjesztés elem olyan globális elemdeklaráció, amit a szerkesztett séma nyelvtanán belül strukturális összeépítési blokkként használnak.
Ez a rész kiterjesztés elem csomópont vagy nem kiterjesztés elem csomópont kiválasztásával kerül aktiválásra, a Kiterjesztési pont elemek részben.
A Kiterjesztés elemre vonatkozó Elem részletei rész.
A nem kiterjesztés elemre vonatkozó Elem részletei rész.
Elem nevének megadásához szerkessze a Név mezőt.
Kattintson akár az igaz, akár a hamis gombra a Belső mezőben, ha azt kívánja jelezni, hogy az elem elavult-e. A Bedolgozó leírófájl szerkesztő minden belső kiterjesztés XML kódot figyelmeztetéssel jelöl meg (alapértelmezésben). Ez a mező az exportált csomagok x-internal attribútumával analóg.
Kattintson akár az igaz, akár a hamis gombra az Elavult mezőben, ha azt kívánja jelezni, hogy az elem elavult-e. A Bedolgozó leírófájl szerkesztő minden elavult kiterjesztés XML kódot figyelmeztetéssel jelöl meg (alapértelmezésben). Ez a mező a Javadoc @deprecated címkével egyezik meg.
Ha kiterjesztés elem elavultként van megjelölve, akkor a Helyettesítés mező szerkesztésével adja meg az a nem elavult kiterjesztési pontot, amit a felhasználónak ugyanazon funkcionalitás eléréshez használnia kell helyette.
Jelölje ki az elem meghatározott attribútumainak egyikét a Címke tulajdonság mezőben annak az attribútumértéknek a megadására, amelyet a Bedolgozó leírófájl szerkesztőben az elem címkéjeként kell használni. Ha például van kiválasztott érték, akkor a Bedolgozó leírófájl szerkesztő Kiterjesztések oldalának Összes kiterjesztés részében az elem csomópontjának azonosítója a következőképpen fog kinézni: kiválasztott-attribútum-érték (elem-neve). Egyébként, ha nincs kiválasztott érték, akkor az elem csomópontjának azonosítója a következő lesz: elem-neve).
Válassza ki az elem meghatározott erőforrástípus attribútumainak egyikét az Ikon mezőben azon ikon erőforrás meghatározáshoz, amely az elem csomópontját a Bedolgozó leírófájl szerkesztőben képviselni fogja. Ahhoz, hogy az elem csomópontjának ikonja a Bedolgozó leírófájl szerkesztő Kiterjesztések oldalának Összes kiterjesztés részében helyesen jelenjen meg, a következő feltételeknek kell teljesülniük:
Kattintson akár az igaz, akár a hamis gombra az Értelmezhető mezőben, ha azt kívánja jelezni, hogy az elem karakter tartalma értelmezhető-e. Ez a mező csak olyan elemek esetében alkalmazható, amelyeknek nincs megadott utódja (elem tartalom) vagy attribútuma, valamint a kezdő és befejező XML címkéiken belül (karakter tartalom) engedélyezik szöveg megadását. Ha adott elem karakter tartalma értelmezhetőként van megjelölve, akkor a tartalom a közreadott kiterjesztés XML kódon alkalmazott PDE eszközök segítségével, tulajdonságfájlban külsőleg elérhetővé tehető, a többnyelvű támogatás biztosítása érdekében.
A csak olvasható DTD közelítés mező segítségével megtekintheti az elem séma nyelvtanának közelítő, egy az egyhez leképezését egyenértékű DTD nyelvtanra. A DTD (Dokumentumtípus definíció) az XML séma könnyen olvasható, kevésbé hatékony alternatívája, amely XML dokumentum szabályszerű nyelvtanát adja meg. A DTD közelítés meghatározására az alábbi jelölésmódot használják:
Ebben a részben összeállító tulajdonságait szerkesztheti. Kétfajta összeállító létezik: szekvencia összeállító és választás összeállító. A szekvencia összeállító segítségével azt adhatja meg, hogy adott elem utódja a kiterjesztési pontban található egyéb elemek szekvenciájából kerül összeállításra. A választás összeállító segítségével azt adhatja meg, hogy adott elem utódja a kiterjesztési pontban található egyéb elemek választásából kerül összeállításra.
Ez a rész Szekvencia vagy Választás csomópont kiválasztásával kerül aktiválásra, a Kiterjesztési pont elemek részben.
Az Előfordulások minimális száma mező szerkesztésével adhatja meg az előfordulások minimális számát, ahányszor más elemek és/vagy összeállítók ezen összeállítója a közreadott XML kódban megjelenhet. Ezen mező értékét a PDE használja multiplicitás megszorítások érvényesítésére a Bedolgozó leírófájl szerkesztőn belül. Ha A elem utódjaként pontosan egy B elemet vagy C elemet követel meg és 2 minimális előfordulási számot meghatározó Választás összeállítót használ, akkor a B elem és C elem tetszőleges kombinációjának két példányát kell meghatározni a közreadott kiterjesztés XML kódban ahhoz, hogy érvényes legyen.
Az Előfordulások maximális száma mező szerkesztésével adhatja meg az előfordulások maximális számát, ahányszor más elemek és/vagy összeállítók ezen összeállítója a közreadott XML kódban megjelenhet. Ezen mező értékét a PDE használja multiplicitás megszorítások érvényesítésére a Bedolgozó leírófájl szerkesztőn belül. Ha A elem utódjaként pontosan egy B elemet vagy C elemet követel meg és 2 maximális előfordulási számot meghatározó Választás összeállítót használ, akkor a a közreadott kiterjesztés XML kódban a B elem és C elem tetszőleges kombinációjának legfeljebb két példánya határozható meg ahhoz, hogy a kód érvényes maradjon.
A Kötetlen mező kijelölésével adhatja meg, hogy az összeállító megengedett megjelenéseinek maximális számát nem korlátozza megszorítás a közreadott kiterjesztés XML kódban.
A Típus mezőből értéket kiválasztva határozhatja meg, hogy az összehasonlító szekvencia vagy választás típusú.
A csak olvasható DTD közelítés mező segítségével megtekintheti az összehasonlító séma nyelvtanának közelítő, egy az egyhez leképezését egyenértékű összehasonlító DTD nyelvtanra. A DTD közelítés meghatározására használt jelölésmód leírása jelen dokumentum Az elem részletei rész mezői fejléce alatt található.
Ebben a részben elemhivatkozás tulajdonságait szerkesztheti. Az elemhivatkozás globális elemdeklarációra mutató hivatkozás a szerkesztett séma nyelvtanán belül. Az elemhivatkozásokat összeállítók használják, mint parányi összeépítési blokkot, a globális elemdeklarációk nyelvtanának meghatározására.
Ez a rész elemhivatkozás kiválasztásával kerül aktiválásra, a Kiterjesztési pont elemek részben.
Az Előfordulások minimális száma mező szerkesztésével adhatja meg az előfordulások minimális számát, ahányszor ez az elem a közreadott XML kódban megjelenhet. Ezen mező értékét a PDE használja multiplicitás megszorítások érvényesítésére a Bedolgozó leírófájl szerkesztőn belül. Ha az A elem 2 minimális előfordulást ad meg, akkor a közreadott kiterjesztés XML kódban az A elem 2 példányát kell meghatározni ahhoz, hogy a kód érvényes legyen.
Az Előfordulások maximális száma mező szerkesztésével adhatja meg az előfordulások maximális számát, ahányszor ez az elem a közreadott XML kódban megjelenhet. Ezen mező értékét a PDE használja multiplicitás megszorítások érvényesítésére a Bedolgozó leírófájl szerkesztőn belül. Ha az A elem 2 maximális előfordulást ad meg, akkor a közreadott kiterjesztés XML kódban az A elem legfeljebb 2 példánya kerülhet meghatározásra ahhoz, hogy a kód érvényes maradjon.
A Kötetlen mező kijelölésével adhatja meg, hogy az elem megengedett megjelenéseinek maximális számát nem korlátozza megszorítás a közreadott kiterjesztés XML kódban.
A csak olvasható DTD közelítés mező segítségével megtekintheti az elem séma nyelvtanának közelítő, egy az egyhez leképezését egyenértékű DTD nyelvtanra. A DTD közelítés meghatározására használt jelölésmód leírása jelen dokumentum Az elem részletei rész mezői fejléce alatt található.
A Hivatkozás mezőben található elem-neve hiperhivatkozásra kattintva azon globális elemdeklaráció tulajdonságait szerkesztheti, amelyre az a helyi elemhivatkozás hivatkozik. Ha ez a művelet kész, akkor a hivatkozott elem csomópont kijelölésre kerül a Kiterjesztési pont elemek részben és a megfelelő Elem részletei rész aktiválásra kerül
Ebben a részben attribútum tulajdonságait szerkesztheti. Az attribútumok az elemekről további információkkal szolgálnak.
Ez a rész a kötelező attribútum, választható attribútum, osztály attribútum vagy erőforrás attribútum csomópont kiválasztásával kerül aktiválásra a Kiterjesztési pont elemek részben.
Az Attribútum részletei rész felsorolási megszorítást meghatározó, karaktersorozat típusú, kötelező attribútum esetében.
Az Attribútum részletei rész alapértelmezett értéket meghatározó, logikai típusú, választható attribútum esetében.
Az Attribútum részletei rész olyan osztály attribútum esetében, amely azt jelzi, hogy az attribútumérték által képviselt osztálynak a megadott osztályt kell kiterjesztenie és/vagy a megadott felületet kell megvalósítania.
Az Attribútum részletei rész erőforrás attribútum esetében.
A kiterjesztési pontok szerzői meghatározhatnak más attribútumokra hivatkozó attribútumokat. Ezt úgy lehet megtenni, hogy a kiterjesztési pont attribútumokat típusazonosítóként adja meg, és kiválasztja az attribútumot, amelyre hivatkozik. Ennek egyik példája lehet az org.eclipse.ui.handlers kiterjesztési pont. A commandId attribútum az org.eclipse.ui.commands kiterjesztési pontban meghatározott parancsokra hivatkozik.
A kiterjesztések fejlesztői, akik egy kezelőt készítenek, ezután a commandId attribútum összes érvényes azonosítója közül választhatnak. A nem létező azonosítók esetében a rendszer figyelmeztetést ad az elgépelt azonosítók általános hibájának kiküszöbölése érdekében.
Az attribútum nevének megadásához szerkessze a Név mezőt.
Kattintson akár az igaz, akár a hamis gombra az Elavult mezőben, ha azt kívánja jelezni, hogy az attribútum elavult-e. A Bedolgozó leírófájl szerkesztő minden elavult kiterjesztés XML kódot figyelmeztetéssel jelöl meg (alapértelmezésben). Ez a mező a Javadoc @deprecated címkével egyezik meg.
A Használat mezőben található érték kiválasztásával jelezheti, hogy az attribútumot a közreadott kiterjesztés XML kódban a saját meghatározó elemén kell-e megadni. A következő választások állnak rendelkezésre:
Az Alapértelmezett érték mező szerkesztésével adhatja meg az attribútum használandó alapértelmezett értékét arra az esetre, ha az a közreadott kiterjesztés XML kódban saját meghatározó elemén nincs megadva. Ez a mező csak akkor érhető el, ha a Használat mezőben az alapértelmezett érték van kiválasztva.
A Típus mezőből értéket kiválasztva határozhatja meg az attribútumérték típusát. A következő választások állnak rendelkezésre:
Kattintson akár az igaz, akár a hamis gombra az Értelmezhető mezőben, ha azt kívánja jelezni, hogy az attribútum értéke értelmezhető-e. Ez a mező csak akkor érhető el, ha a Típus mezőben a karaktersorozat érték van kiválasztva. Ha adott attribútum értéke értelmezhetőként van megjelölve, akkor az érték a közreadott kiterjesztés XML kódon alkalmazott PDE eszközök segítségével, tulajdonságfájlban külsőleg elérhetővé tehető, a többnyelvű támogatás biztosítása érdekében.
A Megszorítások mezőben azon karaktersorozat értékek listáját tekintheti meg, amelyeket az attribútum saját értékeként használhat. Ha a mező nem tartalmaz értéket, akkor az attribútumra nem vonatkoznak megszorítások. Ez a mező csak akkor érhető el, ha a Típus mezőben a karaktersorozat érték van kiválasztva. Megjegyzés: A szerkesztett séma nyelvtanában ezen funkcionalitás megvalósításához a karaktersorozat alaptípusra alkalmazott felsorolás megszorítást használják.
A Kiterjeszti mező szerkesztésével az a teljes képzésű osztálynév adható meg a cél platform osztályútvonalán (pl. org.eclipse.ui.part.EditorPart), amelyből az attribútumértékben megadott osztályt származtatni kell. A PDE a közreadott kiterjesztés XML kódban lévő osztály attribútumértéket érvényesítve biztosítja, hogy az a szülőosztályt terjeszti ki. Ez a mező csak akkor érhető el, ha a Típus mezőben a java érték van kiválasztva.
A Megvalósítja mező szerkesztésével az a teljes képzésű felületnév adható meg a cél platform osztályútvonalán (pl. org.eclipse.ui.IEditorPart), amelyet az attribútumértékben megadott osztálynak meg kell valósítania. A PDE a közreadott kiterjesztés XML kódban lévő osztály attribútumértéket érvényesítve biztosítja, hogy az a felületet megvalósítja. Ez a mező csak akkor érhető el, ha a Típus mezőben a java érték van kiválasztva.
A Megszorítások mezőben lévő Hozzáadás... gombra kattintva az Új megszorítás párbeszédablakot nyithatja meg, ahol az attribútumértékhez új megszorítást adhat hozzá. A párbeszédablak befejezése után az új megszorítás hozzáadásra kerül azon karaktersorozat értékek listájához, amelyeket saját értékeként használhat. Ez a művelet csak akkor érhető el, ha a Típus mezőben a karaktersorozat érték van kiválasztva.
Ha karaktersorozat értékek listájából, amelyeket az attribútum saját értékeként használhat, megszorítást szeretne eltávolítani, akkor válassza ki a karaktersorozat értéket a Megszorítások mezőben és kattintson az Eltávolítás gombra. Ez a művelet csak akkor érhető el, ha a Típus mezőben a karaktersorozat érték van kiválasztva.
Ha a Kiterjeszti mezőben megadott érték a cél platform osztályútvonalán teljes képzésű osztálynévre hivatkozik, akkor a Kiterjeszti hiperhivatkozásra kattintva az adott osztály nyitható meg új Java szerkesztőben. Egyébként, ha a Kiterjeszti hiperhivatkozásra kattint, akkor az Új Java osztály varázsló nyílik meg, amelyben új osztályt hozhat létre. Ez a művelet csak akkor érhető el, ha a Típus mezőben a java érték van kiválasztva.
Ha a Megvalósítja mezőben megadott érték a cél platform osztályútvonalán teljes képzésű felületnévre hivatkozik, akkor a Kiterjeszti hiperhivatkozásra kattintva az adott felület nyitható meg új Java szerkesztőben. Egyébként, ha a Kiterjeszti hiperhivatkozásra kattint, akkor az Új Java osztály varázsló nyílik meg, amelyben új felületet hozhat létre. Ez a művelet csak akkor érhető el, ha a Típus mezőben a java érték van kiválasztva.
A Tallózás... gombra kattintva a Típus kiválasztása párbeszédablak nyílik meg, amelyben a Kiterjeszti mező értékeként felhasználandó, létező osztályt választhat ki a cél platform osztályútvonalán. Ez a művelet csak akkor érhető el, ha a Típus mezőben a java érték van kiválasztva.
A Tallózás... gombra kattintva a Típus kiválasztása párbeszédablak nyílik meg, amelyben a Megvalósítja mező értékeként felhasználandó, létező felületet választhat ki a cél platform osztályútvonalán. Ez a művelet csak akkor érhető el, ha a Típus mezőben a java érték van kiválasztva.