Views
ID:
org.eclipse.ui.views
Beschrijving:
Dit extensiepunt wordt gebruikt om meer views voor de workbench te definiëren. Een view is een visuele component binnen de workbench. Een view wordt meestal gebruikt om te navigeren in een hiërarchie van informatie (zoals het werkgebied), om een editor te openen of om eigenschappen af te beelden voor de actieve editor.
De gebruiker kan een view openen met de menuoptie Venster > View afbeelden en weer sluiten vanuit de titelbalk van de view.
Om de hoeveelheid visuele informatie in het dialoogvenster View afbeelden te beperken, moeten de views in categorieën zijn gegroepeerd.
Configuratiemarkup:
<!ELEMENT extension (category | view | stickyView)*>
<!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 category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - een unieke naam die wordt gebruikt om deze categorie te identificeren.
- name - een vertaalbare naam die voor deze categorie wordt gebruikt in de gebruikersinterface.
- parentCategory - een optioneel pad dat bestaat uit categorie-ID's, gescheiden door het teken '/'. Op deze manier kan een hiërarchie van categorieën worden gemaakt.
<!ELEMENT view (description?)>
<!ATTLIST view
id CDATA #REQUIRED
name CDATA #REQUIRED
category CDATA #IMPLIED
class CDATA #REQUIRED
icon CDATA #IMPLIED
fastViewWidthRatio CDATA #IMPLIED
allowMultiple (true | false) >
- id - een unieke naam die wordt gebruikt om deze view te identificeren.
- name - een vertaalbare naam die voor deze view wordt gebruikt in de gebruikersinterface.
- category - een optioneel kenmerk dat is samengesteld uit de categorie-ID's, gescheiden door het teken '/'. Iedere gebruikte categorie moet worden gedeclareerd in een corresponderend categorie-element.
- class - de volledig gekwalificeerde naam van een klasse die org.eclipse.ui.IViewPart implementeert. Het is gebruikelijk om org.eclipse.ui.part.ViewPart een subklasse te maken, zodat deze de standaardfunctionaliteit overneemt.
- icon - de relatieve naam van het pictogram dat aan de view gekoppeld is.
- fastViewWidthRatio - de breedte van de workbench (in procenten) die de view inneemt als actieve snelview. Deze moet worden gedefinieerd als drijvendekommawaarde tussen 0,05 en 0,95.
Als er geen waarde is opgegeven, wordt een standaardverhouding gebruikt.
- allowMultiple - vlag die aangeeft of deze view het maken van meerdere instances met IWorkbenchPage.showView(String id, String secondaryId) ondersteunt. De standaardwaarde is 'false' (onwaar).
<!ELEMENT description (#PCDATA)>
een optioneel subelement waarvan het corpus een korte beschrijving van de view dient te bevatten.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
Een sticky view is een view die standaard wordt afgebeeld in alle perspectieven in een venster zodra het wordt geopend. De beginlocatie wordt bepaald door het kenmerk location, maar hierna kan de gebruiker de view verplaatsen of sluiten. Dit element maakt alleen een plaatshouder voor de te maken view, de view zelf wordt niet weergegeven. Gebruik dit element weloverwogen en alleen voor views die echt in alle perspectieven afgebeeld moeten worden. Vanaf 3.0
- id - het ID van de sticky view.
- location - optioneel kenmerk waarmee de locatie van de sticky view ten opzichte van het editorgebied wordt aangegeven. Als dit kenmerk ontbreekt, wordt de view rechts van het editorgebied geplaatst.
- closeable - optioneel kenmerk waarmee wordt aangegeven of de view sluitbaar is.Als dit kenmerk ontbreekt, is de view sluitbaar.
- moveable - optioneel kenmerk waarmee wordt aangegeven of de view verplaatsbaar is. Als dit kenmerk ontbreekt, is de view verplaatsbaar.
Voorbeelden:
Dit is een voorbeeld van de extensie views:
<extension point=
"org.eclipse.ui.views"
>
<category
id=
"com.xyz.views.XYZviews"
name=
"XYZ"
/>
<view
id=
"com.xyz.views.XYZView"
name=
"XYZ View"
category=
"com.xyz.views.XYZviews"
class=
"com.xyz.views.XYZView"
icon=
"icons/XYZ.gif"
/>
</extension>
Een voorbeeld van de declaratie van een sticky view:
<extension point=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
API-informatie:
Het kenmerk class moet de volledig gekwalificeerde naam zijn van de klasse die org.eclipse.ui.IViewPart implementeert. Het is gebruikelijk om org.eclipse.ui.part.ViewPart een subklasse te maken bij het ontwikkelen van een nieuwe view.
Verstrekte implementatie:
Het platform Eclipse biedt een aantal standaardviews, waaronder Navigator, Eigenschappen, Overzicht en Taken. Vanuit het gezichtspunt van de gebruiker verschillen deze views niet van de views die door plugins ter beschikking worden gesteld. Al deze views kunnen worden weergegeven vanuit het submenu "View afbeelden" of het menu "Venster". De positie van de view is vast: de positie wordt opgeslagen als de view wordt gesloten en teruggezet als de view in dezelfde sessie weer wordt geopend. De positie wordt ook gehandhaafd in workbenchsessies.
Copyright (c) 2002, 2005 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.