Visninger
Identifikator:
org.eclipse.ui.views
Beskrivelse:
Dette utvidelsespunktet blir brukt til å definere andre
visninger for arbeidsbenken. En visning er en visuell komponent på en arbeidsbenkside. Den brukes vanligvis til å
navigere i et informasjonshierarki (som arbeidsområdet), åpne et redigeringsprogram eller vise
egenskaper for det aktive redigeringsprogrammet. Brukeren kan gjøre en visning synlig fra Vindu > Vis
visning-menyen eller lukke den fra visningens lokale tittelinje.
Visninger bør grupperes ved hjelp av kategorier for å redusere den visuelle uordenen i dialogboksen Vis visning.
Konfigurasjonskodetype:
<!ELEMENT extension (category | view | stickyView)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - en fullt kvalifisert ID for målutvidelsespunktet
- id - en valgfri ID for utvidelsesforekomsten
- name - et valgfritt navn på utvidelsesforekomsten
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - et unikt navn som skal brukes til å identifisere denne kategorien
- name - et navn som kan oversettes, som skal brukes i brukergrensesnittet for denne kategorien
- parentCategory - en valgfri bane som består av kategori-IDer skilt av '/'. Dette gjør det mulig å
opprette et hierarki av 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 unikt navn som skal brukes til å identifisere denne visningen
- name - et navn som kan oversettes, som skal brukes i brukergrensesnittet for denne visningen
- category - et valgfritt attributt som består av kategori-IDene skilt av '/'. Hver referansekategori må
deklareres i et tilsvarende kategorielement.
- class - et fullt kvalifisert navn på klassen som implementerer org.eclipse.ui.IViewPart. Det
er vanlig å opprette en subklasse av org.eclipse.ui.part.ViewPart for at standardfunksjonaliteten skal arves.
- icon - et relativt navn på ikonet som skal knyttes til denne visningen.
- fastViewWidthRatio - hvor stor prosent av bredden på arbeidsbenken som visningen opptar som en aktiv
hurtigvisning.
Dette må defineres som en flytetallverdi mellom 0,05 og 0,95.
Hvis det ikke er oppgitt en verdi,
blir et standardforhold brukt.
- allowMultiple - et flagg som viser om denne visningen tillater at det opprettes flere forekomster
med IWorkbenchPage.showView(String id, String secondaryId). Standardverdien er "false".
<!ELEMENT description (#PCDATA)>
et valgfritt underelement der hoveddelen skal inneholde tekst som gir en kort beskrivelse av visningen.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
En klebrig visning er en visning som blir vist som standard på tvers av alle perspektivene i et vindu når det
åpnes. Den første plasseringen blir styrt av plasseringsattributtet, men det er ingenting i veien for at den kan
flyttes eller lukkes av brukeren. Bruk av dette elementet fører bare til at det blir opprettet en plassholder for
visningen. Visningen blir ikke vist. Du bør være veldig forsiktig når du bruker dette elementet. Det bør bare
brukes for visninger du virkelig trenger på tvers av perspektiver. Siden 3.0
- id - IDen til visningen som skal være klebrig.
- location - valgfritt attributt som oppgir plasseringen av den klebrige visningen relativt til
redigeringsområdet. Hvis det mangler, blir visningen forankret til høyre i redigeringsområdet.
- closeable - valgfritt attributt som oppgir om det skal være mulig å lukke visningen. Hvis det mangler,
er det mulig å lukke den.
- moveable - valgfritt attributt som oppgir om det skal være mulig å flytte visningen. Hvis det mangler,
er det mulig å flytte den.
Eksempler:
Nedenfor finner du et eksempel på utvidelsespunktet.
<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>
Nedenfor finner du et eksempel på en deklarasjon for klebrig visning.
<extension point=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
API-informasjon:
Verdien av class-attributtet må være et
fullt kvalifisert navn på klassen som implementerer org.eclipse.ui.IViewPart. Det er vanlig praksis å
opprette en subklasse av org.eclipse.ui.part.ViewPart ved utvikling av en ny visning.
Levert implementering:
Eclipse-plattformen har en rekke
standardvisninger, inkludert Navigator, Egenskaper, Disposisjon og Oppgaver. Fra brukerens synspunkt er ikke
disse visningene annerledes enn andre visninger levert av plugin-modulene. Alle visningene kan vises fra
undermenyen "Vis visning" på menyen "Vindu". Plasseringen av en visning er fast: den blir lagret når
visningen lukkes, og gjenopprettet når visningen åpnes igjen i en enkeltsesjon. Plasseringen er også fast mellom
arbeidsbenksesjoner.
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