Perspektivudvidelser
Id:
org.eclipse.ui.perspectiveExtensions
Beskrivelse:
Dette udvidelsespunkt bruges til at udvide perspektiver, der er registreret af andre plugins. Et perspektiv definerer startindholdet i vinduesfunktionslinjer (menu- og værktøjslinje) samt startsættet af oversigter og deres layout på en arbejdsbænksside.
Andre plugins kan tilføre funktioner eller oversigter til perspektivet, som vises, når perspektivet vælges. Valgfrie tilføjelser af andre plugins tilføjes efter startdefinitionen.
Konfigurationskode:
<!ELEMENT extension (perspectiveExtension*)>
<!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 perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetID - perspektivets entydige id (som angivet i registreringsdatabasen), som bidraget foretages til.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - den entydige id til det funktionssæt, som skal tilføjes til perspektivet.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - den entydige id til den oversigt, som skal tilføjes til perspektivets "Vis oversigt"-menu, der er en undermenu til menuen "Vindue".
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - den entydige id til det perspektiv, som skal tilføjes til perspektivets "Åbn perspektiv"-menu, der er en undermenu til menuen "Vindue".
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - den entydige id til den nye guide, som skal tilføjes til perspektivets "Ny"-menu, der er en undermenu til menuen "Fil".
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - den entydige id til den oversigt, som skal tilføjes til perspektivets "Vis i"-felt på menuen Navigér.
<!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 entydige id til den oversigt, som skal tilføjes til perspektivets layout.
- relative - den entydige id til en oversigt, som allerede findes i perspektivet. Den bruges som referencepunkt ved placering af oversigten. Forholdet mellem disse to oversigter defineres af relationship. Ignoreres, hvis forholdet er "fast".
- relationship - Angiver forholdet mellem id og relative.
Følgende værdier understøttes:
fast - oversigtsudvidelsen oprettes som en hurtig oversigt.
stack - oversigtsudvidelsen placeres i stak med den relative oversigt i en folder.
left, right, top, bottom - oversigtsudvidelsen placeres ved siden af den relative oversigt. I så fald skal der også defineres en ratio.
- ratio - den procentdel af arealet i den relative oversigt, som gives til oversigtsudvidelsen. Hvis oversigtsudvidelsen er en hurtig oversigt, er ratio den procentdel af arbejdsbænken, som den hurtige oversigt dækker, når den er aktiv. Dette skal defineres som en værdi med flydende decimaltegn og ligge mellem 0,05 og 0,95.
- visible - om oversigten er synlig til at begynde med, når perspektivet åbnes. Denne attribut skal have værdien "true" eller "false", hvis den bruges. Hvis attributten ikke bruges, er oversigten som standard synlig til at begynde med.
- closeable - om oversigten kan lukkes i målperspektivet. Denne attribut skal have værdien "true" eller "false", hvis den bruges. Hvis attributten ikke bruges, kan oversigten som standard lukkes, medmindre perspektivet selv er valgte som fast.
- moveable - om oversigten kan flyttes. En ikke-flytbar oversigt kan hverken flyttes inden for samme folder eller mellem foldere i perspektivet. Denne attribut skal have værdien "true" eller "false", hvis den bruges. Hvis attributten ikke bruges, kan oversigten som standard flyttes, medmindre perspektivet selv er valgte som fast.
- standalone - om oversigten er en enkeltstående oversigt. En enkeltstående oversigt kan ikke fastgøres sammen med andre oversigter i samme folder. Denne attribut skal have værdien "true" eller "false", hvis den bruges. Attributten ignoreres, hvis attributten relationship er "fast" eller "stacked". Hvis attributten ikke bruges, er oversigten som standard en almindelig oversigt, ikke en enkeltstående oversigt (standardværdien er "false").
- showTitle - om oversigtens titel vises. Denne attribut skal have værdien "true" eller "false", hvis den bruges. Attributten gælder kun for enkeltstående oversigter. Hvis attributten ikke bruges, bliver oversigtens titel som standard vist (standardværdien er "true").
Eksempler:
Her er et eksempel på en perspektivudvidelse (bemærk underelementerne og den måde attributterne bruges på):
<udvidelsespunkt=
"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 ovenstående eksempel tilføres et funktionssæt, en genvej til en oversigt, en genvej til en ny guide og en genvej til et perspektiv til indholdet af ressourceperspektivet. Desuden stables oversigten Package Explorer på ressourcenavigatoren, og typehierarkioversigten tilføjes ved siden af ressourcenavigatoren.
API-oplysninger:
Elementerne, defineret i perspektivudvidelsen, tilføres startindholdet af målperspektivet. Derfor kan brugeren fjerne ethvert bidrag eller tilføje andre bidrag til perspektivet fra arbejdsbænkens brugergrænseflade.
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