Perspektivutvidelser
Identifikator:
org.eclipse.ui.perspectiveExtensions
Beskrivelse:
Dette utvidelsespunktet brukes til å utvide perspektiver
registrert av andre plugin-moduler. Et perspektiv definerer det første innholdet i vinduets handlingslinjer (meny
og verktøylinje) og det første settet med visninger og layouten deres på en arbeidsbenkside.
Andre plugin-moduler
kan bidra med handlinger eller visninger for perspektivet som blir vist når perspektivet er valgt. Andre
tillegg av andre plugin-moduler blir tilføyd til den første definisjonen.
Konfigurasjonskodetype:
<!ELEMENT extension (perspectiveExtension*)>
<!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 perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetID - den unike IDen for perspektivet (som oppgitt i registeret) som bidraget blir gjort i.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - den unike IDen til handlingssettet som blir lagt til i perspektivet.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - den unike IDen til visningen som blir lagt til i perspektivets undermeny "Vis visning" på
"Vindu"-menyen.
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - den unike IDen til perspektivet som blir lagt til i perspektivets undermeny "Åpne perspektiv"
på "Vindu"-menyen.
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - den unike IDen til den nye veiviseren som blir lagt til i perspektivets undermeny "Ny(tt)"
på "Fil"-menyen.
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - den unike IDen til visningen som blir lagt til i perspektivets forespørsel "Vis i..." på
Naviger-menyen.
<!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 - den unike IDen til visningen som blir lagt til i perspektivlayouten.
- relative - den unike IDen til en visning som allerede eksisterer i perspektivet. Denne vil bli brukt som et referansepunkt for plassering av visningen. Forholdet mellom disse to visningene er
definert av relationship. Ignorert hvis forholdet er "fast".
- relationship - oppgir forholdet mellom id og relative. Disse verdiene støttes:
fast - visningsutvidelsen blir opprettet som en hurtigvisning.
stack - visningsutvidelsen blir stablet sammen med den relative visningen i en mappe.
left, right, top, bottom - visningsutvidelsen blir plassert ved siden av den relative visningen. I dette
tilfellet må det også defineres en ratio.
- ratio - prosenten av område i den relative visningen som blir tildelt visningsutvidelsen. Hvis
visningsutvidelsen er en hurtigvisning, vil forholdet (ratio) være prosenten av arbeidsbenken som hurtigvisningen vil
dekke når den er aktiv. Dette må defineres som en flytetallverdi mellom 0,05 og 0,95.
- visible - om visningen til å begynne med er synlig når perspektivet åpnes. Dette attributtet skal ha verdien "true" eller "false" hvis
det blir brukt.
Hvis attributtet ikke blir brukt, er standardverdien at visningen er synlig til å
begynne med.
- closeable - om visningen kan lukkes i målperspektivet. Dette attributtet skal ha verdien "true" eller "false" hvis
det blir brukt. Hvis attributtet ikke blir brukt, kan visningen lukkes, hvis ikke selve perspektivet
er merket som fast (fixed).
- moveable - om visningen kan flyttes. En visning som ikke kan flyttes, kan ikke flyttes innenfor samme
mappe, eller flyttes mellom mapper i perspektivet. Dette attributtet skal ha verdien "true" eller "false" hvis
det blir brukt.
Hvis attributtet ikke blir brukt, kan visningen flyttes, hvis ikke selve perspektivet er merket som
fast (fixed).
- standalone - om visningen er en frittstående visning. En frittstående visning kan ikke forankres sammen
med andre i den samme mappen. Dette attributtet skal ha verdien "true" eller "false" hvis
det blir brukt. Dette
attributtet blir ignorert hvis forholdsattributtet er "fast" eller "stacked". Hvis attributtet ikke blir brukt,
vil visningen være en vanlig visning, ikke en frittstående visning (standardverdien er "false").
- showTitle - om visningstittelen blir vist. Dette attributtet skal ha verdien "true" eller "false" hvis
det blir brukt. Dette attributtet gjelder bare for frittstående visninger. Hvis attributtet ikke blir brukt, blir
visningens tittel vist (standardverdien er "true").
Eksempler:
Nedenfor finner du et eksempel på en perspektivutvidelse
(legg merke til underelementene og hvordan attributtene blir brukt).
<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>
I eksempelet over blir et handlingssett, en visningssnarvei, en snarvei for ny veiviser og snarveier for
perspektiver lagt til i det første innholdet i ressursperspektivet. I tillegg blir visningen Pakkeutforsker stablet
på ressursnavigatoren og typehierarkivisningen blir lagt til ved siden av ressursnavigatoren.
API-informasjon:
Elementene som er definert i perspektivutvidelsen, blir
lagt til i det første innholdet i målperspektivet. Deretter kan brukeren fjerne eventuelle bidrag eller
legge til andre i et perspektiv fra brukergrensesnittet til arbeidsbenken.
Copyright (c) 2002, 2004 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