Oversigter
Id:
org.eclipse.ui.views
Beskrivelse:
Dette udvidelsespunkt bruges til at definere yderligere oversigter til arbejdsbænken. En oversigt er en visuel komponent på en arbejdsbænksside. Den bruges typisk til at navigere i et hierarki af oplysninger (f.eks. arbejdsområdet), åbne en editor eller vise egenskaber for den aktive editor. Brugeren kan gøre en oversigt synlig fra menuen Vindue > Vis oversigt eller lukke den fra oversigtens lokale titellinje.
For at reducere det rodede indtryk i dialogboksen Vis oversigt kan oversigter grupperes vha. kategorier.
Konfigurationskode:
<!ELEMENT extension (category | view | stickyView)*>
<!ATTLIST-udvidelse
point CDATA #REQUIRED
id CDATA #IMPLIED
navn CDATA #IMPLIED>
- point - en fuldstændig id for måludvidelsespunktet.
- id - en valgfri id for udvidelsesforekomsten.
- name - et valgfrit navn på udvidelsesforekomsten.
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - et entydigt navn, der skal bruges til at identificere kategorien.
- name - et konvertérbart navn, der skal bruges i brugergrænsefladen til kategorien.
- parentCategory - en valgfri sti, der består af kategori-id'er, adskilt af '/'. Dette giver også mulighed for at oprette et hierarki af kategorier.
<!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 - et entydigt navn, der skal bruges til at identificere oversigten.
- name - et konvertérbart navn, der skal bruges i brugergrænsefladen til oversigten.
- category - en valgfri attribut, der består af kategori-id'erne, adskilt af '/'. Alle kategorier, der refereres til, skal være erklæret i et tilsvarende kategorielement.
- class - et fuldstændigt navn på den klasse, der implementerer org.eclipse.ui.IViewPart. Det er almindelig praksis at oprette en underklasse af org.eclipse.ui.part.ViewPart for at overtage standardfunktionaliteten.
- icon - et relativt navn på den ikon, der knyttes til oversigten.
- fastViewWidthRatio - den procentdel af arbejdsbænkens bredde, som oversigten vil optage som en aktiv hurtig oversigt. Dette skal defineres som en værdi med flydende decimaltegn og ligge mellem 0,05 og 0,95. Hvis der ikke leveres en værdi, anvendes standardforholdet.
- allowMultiple - flag, der angiver, om denne oversigt giver mulighed for oprettelse af flere forekomster vha. IWorkbenchPage.showView(String id, String secondaryId). Standardværdien er false.
<!ELEMENT description (#PCDATA)>
Et valgfrit underelement, der indeholder en kort beskrivelse af oversigten.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
En fastgjort oversigt er en oversigt, der vises som standard på tværs af alle perspektiver i et vindue, når det er åbnet. Dens startplacering styres af placeringsattributten, men der er intet, som forhindrer, at den flyttes eller lukkes af brugeren. Når dette element bruges, oprettes der en pladsholder for oversigten. Oversigten bliver altså ikke vist. Bemærk, at du bør anvende dette element med forsigtighed. Det bør kun anvendes på oversigter, der har et reelt behov for at blive vist på tværs af perspektiver.
Siden 3.0
- id - Id'en for den oversigt, der skal fastgøres.
- location - valgfri attribut, der angiver placeringen af den fastgjorte oversigt i forhold til editorområdet. Hvis attributten ikke angives, bliver oversigten fastgjort til højre for editorområdet.
- closeable - valgfri attribut, der angiver, om oversigten skal kunne lukkes. Hvis attributten ikke angives, kan oversigten lukkes.
- moveable - valgfri attribut, der angiver, om oversigten skal kunne flyttes. Hvis attributten ikke angives, kan oversigten flyttes.
Eksempler:
Her er et eksempel på udvidelsespunktet:
<udvidelsespunkt=
"org.eclipse.ui.views"
>
<category
id=
"com.xyz.views.XYZviews"
name=
"XYZ"
/>
<view
id=
"com.xyz.views.XYZView"
name=
"XYZ-oversigt"
category=
"com.xyz.views.XYZviews"
class=
"com.xyz.views.XYZView"
icon=
"icons/XYZ.gif"
/>
</extension>
Her er et eksempel på en erklæring til en fastgjort oversigt:
<udvidelsespunkt=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
API-oplysninger:
Værdien af attributten class skal være et fuldstændigt navn på en klasse, der implementerer org.eclipse.ui.IViewPart. Det er almindelig praksis at oprette en underklasse af org.eclipse.ui.part.ViewPart ved udvikling af en ny oversigt.
Leveret implementering:
Eclipse-platformen indeholder et antal standardoversigter, herunder Navigator, Egenskaber, Struktur og Opgaver. Fra brugerens synspunkt adskiller disse oversigter sig ikke fra andre oversigter, leveret af de forskellige plugins. Alle oversigterne kan vises fra menuen "Vis oversigt", der er en undermenu til menuen "Vindue". Placeringen af en oversigt bevares: Den gemmes, når oversigten lukkes, og gendannes, når oversigten åbnes igen i en enkelt session. Placeringen bevares også mellem arbejdsbænkssessioner.
Copyright (c) 2002, 2005 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made
available under the terms of the Eclipse Public License v1.0 which accompanies
this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html