Extensies voor perspectieven
ID:
org.eclipse.ui.perspectiveExtensions
Beschrijving:
Dit extensiepunt wordt gebruikt voor het uitbreiden van perspectieven die door andere plugins zijn geregistreerd. Een perspectief definieert de begininhoud van de menu's en werkbalken in een venster. Ook definieert een perspectief de beginviews en hun inhoud in een workbenchpagina. Andere plugins kunnen acties of views voor het perspectief aanleveren, die worden afgebeeld als het perspectief wordt geselecteerd. Optionele toevoegingen door andere plugins worden aan de begindefinitie toegevoegd.
Configuratiemarkup:
<!ELEMENT extension (perspectiveExtension*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - een volledig gekwalificeerd ID van het doelextensiepunt.
- id - een optioneel ID van de extensie-instance.
- name - een optionele naam van de extensie-instance.
<!ELEMENT perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetID - het unieke ID van het perspectief (opgegeven in het register) waarvoor de aanlevering bestemd is.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - het unieke ID van de actieset die aan het perspectief wordt toegevoegd.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - het unieke ID van de actieset die wordt toegevoegd aan het submenu "View weergeven" van het menu Venster.
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - het unieke ID van het perspectief dat wordt toegevoegd aan het submenu "Perspectief openen" van het menu Venster.
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - het unieke ID van de nieuwe wizard die wordt toegevoegd aan het submenu Nieuw van het menu Venster.
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - het unieke ID van de view die wordt toegevoegd aan het submenu "Afbeelden in..." van het menu Navigeren.
<!ELEMENT view EMPTY>
<!ATTLIST view
id CDATA #REQUIRED
relative CDATA #IMPLIED
relationship (stack|left|right|top|bottom|fast)
ratio CDATA #IMPLIED
visible (true | false)
closeable (true | false)
moveable (true | false)
standalone (true | false)
showTitle (true | false) >
- id - het unieke ID van de view die aan de layout van het perspectief wordt toegevoegd.
- relative - het unieke ID van een view die al in het perspectief is opgenomen. Dit wordt gebruikt als referentiepunt voor het plaatsen van de view. De relatie tussen de twee views wordt gedefinieerd door relationship. Wordt genegeerd als de relatie is gedefinieerd als "fast".
- relationship - geeft de relatie tussen id en relative aan. De volgende waarden worden ondersteund:
fast - de viewextensie wordt gemaakt als snelle view.
stack - de viewextensie wordt met de relatieve view in een stapel opgeslagen in een map.
left, right, top, bottom - de viewextensie wordt naast de relatieve view geplaatst. In dit geval moet ook de ratio worden gedefinieerd.
- ratio - het percentage van het gebied in de relatieve view dat voor de viewextensie wordt gereserveerd. Als de viewextensie een snelle view is, is de verhouding het percentage van de workbench dat de snelle view inneemt. De verhouding moet worden gedefinieerd als een waarde met drijvende komma tussen 0,05 en 0,95.
- visible - bepaalt of de view zichtbaar is als het perspectief wordt geopend. Als het kenmerk wordt gebruikt, moet het de waarde "true" of "false" hebben. Als het kenmerk niet wordt gebruikt, is de view standaard in eerste instantie zichtbaar.
- closeable - bepaalt of de view gesloten kan worden in het doelperspectief. Als het kenmerk wordt gebruikt, moet het de waarde "true" of "false" hebben. Als het kenmerk niet wordt gebruikt, is de view sluitbaar, tenzij het perspectief zelf als vast is gedefinieerd.
- moveable - bepaalt of de view verplaatsbaar is. Een niet-verplaatsbare view kan in een perspectief niet worden verplaatst binnen dezelfde map of van de ene map naar de andere. Als het kenmerk wordt gebruikt, moet het de waarde "true" of "false" hebben. Als het kenmerk niet wordt gebruikt, is de view verplaatsbaar, tenzij het perspectief zelf als vast is gedefinieerd.
- standalone - bepaalt of de view zelfstandig is. Een zelfstandige view kan niet aan andere in dezelfde map worden gekoppeld. Als het kenmerk wordt gebruikt, moet het de waarde "true" of "false" hebben. Het kenmerk wordt genegeerd als het relatiekenmerk "fast" of "stacked" is. Als het kenmerk niet wordt gebruikt, is de view normaal en niet zelfstandige (standaard is "false").
- showTitle - bepaalt of de titel van de view wordt afgebeeld. Als het kenmerk wordt gebruikt, moet het de waarde "true" of "false" hebben. Het kenmerk is alleen van toepassing op zelfstandige views. Als het kenmerk niet wordt gebruikt, wordt de titel van de view afgebeeld (standaard is "true").
Voorbeelden:
Dit is een voorbeeld van de extensie perspectiveExtensions (let op de subelementen en d e manier waarop de kenmerken worden gebruikt):
<extension point=
"org.eclipse.ui.perspectiveExtensions"
>
<perspectiveExtension
targetID=
"org.eclipse.ui.resourcePerspective"
>
<actionSet id=
"org.eclipse.jdt.ui.JavaActionSet"
/>
<viewShortcut id=
"org.eclipse.jdt.ui.PackageExplorer"
/>
<newWizardShortcut id=
"org.eclipse.jdt.ui.wizards.NewProjectCreationWizard"
/>
<perspectiveShortcut id=
"org.eclipse.jdt.ui.JavaPerspective"
/>
<view id=
"org.eclipse.jdt.ui.PackageExplorer"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"stack"
/>
<view id=
"org.eclipse.jdt.ui.TypeHierarchy"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"left"
ratio=
"0.50"
/>
</perspectiveExtension>
</extension>
In het bovenstaande voorbeeld worden een actieset en snelkoppelingen naar de view, een nieuwe wizard en het perspectief toegevoegd aan de begininhoud van het perspectief Resource. Verder wordt de view Pakketverkenner gestapeld op de Resourcenavigator en de view Typehiërarchie wordt toegevoegd naast de Resourcenavigator.
API-informatie:
De items die in de perspectiefextensie zijn gedefinieerd, worden toegevoegd aan de begininhoud van het doelperspectief. Hierna kan een gebruiker toevoegingen verwijderen of andere toevoegen vanuit de gebruikersinterface van de workbench.
Copyright (c) 2002, 2004 IBM Corporation en anderen.
Alle rechten voorbehouden. Dit programma en het begeleidende materiaal zijn beschikbaar gesteld onder de voorwaarden van de Eclipse Public License v1.0 die bij deze distributie is geleverd en beschikbaar is op http://www.eclipse.org/legal/epl-v10.html.