Met deze formulierpagina kunt u de structuur en eigenschappen van schemaobjecten die de grammatica van het bewerkte schema vormen, bewerken.
U kunt de structuur van schemaobjecten bewerken in de sectie Elementen van extensiepunt. Deze sectie bevindt zich linksboven in het editorgebied.
U kunt de eigenschappen van schemaobjecten bewerken in de secties <schemaobject>details. Deze secties worden geactiveerd in het gedeelte rechtsboven in het editorgebied, op basis van het type schema-element dat is geselecteerd in de sectie Elementen van extensiepunt.
Deze pagina bestaat uit de volgende secties:
Met deze sectie kunt u het volgende doen:
Deze sectie is direct toegankelijk via de formulierpagina Schemadefinitie.
Met het viewerveld voor elementen van een extensiepunt kunt u het volgende doen:
Deze viewer bevat de volgende knooppunten:
Elementen:
Compositors:
Kenmerken:
Voorbeeld: het extensie-element geeft aan dat een reeks van een of meer snelkoppeling-elementen zijn toegestaan als onderliggende items. Een elementverwijzing wordt gebruikt als representatie voor een snelkoppeling-element. Een reeks-compositor wordt gebruikt als representatie voor een reeks elementen.
Voorbeeld: het snelkoppeling-element geeft aan dat een beschrijvings- dan wel een categorie-element is toegestaan als onderliggend item. Elementverwijzingen worden gebruikt als representatie voor de beschrijving- en categorie-elementen. Een Keuze-compositor wordt gebruikt als representatie voor gekozen elementen.
Klik op Element toevoegen als u een nieuwe declaratie van een algemeen element wilt toevoegen aan de grammatica van het extensiepuntschema. Deze actie is alleen beschikbaar als een knooppunt is geselecteerd. Opmerking: het maakt niet uit in welke volgorde de elementen worden gedeclareerd.
Klik op Kenmerk toevoegen als u een nieuwe declaratie van een lokaal kenmerk wilt toevoegen aan een geselecteerd element in de grammatica van het extensiepuntschema. Deze actie is beschikbaar voor alle geselecteerde element-knooppunten, behalve het extensie-element-knooppunt. Het extensie-element-knooppunt heeft altijd dezelfde kenmerken: ID, naam, punt. Opmerking: het maakt niet uit in welke volgorde de kenmerken worden gedeclareerd.
Als u een schemaobject uit de grammatica van het extensiepuntschema wilt verwijderen, klikt u met de rechtermuisknop op een geselecteerd knooppunt en kiest u Wissen. Deze actie is beschikbaar voor alle geselecteerde knooppunten, behalve voor het extensie-element-knooppunt. Voor niet-gemeenschappelijke schema's, is het extensie-element-knooppunt het speciale hoofdelement dat wordt gebruikt voor de definitie van het ingangspunt voor de grammatica van het bewerkte schema. Elke extensie die wordt gedefinieerd in de pluginmanifesteditor moet gebruikmaken van een bovenliggend extensie-element waarin de bijbehorende XML-markup wordt aangegeven.
Om op te geven dat de onderliggende items van een element bestaan uit een reeks of keuze van andere elementen in de grammatica van het extensiepuntschema, gaat u als volgt te werk:
Opmerking: om op te geven dat een element het onderliggende item van een ander element is, moet altijd een tussenliggende Reeks- of Keuze-compositor worden gebruikt door het bovenliggende element. De compositor-knooppunten zijn verbindingsknooppunten. De elementverwijzing-knooppunten zijn echter eindknooppunten. Daarom moeten compositor-knooppunten altijd ten minste één onderliggend elementverwijzing-knooppunt hebben.
Opmerking: Reeks- en Keuze-compositors kunnen meermaals worden genest als u complexe grammatica's wilt maken.
Opmerking: een grammatica mag geen cycli bevatten die naar zichzelf verwijzen (kringverwijzingen). Een zeer eenvoudige vorm van een niet-toegestane kringverwijzing is wanneer Element A Element B als verplicht onderliggend element heeft en omgekeerd.
Als u wilt opgeven dat een element geen onderliggende items heeft en er tekst mag worden opgegeven tussen de begin- en eind-XML-tag (tekencontent), laat u de structuur van het element gewoon zoals deze is, zonder er kenmerken, compositors en elementverwijzingen (elementcontent) aan toe te voegen. Opmerking: u kunt geen gemengde content (een combinatie van teken- en elementcontent) opgeven voor een element.
In deze sectie kunt u een korte beschrijving opgeven voor een element, kenmerk of compositor in de grammatica van het bewerkte schema.
Deze sectie is direct toegankelijk via de formulierpagina Schemadefinitie.
In het tekstveld voor de beschrijving kunt u een korte beschrijving opgeven voor het element-, kenmerk- of compositor-knooppunt dat op dat moment is geselecteerd in de sectie Elementen van extensiepunt. Desgewenst kunt u in dit veld gebruikmaken van geldige HTML-markup.
Opmerking: als u de beschrijving van een elementverwijzing wijzigt, wordt ook de beschrijving van de declaratie van het algemene element waarnaar wordt verwezen gewijzigd en omgekeerd.
In deze sectie kunt u de eigenschappen van een element bewerken. Er zijn twee soorten elementen: extensie-elementen en niet-extensie-elementen. Een extensie-element is de speciale hoofdelementdeclaratie die wordt gebruikt voor de definitie van het ingangspunt voor de grammatica van het bewerkte schema. Een niet-extensie-element is een algemene elementdeclaratie die wordt gebruikt als bouwsteen voor de grammatica van het bewerkte schema.
Deze sectie wordt geactiveerd als u knooppunt van een extensie-element of een knooppunt van een niet-extensie-element selecteert in de sectie Elementen van extensiepunt.
De sectie Elementdetails voor een extensie-element.
De sectie Elementdetails voor een niet-extensie-element.
Bewerk het veld Naam om de naam van het element op te geven.
Klik op de knoppen true of false, binnen het veld Intern om aan te geven of het een intern element betreft of niet. In de pluginmanifesteditor worden alle interne XML-markup-elementen van de extensie gemarkeerd met een waarschuwing (standaardwaarde). Dit veld komt overeen met het kenmerk x-internal van geëxporteerde pakketten.
Klik op true of false binnen het veld Gedeprecieerd om aan te geven of het element gedeprecieerd is of niet. In de pluginmanifesteditor wordt alle gedeprecieerde XML-markup-elementen van de extensie (standaard) gemarkeerd met een waarschuwing. Dit veld is vergelijkbaar met de Javadoc-tag @deprecated in Java.
Als een extensie-element is gemarkeerd als gedeprecieerd, geeft u in het veld Vervanging het niet-gedeprecieerde extensiepunt dat de gebruiker in plaats daarvan moet gebruiken om dezelfde functionaliteit te bereiken.
Selecteer een van de gedefinieerde kenmerken van het element in het veld Labeleigenschap om op te geven welke kenmerkwaarde u wilt gebruiken als label van het element in de pluginmanifesteditor. Als u bijvoorbeeld een waarde selecteert, ziet het label voor het knooppunt van het element in de sectie Alle extensies op de pagina Extensies in de pluginmanifesteditor er als volgt uit: geselecteerde-kenmerkwaarde (elementnaam). Als u geen waarde selecteert, ziet het label voor het knooppunt van het element er als volgt uit: (elementnaam).
Selecteer een van de gedefinieerde resourcetypekenmerken van het element in het veld Pictogram om op te geven welk pictogram moet worden gebruikt voor het elementknooppunt in de pluginmanifesteditor. Om het pictogram voor het knooppunt van het element correct te kunnen afbeelden in de sectie Alle extensies op de pagina Extensies in de pluginmanifesteditor, moet aan de volgende voorwaarden zijn voldaan:
Klik op true of false binnen het veld Vertaalbaar om aan te geven of de tekencontent van het element kan worden vertaald of niet. Dit veld is alleen bruikbaar voor elementen waarvoor geen onderliggende items (elementcontent) of kenmerken zijn opgegeven en waarvoor tekst kan worden opgegeven tussen begin- en eind-XML-tags (tekencontent). Als de tekencontent van een element is gemarkeerd als vertaalbaar, kunnen de tools van PDE worden toegepast op de XML-markup van de toegevoegde extensie om de content te externaliseren in een eigenschappenbestand voor meertalige ondersteuning.
Met het alleen-lezen veld DTD-benadering kunt u een één-op-één-koppeling tussen de schemagrammatica en de equivalente DTD-grammatica van het element bekijken. Een DTD (Document Type Definition) is een makkelijker te lezen, minder uitgebreid alternatief voor een XML-schema waarmee de formele grammatica van een XML-document kan worden opgegeven. Een DTD-benadering moet worden opgegeven in de volgende notatie:
In deze sectie kunt u de eigenschappen van een compositor bewerken. Er zijn twee soorten compositors: reekscompositors en keuzecompositors. Met een reekscompositor kunt u opgeven dat de onderliggende items van een element bestaan uit een reeks andere elementen in de grammatica van het schema dat wordt bewerkt. Met een keuzecompositor kunt u opgeven dat de onderliggende items van een element bestaan uit een keuze van andere elementen in de grammatica van het schema dat wordt bewerkt.
Deze sectie wordt geactiveerd door een Reeks- of Keuze-knooppunt te selecteren in de sectie Elementen van extensiepunt.
Bewerk het veld Min. voorvallen om het minimumaantal voorvallen op te geven dat deze compositor van andere elementen en/of compositors mag voorkomen in de XML-markup van de extensie. Deze veldwaarde wordt gebruikt in PDE voor de validatie van veelvoudigheidsbeperkingen in de pluginmanifesteditor. Als Element A precies één Element B of Element C als onderliggend item vereist en gebruikmaakt van een Keuze-compositor met een specificatie van minimaal 2 voorvallen, moeten er 2 instances van Element B in combinatie met Element C worden gedefinieerd in de XML-markup van de toegevoegde extensie om geldig te zijn.
Bewerk het veld Max. voorvallen om het maximumaantal voorvallen op te geven dat deze compositor van andere elementen en/of compositors mag voorkomen in de XML-markup van de extensie. Deze veldwaarde wordt gebruikt in PDE voor de validatie van veelvoudigheidsbeperkingen in de pluginmanifesteditor. Als Element A precies één Element B of Element C als onderliggend item vereist en gebruikmaakt van een Keuze-compositor met een specificatie van maximaal 2 voorvallen, kunnen er niet meer dan 2 instances van Element B in combinatie met Element C worden gedefinieerd in de XML-markup van de toegevoegde extensie om geldig te blijven.
Schakel het veld Niet begrensd in als u wilt opgeven dat er geen beperking is ten aanzien van het maximumaantal toegestane voorvallen dat deze compositor mag voorkomen in de XML-markup van de toegevoegde extensie.
Selecteer een waarde in het veld Type om aan te geven of deze compositor een reeks of keuze is.
Met het alleen-lezen veld DTD-benadering kunt u een één-op-één-koppeling tussen de schemagrammatica en de equivalente DTD-grammatica van de compositor bekijken. De notatie die wordt gebruikt om de DTD-benadering op te geven, wordt beschreven onder de kop Velden van de sectie Elementdetails in dit document.
In deze sectie kunt u de eigenschappen van een elementverwijzing bewerken. Een elementverwijzing is een verwijzing naar een algemene elementdeclaratie in de grammatica van het bewerkte schema. Elementverwijzingen worden door compositors gebruikt als bouwstenen voor de definitie van de grammatica voor algemene elementdeclaraties.
Deze sectie wordt geactiveerd door selectie van een elementverwijzing-knooppunt in de sectie Elementen van extensiepunt.
Bewerk het veld Min. voorvallen om het minimumaantal voorvallen op te geven dat dit element mag voorkomen in de XML-markup van de extensie. Deze veldwaarde wordt gebruikt in PDE voor de validatie van veelvoudigheidsbeperkingen in de pluginmanifesteditor. Als voor Element A een minimum van 2 voorvallen is opgegeven, moeten er instances van Element A worden gedefinieerd in de XML-markup van de toegevoegde extensie om geldig te zijn.
Bewerk het veld Max. voorvallen om het maximumaantal voorvallen op te geven dat dit element mag voorkomen in de XML-markup van de extensie. Deze veldwaarde wordt gebruikt in PDE voor de validatie van veelvoudigheidsbeperkingen in de pluginmanifesteditor. Als voor Element A een maximum van 2 voorvallen is opgegeven, mogen er niet meer dan 2 instances van Element A worden gedefinieerd in de XML-markup van de toegevoegde extensie om geldig te blijven.
Schakel het veld Niet begrensd in als u wilt opgeven dat er geen beperking is ten aanzien van het maximumaantal toegestane voorvallen dat dit element mag voorkomen in de XML-markup van de toegevoegde extensie.
Met het alleen-lezen veld DTD-benadering kunt u een één-op-één-koppeling tussen de schemagrammatica en de equivalente DTD-grammatica van het element bekijken. De notatie die wordt gebruikt om de DTD-benadering op te geven, wordt beschreven onder de kop Velden van de sectie Elementdetails in dit document.
Klik op de hyperlink van de elementnaam in het veld Verwijzing als u de eigenschappen van de algemene-elementdeclaratie waarnaar deze locale elementverwijzing verwijst wilt bewerken. Als deze actie is voltooid, wordt het knooppunt van het element waarnaar wordt verwezen, geselecteerd in de sectie Elementen van extensiepunt en wordt de bijbehorende sectie Elementdetails geactiveerd.
In deze sectie kunt u de eigenschappen van een kenmerk bewerken. Kenmerken worden gebruikt om aanvullende informatie over elementen te verstrekken.
Deze sectie wordt geactiveerd als u het knooppunt van een verplicht kenmerk, optioneel kenmerk, klassenkenmerk of resourcekenmerk selecteert in de sectie Elementen van extensiepunt.
De sectie Kenmerkdetails voor een verplicht kenmerk van het type tekenreeks waarin een opsommingsbeperking is opgegeven.
De sectie Kenmerkdetails voor een optioneel kenmerk van het type booleaanse waarde waarin een standaardwaarde is opgegeven.
De sectie Kenmerkdetails voor een klassenkenmerk dat aangeeft dat de klasse die door de kenmerkwaarde wordt vertegenwoordigd, de opgegeven klasse moet uitbreiden en/of de opgegeven interface moet implementeren.
De sectie Kenmerkdetails voor een resourcekenmerk.
Auteurs van extensiepunten kunnen kenmerken definiëren die verwijzen naar andere kenmerken. Dit doet u door voor de kenmerken van uw extensiepunten type ID in te stellen en het kenmerk te kiezen waarnaar wordt verwezen. Een voorbeeld hiervan is het extensiepunt org.eclipse.ui.handlers. Het kenmerk Opdracht-ID verwijst naar opdrachten die zijn gedefinieerd in het extensiepunt org.eclipse.ui.commands.
Ontwikkelaars van extensies die een afhandelingsroutine toevoegen, kunnen vervolgens een keuze maken uit alle geldige ID's voor het kenmerk Opdracht-ID. Voor ID's die niet bestaan, wordt een waarschuwing gegeven om de veel voorkomende fout te vermijden dat een ID verkeerd wordt gespeld.
Bewerk het veld Naam om de naam van het kenmerk op te geven.
Klik op true of false binnen het veld Gedeprecieerd om aan te geven of het kenmerk gedeprecieerd is of niet. In de pluginmanifesteditor wordt alle gedeprecieerde XML-markup-elementen van de extensie (standaard) gemarkeerd met een waarschuwing. Dit veld is vergelijkbaar met de Javadoc-tag @deprecated in Java.
Selecteer een waarde in het veld Gebruik om aan te geven of het kenmerk moet worden opgegeven voor het definiërende element in de XML-markup van de toegevoegde extensie. U kunt kiezen uit de volgende mogelijkheden:
In het veld Standaardwaarde kunt u de standaardwaarde voor het kenmerk opgeven die moet worden gebruikt als het kenmerk niet wordt opgegeven voor het definiërende element in de XML-markup van de toegevoegde extensie. Dit veld is alleen van toepassing als de waarde standaard is geselecteerd in het veld Gebruik.
Selecteer een waarde in het Type om het type kenmerkwaarde op te geven. U kunt kiezen uit de volgende mogelijkheden:
Klik op true of false binnen het veld Vertaalbaar om aan te geven of de tekencontent van het kenmerk kan worden vertaald of niet. Dit veld is alleen van toepassing als de waarde tekenreeks is geselecteerd in het veld Type. Als de waarde van een kenmerk is gemarkeerd als vertaalbaar, kunnen de tools van PDE worden toegepast op de XML-markup van de toegevoegde extensie om deze waarden te externaliseren in een eigenschappenbestand voor meertalige ondersteuning.
In het veld Beperkingen ziet u een lijst van tekenreeksen die mogen worden gebruikt als waarde voor dit kenmerk. Als dit veld geen waarden bevat, gelden er geen beperkingen ten aanzien van de kenmerkwaarde. Dit veld is alleen van toepassing als de waarde tekenreeks is geselecteerd in het veld Type. Opmerking: in de grammatica van het bewerkte schema wordt een opsommingsbeperking voor het basistype van de tekenreeks gebruikt om deze functionaliteit te configureren.
In het veld Uitbreiding van kunt u een volledig gekwalificeerde klassennaam op het klassenpad van het doelplatform opgeven (bijvoorbeeld org.eclipse.ui.part.EditorPart), die moet worden geklasseerd onder de klasse die is opgegeven als de kenmerkwaarde. PDE valideert de kenmerkwaarde van de klasse in de XML-markup van de toegevoegde extensie om te controleren of deze een uitbreiding is van de superklasse. Dit veld is alleen van toepassing als de waarde java is geselecteerd in het veld Type.
In het veld Implementeert kunt u de volledig gekwalificeerde naam van een interface op het klassenpad op het doelplatform opgeven (bijvoorbeeld org.eclipse.ui.IEditorPart) dat moet worden geïmplementeerd door de klasse die is opgegeven als de kenmerkwaarde. PDE valideert de kenmerkwaarde van de klasse in de XML-markup van de toegevoegde extensie om te controleren of deze de interface implementeert. Dit veld is alleen van toepassing als de waarde java is geselecteerd in het veld Type.
Klik op de knop Toevoegen... in het veld Beperkingen als u een nieuwe beperking aan de kenmerkwaarde wilt toevoegen. Het dialoogvenster Nieuwe beperking wordt geopend. Als u dit dialoogvenster hebt voltooid, wordt de nieuwe beperking toegevoegd aan de lijst van tekenreeksen die mogen worden gebruikt als waarde voor het kenmerk. Deze actie is alleen beschikbaar als de waarde tekenreeks is geselecteerd in het veld Type.
Selecteer een tekenreekswaarde in het veld Beperkingen en klik op Verwijderen als u een beperking wilt verwijderen uit de lijst van tekenreeksen die als waarde voor het kenmerk mogen worden gebruikt. Deze actie is alleen beschikbaar als de waarde tekenreeks is geselecteerd in het veld Type.
Als de waarde die is opgegeven in het veld Uitbreiding van verwijst naar een volledig gekwalificeerde klassennaam op het klassenpad van het doelplatform, wordt die klasse geopend in een nieuwe Java-broneditor als u op de hyperlink Uitbreiding van klikt. In alle andere gevallen wordt, als u op de hyperlink Uitbreiding van klikt, de wizard Nieuwe Java-klasse geopend zodat u de nieuwe klasse kunt definiëren. Deze actie is alleen beschikbaar als de waarde java is geselecteerd in het veld Type.
Als de waarde die is opgegeven in het veld Implementeert verwijst naar een volledig gekwalificeerde klassennaam op het klassenpad van het doelplatform, wordt die interface geopend in een nieuwe Java-broneditor als u op de hyperlink Implementeert klikt. In alle andere gevallen wordt, als u op de hyperlink Implementeert klikt, de wizard Nieuwe Java-klasse geopend zodat u de nieuwe interface kunt definiëren. Deze actie is alleen beschikbaar als de waarde java is geselecteerd in het veld Type.
Als u op de knop Bladeren... klikt, wordt het dialoogvenster Type selecteren geopend. In dit venster kunt u een bestaande klasse op het klassenpad van het doelplatform selecteren en deze gebruiken als waarde voor het veld Uitbreiding van. Deze actie is alleen beschikbaar als de waarde java is geselecteerd in het veld Type.
Als u op de knop Bladeren... klikt, wordt het dialoogvenster Type selecteren geopend. In dit venster kunt u een bestaande interface op het klassenpad van het doelplatform selecteren en deze gebruiken als waarde voor het veld Implementeert. Deze actie is alleen beschikbaar als de waarde java is geselecteerd in het veld Type.