Stránka Definice schématu

O této stránce

Tato stránka formuláře vám umožní upravovat strukturu vlastností objektů schémat, které tvoří gramatiku upravovaného schématu.

Struktura objektů schématu se upravuje v sekci Prvky bodu rozšíření. Tato sekce zabírá horní levou část oblasti editoru.

Vlastnosti objektů schématu se upravují v sekcích <objekt_schématu> Podrobnosti. Tyto sekce jsou aktivovány v horní pravé části oblasti editoru v závislosti na typu prvku schématu vybraného v sekci Prvky bodu rozšíření.

Sekce stránky

Tato stránka zahrnuje následující sekce:

Sekce Prvky bodu rozšíření

Tato sekce vám umožňuje provádět následující:

Tato sekce je přímo přístupná přes stránku formuláře Definice schématu.

Pole sekce Prvky bodu rozšíření

Použijte pole prohlížeče prvků bodu rozšíření k:

Tento prohlížeč obsahuje následující pole:

Prvky:

Kompozitory:

Atributy:

Příklad: Prvek rozšíření určuje, že jako jeho povolené podřízené prvky je možný jeden nebo více prvků zástupce. K reprezentaci prvku zástupce se používá odkaz na prvek. K reprezentaci posloupnosti prvků se používá Kompozitor posloupnosti.

Sekce Prvky bodu rozšíření 2

Příklad: Prvek zástupce určuje, že jako jeho povolený podřízený prvek je možný prvek popis nebo kategorie. K reprezentaci prvků popis a kategorie se používají odkazy na prvek. K reprezentaci volby prvků se používá kompozitor volby.

Sekce Prvky bodu rozšíření 1

Akce sekce Prvky bodu rozšíření

Klepněte na tlačítko Přidat prvek, abyste přidali novou deklaraci globálního prvku ke gramatice schématu bodu rozšíření. Tato akce je dostupná, je-li vybrán uzel. Poznámka: Na pořadí deklarací prvků nezáleží.

Klepněte na tlačítko Přidat atribut, abyste přidali novou deklaraci lokálního atributu k vybranému prvku v gramatice schématu bodu rozšíření. Tato akce je dostupná pro všechny vybrané uzly prvku s výjimkou uzlu prvek rozšíření. Uzel prvek rozšíření má vždy stejný atribut: ID, název, bod. Poznámka: Na pořadí deklarace atributů nezáleží.

Chcete-li odstranit objekt schématu z gramatiky schématu bodu rozšíření, klepněte pravým tlačítkem myši na vybraný uzel a vyberte Odstranit. Tato akce je dostupná pro všechny vybrané uzly s výjimkou uzlu prvek rozšíření. Pro nesdílená schémata je uzel prvek rozšíření speciálním kořenovým prvkem použitým k definování vstupního bodu do gramatiky upravovaného schématu. Každé rozšíření definované v Editoru souborů typu manifest modulu plug-in musí používat nadřízený prvek rozšíření k určení jeho souvisejícího markupu XML.

Abyste určili, zda je podřízený prvek prvku sestaven z posloupnosti nebo volby jiných prvků v gramatice schématu bodu rozšíření, postupujte takto:

  1. Vyberte a pravým tlačítkem myši klepněte na uzel prvek, který chcete určit jako nadřízený prvek.
  2. Vyberte Nový > Kompozitor > Posloupnost, abyste definovali posloupnost prvků. Vyberte Nový > Kompozitor > Volba, abyste definovali volbu prvků.
  3. Vyberte a pravým tlačítkem myši klepněte na nový uzel kompozitor.
  4. Z podnabídky Nový > Odkaz vyberte prvek, který chcete určit jako podřízený prvek nadřízeného prvku. Podnabídka Odkaz obsahuje všechny prvky deklarované globálně v gramatice schématu bodu rozšíření.
  5. Opakujte kroky (3) a (4), abyste zadali další podřízené prvky. Byl-li zadán kompozitor posloupnosti, znamená to zadat další prvky v posloupnosti. Byl-li zadán kompozitor volby, znamená to zadat další volby prvků.

Poznámka: Abyste určili, že jeden prvek je podřízen jinému prvku, nadřízený prvek musí vždy používat intermediační kompozitor Posloupnost nebo Volba. Uzly kompozitor jsou uzly konektoru; zatímco uzly odkaz na prvek jsou koncové uzly. Proto musejí uzly kompozitor vždy specifikovat alespoň jeden podřízený uzel odkaz na prvek.

Poznámka: Kompozitory Posloupnost a Volba mohou být vnořeny libovolněkrát pro vytvoření složitější gramatiky.

Poznámka: Gramatika nesmí obsahovat cykly odkazující samy na sebe. Nejzákladnější forma zakázaného cyklu vznikne, když Prvek A vyžaduje jako podřízený prvek Prvek B a Prvek B vyžaduje jako podřízený prvek Prvek A.

Abyste určili, že prvek nebude mít žádné podřízené prvky a umožní zadat text v rámci jeho počáteční a koncové značky XML (obsah znaků), jednoduše ponechejte strukturu prvku tak, jak je, bez přidání atributů, kompozitorů a prvky, které na něj odkazují (obsah prvků). Poznámka: Prvek nemůže specifikovat smíšený obsah (obsah znaků a obsah prvků).

Sekce Popis

Tato sekce umožňuje poskytnou stručný popis pro každý prvek, atribut nebo kompozitor v gramatice upravovaného schématu.

Tato sekce je přímo přístupná přes stránku formuláře Definice schématu.

Sekce Popis

Pole sekce Popis

Upravte pole textu popisu, abyste zadali stručný popis pro aktuální uzel prvek, atribut nebo kompozitor vybraný v sekci Prvky bodu rozšíření. V těchto polích lze potřeby použít platný HTML markup.

Poznámka: Aktualizace popisu odkazu na prvek rovněž aktualizuje popis deklarace globálního prvku, na nějž odkazuje, a naopak.

Sekce Podrobnosti prvku

Tato sekce umožňuje upravit vlastnosti prvku. Existují dva druhy prvků: Prvek rozšíření a prvek, který není prvkem rozšíření. Prvek rozšíření je zvláštní deklarace kořenového prvku použitá k definování vstupního bodu do gramatiky upravovaného schématu. Prvek, který není prvkem rozšíření, je deklarace globálního prvku použitá jako základní strukturální stavební blok v gramatice upravovaného schématu.

Tato sekce se aktivuje výběrem uzlu prvek rozšíření nebo uzlu prvek, který není prvkem rozšíření, v sekci Prvky bodu rozšíření.

Sekce Podrobnosti prvku pro prvek rozšíření.

Sekce Podrobnosti prvku 1

Sekce Podrobnosti prvku pro prvek, který není prvkem rozšíření.

Sekce Podrobnosti prvku 2

Pole sekce Podrobnosti prvku

Upravte pole Název, abyste zadali název prvku.

Klepněte na tlačítko true nebo na tlačítko false v poli Interní, abyste označili, zda je prvek interní či nikoli. Editor souborů typu manifest modulu plug-in opatří příznakem varování každý XML markup rozšíření, který je interní (standardně). Toto pole je analogické atributu x-internal u exportovaných balíků.

Klepněte na tlačítko true nebo na tlačítko false v poli Zamítnuto, abyste označili, zda je prvek zamítnut či nikoli. Editor souborů typu manifest modulu plug-in opatří příznakem varování každý XML markup rozšíření, který je zamítnutý (standardně). Toto pole je analogické značce @deprecated dokumentace Javadoc.

Je-li prvek rozšíření označený jako zamítnutý, upravte pole Náhrada, abyste zadali nezamítnutý bod rozšíření, který má uživatel použít místo něj, aby dosáhl stejné funkčnosti.

Vyberte jeden z definovaných atributů prvku z pole Vlastnost štítku, abyste zadali hodnotu atributu použitou jako štítek prvku v Editoru souborů typu manifest modulu plug-in. Pokud je například vybraná hodnota, štítek uzlu prvku v sekci Všechny rozšíření na stránce Rozšíření v Editoru souborů typu manifest modulu plug-in bude následující: hodnota_vybraného_atributu (název_prvku). Pokud ale není vybrána žádná hodnota, štítek uzlu prvku bude následující: (název_prvku).

Vyberte jeden z definovaných atributů typu prostředku prvku v poli Ikona, abyste zadali prostředek ikony, který bude použit pro reprezentaci uzlu prvku v Editoru souborů typu manifest modulu plug-in. Aby se ikona uzlu prvku správně zobrazovala v sekci Všechna rozšíření na stránce Rozšíření v Editoru souborů typu manifest modulu plug-in, musejí být splněny následující podmínky:

Klepněte na tlačítko true nebo na tlačítko false v poli Přeložitelný, abyste označili, zda je znakový obsah prvku přeložitelný či nikoli. Toto pole se používá pouze na prvky, které nemají žádné zadané podřízené prvky (obsah prvků) ani atributy a umožňují, aby byl v jejich počáteční a koncové značce XML zadán text (znakový obsah). Pokud je znakový obsah prvku označen jako přeložitelný, lze použít nástroje PDE v XML markupu přidaného rozšíření k externalizaci obsahu do souborů vlastností pro vícejazyčnou podporu.

Použijte pole Aproximace DTD určené jen pro čtení k zobrazení aproximace mapování gramatiky schématu prvku jedna k jedné do ekvivalentní DTD gramatiky prvku. DTD (Document Type Definition) je snáze čitelná, méně výkonná alternativa ke schématu XML pro zadávání formální gramatiky dokumentu XML. Pro aproximaci DTD se používá následující notace:

Sekce Podrobnosti kompozitoru

Tato sekce umožňuje upravit vlastnosti kompozitoru. Existují dva typy kompozitorů: Kompozitor posloupnosti, kompozitor volby. Kompozitor posloupnosti umožňuje určit, že podřízený prvek prvku se skládá z posloupnosti jiných prvků v gramatice upravovaného schématu. Kompozitor volby umožňuje určit, že podřízený prvek prvku se skládá z volby jiných prvků v gramatice upravovaného schématu.

Tato sekce se aktivuje výběrem uzlu Posloupnost nebo Volba v sekci Prvky bodu rozšíření.

Sekce Podrobnosti kompozitoru

Pole sekce Podrobnosti kompozitoru

Upravte pole Minimální výskyty, abyste určili minimální počet výskytů tohoto kompozitoru v jiných prvcích a zda se kompozitory mohou objevit v XML markupech přidaného rozšíření. Hodnotu tohoto pole používá PDE k ověření omezení vícenásobného výskytu v Editoru souborů typu manifest modulu plug-in. Pokud Prvek A vyžaduje přesně jeden Prvek B nebo Prvek C jako své podřízené prvky a používá kompozitor Volba specifikující minimálně dva výskyty, potom musí být v XML markupu přidaného rozšíření definovány libovolné dvě instance Prvku B v kombinaci s Prvkem C, aby byl platný.

Upravte pole Maximální výskyty, abyste určili maximální počet výskytů tohoto kompozitoru v jiných prvcích a zda se kompozitory mohou objevit v XML markupech přidaného rozšíření. Hodnotu tohoto pole používá PDE k ověření omezení vícenásobného výskytu v Editoru souborů typu manifest modulu plug-in. Pokud Prvek A vyžaduje přesně jeden Prvek B nebo Prvek C jako své podřízené prvky a používá kompozitor Volba specifikující maximálně dva výskyty, potom nesmí být v XML markupu přidaného rozšíření definovány víc než dvě instance Prvku B v kombinaci s Prvkem C, aby zůstal platný.

Zaškrtněte pole Bez vazby, abyste určili, že neexistuje žádné omezení maximálního počtu povolených výskytů tohoto kompozitoru v XML markupu přidaného rozšíření.

Vyberte hodnotu z pole Typ, abyste zadali, zda je tento kompozitor typu posloupnost nebo volba.

Použijte pole Aproximace DTD určené jen pro čtení k zobrazení aproximace mapování gramatiky schématu kompozitoru jedna k jedné do ekvivalentní DTD gramatiky kompozitoru. Notace použití ke specifikaci aproximace DTD je popsána v části Pole sekce Podrobnosti prvku v tomto dokumentu.

Sekce Podrobnosti odkazu na prvek

Tato sekce umožňuje upravit vlastnosti odkazu na prvek. Odkaz na prvek je odkazem na deklaraci globálního prvku v gramatice upravovaného schématu. Odkazy na prvek jsou používány kompozitory jako základní stavební bloky k definování gramatiky pro deklarace globálních prvků.

Tato sekce se aktivuje výběrem uzlu odkaz na prvek v sekci Prvky bodu rozšíření.

Sekce Podrobnosti odkazu na prvek

Pole sekce Podrobnosti odkazu na prvek

Upravte pole Minimální výskyty, abyste určili minimální počet výskytů tohoto prvku v XML markupu přidaného rozšíření. Hodnotu tohoto pole používá PDE k ověření omezení vícenásobného výskytu v Editoru souborů typu manifest modulu plug-in. Pokud Prvek A specifikuje minimálně dva výskyty, potom musí být v XML markupu přidaného rozšíření definovány dvě instance Prvku A, aby byl platný.

Upravte pole Maximální výskyty, abyste určili maximální počet výskytů tohoto prvku v XML markupu přidaného rozšíření. Hodnotu tohoto pole používá PDE k ověření omezení vícenásobného výskytu v Editoru souborů typu manifest modulu plug-in. Pokud Prvek A specifikuje minimálně dva výskyty, potom musí být v XML markupu přidaného rozšíření definovány maximálně dvě instance Prvku A, aby zůstal platný.

Zaškrtněte pole Bez vazby, abyste určili, že neexistuje žádné omezení maximálního počtu povolených výskytů tohoto prvku v XML markupu přidaného rozšíření.

Použijte pole Aproximace DTD určené jen pro čtení k zobrazení aproximace mapování gramatiky schématu prvku jedna k jedné do ekvivalentní DTD gramatiky prvku. Notace použití ke specifikaci aproximace DTD je popsána v části Pole sekce Podrobnosti prvku v tomto dokumentu.

Akce sekce Podrobnosti odkazu na prvek

Klepněte na hypertextový odkaz název_prvku v poli Odkaz, abyste upravili vlastnosti deklarace globálního prvku, na který tento lokální prvek odkazuje. Po dokončení této akce je uzel odkazovaného prvku vybrán v sekci Prvky bodu rozšíření a je aktivována příslušná sekce Podrobnosti prvku.

Sekce Podrobnosti atributu

Tato sekce umožňuje upravit vlastnosti atributu. Atributy se používají k poskytování dodatečných informací o prvcích.

Tato sekce se aktivuje výběrem uzlu povinný atribut, nepovinný atribut, atribut třídy nebo atribut prostředku v sekci Prvky bodu rozšíření.

Sekce Podrobnosti atributu pro povinný atribut typu řetězec, který určuje výčtové omezení.

Sekce Podrobnosti atributu 1

Sekce Podrobnosti atributu pro volitelný atribut typu logický, který určuje výchozí hodnotu.

Sekce Podrobnosti atributu 2

Sekce Podrobnosti atributu pro atribut třídy, který indikuje, že třída reprezentovaná hodnotou atributu, musí rozšiřovat zadanou třídu nebo implementovat zadané rozhraní.

Sekce Podrobnosti atributu 3

Sekce Podrobnosti atributu pro atribut prostředku.

Sekce Podrobnosti atributu 4

Použití atributu identifikátoru schématu

Autoři bodů rozšíření mohou definovat atributy, které odkazují na jiné atributy. To se uskuteční nastavením atributů bodů rozšíření jako typ identifikátoru a zvolením atributu, na který odkazuje. Příkladem je bod rozšíření org.eclipse.ui.handlers. Atribut commandId odkazuje na příkazy definované v bodu rozšíření org.eclipse.ui.commands.

Použití identifikátoru schématu

Vývojáři rozšíření přispívající k obslužné rutině pak mohou vybírat ze všech platných identifikátorů pro atribut commandId. Pro identifikátory, které neexistují, jsou vydávána varování, aby se zabránilo obecné chybě nesprávně zapsaného identifikátoru.

Pole sekce Podrobnosti atributu

Upravte pole Název, abyste zadali název atributu.

Klepněte na tlačítko true nebo na tlačítko false v poli Zamítnuto, abyste označili, zda je atribut zamítnut či nikoli. Editor souborů typu manifest modulu plug-in opatří příznakem varování každý XML markup rozšíření, který je zamítnutý (standardně). Toto pole je analogické značce @deprecated dokumentace Javadoc.

Vyberte hodnotu z pole Použití, abyste označili, zda musí být atribut zadán na svém definujícím prvku v rámci XML markupu přidaného rozšíření. K dispozici jsou následující výběry:

Upravte pole Výchozí hodnota, abyste zadali výchozí hodnotu, která se použije pro atribut, není-li zadán na svém definujícím prvku v XML přidaného rozšíření. Toto pole se použije jen tehdy, když je vybrána hodnota výchozí v poli Použití.

Vyberte hodnotu z pole Typ, abyste zadali typ hodnoty atributu. K dispozici jsou následující výběry:

Klepněte na tlačítko true nebo na tlačítko false v poli Přeložitelný, abyste označili, zda je hodnota atributu přeložitelná či nikoli. Toto pole se použije jen tehdy, když je vybrána hodnota řetězec v poli Typ. Pokud je hodnota atributu označena jako přeložitelná, lze použít nástroje PDE v XML markupu přidaného rozšíření k externalizaci těchto hodnot do souborů vlastností pro vícejazyčnou podporu.

Použijte pole Omezení, abyste zobrazili seznam řetězcových hodnot, které může atribut použít jako své hodnoty. Pokud pole neobsahuje žádnou hodnotu, pak neexistuje žádné omezení hodnoty atributu. Toto pole se použije jen tehdy, když je vybrána hodnota řetězec v poli Typ. Poznámka: K dosažení této funkčnosti se v gramatice upravovaného schématu u základního typu řetězce používá výčtové omezení.

Upravte pole Rozšiřuje, abyste zadali úplný název třídy v cestě ke třídě cílové platformy (např. org.eclipse.ui.part.EditorPart), která musí být podtřídou třídy zadané jako hodnota atributu. PDE ověří platnost hodnoty atributu třídy v XML markupu přidaného rozšíření, aby se zajistilo, že rozšiřuje supertřídu. Toto pole se použije jen tehdy, když je vybrána hodnota java v poli Typ.

Upravte pole Implementuje, abyste zadali úplný název rozhraní v cestě ke třídě cílové platformy (např. org.eclipse.ui.IEditorPart), které musí být implementováno třídou zadanou jako hodnota atributu. PDE ověří platnost hodnoty atributu třídy v XML markupu přidaného rozšíření, aby se zajistilo, že implementuje rozhraní. Toto pole se použije jen tehdy, když je vybrána hodnota java v poli Typ.

Akce sekce Podrobnosti atributu

Klepněte na tlačítko Přidat... v poli Omezení, abyste otevřeli dialogové okno Nové omezení a mohli přidat nové omezení hodnoty atributu. Po dokončení dialogového okna je nové omezení přidání k seznamu řetězcových hodnot, které může atribut použít jako svoji hodnotu. Tato akce je dostupná jen tehdy, když je vybrána hodnota řetězec v poli Typ.

Vyberte řetězcovou hodnotu v poli Omezení a klepněte na tlačítko Odebrat, abyste odebrali omezení ze seznamu řetězcových hodnot, které může atribut použít jako svoji hodnotu. Tato akce je dostupná jen tehdy, když je vybrána hodnota řetězec v poli Typ.

Pokud hodnota zadaná v poli Rozšiřuje odkazuje na úplný název třídy v cestě ke třídě cílové platformy, potom klepnutí na hypertextový odkaz Rozšiřuje otevře tuto třídu v editoru nového zdroje Java. Jinak klepnutí na hypertextový odkaz Rozšiřuje otevře průvodce Nová třída Java, který umožní vytvořit novou třídu. Tato akce je dostupná jen tehdy, když je vybrána hodnota java v poli Typ.

Pokud hodnota zadaná v poli Implementuje odkazuje na úplný název rozhraní v cestě ke třídě cílové platformy, potom klepnutí na hypertextový odkaz Implementuje otevře toto rozhraní v editoru nového zdroje Java. Jinak klepnutí na hypertextový odkaz Implementuje otevře průvodce Nová třída Java, který umožní vytvořit nové rozhraní. Tato akce je dostupná jen tehdy, když je vybrána hodnota java v poli Typ.

Klepněte na tlačítko Procházet..., abyste otevřeli dialogové okno Vybrat typ a mohli vybrat existující třídu v cestě ke třídě cílové platformy, která bude použita jako hodnota pro pole Rozšiřuje. Tato akce je dostupná jen tehdy, když je vybrána hodnota java v poli Typ.

Klepněte na tlačítko Procházet..., abyste otevřeli dialogové okno Vybrat typ a mohli vybrat existující rozhraní v cestě ke třídě cílové platformy, které bude použito jako hodnota pro pole Implementuje. Tato akce je dostupná jen tehdy, když je vybrána hodnota java v poli Typ.

Příslušné odkazy