Perspektivutökningar
ID:
org.eclipse.ui.perspectiveExtensions
Beskrivning:
Den här utökningspunkten används för att utöka perspektiv som registrerats av andra insticksprogram. Ett perspektiv definierar det innehåll som först visas i fönstrets åtgärdsfält (menyrad och verktygsfält) och den ursprungliga uppsättningen vyer med respektive layout på en sida i arbetsmiljön.
Andra insticksprogram kan tillhandahålla åtgärder och vyer som visas när perspektivet väljs. Valfria tillägg från andra insticksprogram läggs till i den ursprungliga definitionen.
Konfigurationsmärkordsuppsättning:
<!ELEMENT extension (perspectiveExtension*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - ett fullständigt ID för målutökningspunkten
- id - ett valfritt ID för utökningsförekomsten
- name - ett valfritt namn på utökningsförekomsten
<!ELEMENT perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetID - unikt ID för det perspektiv (enligt registret) där tillägget görs.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - unikt ID för den åtgärdsuppsättning som läggs till i perspektivet.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - unikt ID för den vy som läggs till på perspektivets undermeny "Visa vy" på menyn "Fönster".
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - unikt ID för den vy som läggs till på perspektivets undermeny "Öppna perspektiv" på menyn "Fönster".
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - unikt ID för den nya guide som läggs till på perspektivets undermeny "Nytt" på menyn "Arkiv".
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - unikt ID för den vy som läggs till i "Visa i" på menyn Navigera.
<!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 - unikt ID för den vy som läggs till perspektivets layout.
- relative - unikt ID för den vy som redan finns i perspektivet. Används som referenspunkt för placering av vyn. Relationen mellan de två vyerna definieras av relationship. Ignoreras om värdet för relationship är "fast".
- relationship - anger relationen mellan id och relative. Följande värden kan användas:
fast - vyutökningen skapas som en snabbvy.
stack - vyutökningen staplas i en mapp med den relativa vyn.
left, right, top, bottom - vyutökningen placeras bredvid den relativa vyn. I det här fallet måste även ratio anges.
- ratio - andel (i procent) av området i den relativa vyn som anslås till vyutökningen. Om vyutökningen är en snabbvy är "ratio" den procentandel av arbetsmiljön som snabbvyn kommer att uppta när den är aktiv. Värdet måste anges som ett flyttal och ligga mellan 0,05 och 0,95.
- visible - anger om vyn ska visas när perspektivet öppnas. Attributet har värdet "true" eller "false" när det används.
Om attributet inte används visas vyn som standard när perspektivet öppnas.
- closeable - anger om vyn kan stängas i målperspektivet. Attributet har värdet "true" eller "false" när det används. Om attributet inte används kan vyn stängas om inte själva perspektivet har markerats som fast.
- moveable - anger om vyn är flyttbar. En vy som inte är flyttbar kan varken flyttas inom en mapp eller mellan mappar i perspektivet. Attributet har värdet "true" eller "false" när det används.
Om attributet inte används kan vyn flyttas om inte själva perspektivet har markerats som fast.
- standalone - anger om vyn är en fristående vy. En fristående vy kan inte dockas med andra vyer i samma mapp. Attributet har värdet "true" eller "false" när det används. Attributet ignoreras om attributet "relationship" har värdet "fast" eller "stacked". Om vyn inte används är vyn en vanlig vy och inte en fristående (standard är "false").
- showTitle - anger om vyns titel visas. Attributet har värdet "true" eller "false" när det används. Attributet gäller endast för fristående vyer. Om vyn inte används visas vyns titel (standard är "true").
Exempel:
Här följer ett exempel på en perspektivutökning (lägg märke till underelementen och hur attributen används):
<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 ovanstående exempel läggs en åtgärdsuppsättning, en genväg till en vy, en ny guide och ett perspektiv till i det ursprungliga innehållet i resursperspektivet. Dessutom staplas vyn Paketutforskaren i navigeringsvyn för resurser och typhierarkivyn läggs till bredvid navigeringsvyn.
API-information:
De objekt som definieras i perspektivutökningen läggs till i målperspektivets ursprungliga innehåll. Användaren kan sedan efter eget önskemål flytta, ta bort och lägga till objekt i ett perspektiv från arbetsmiljöns användargränssnitt.
Copyright (c) 2002, 2004 IBM Corporation and others.
All rights
reserved. Detta program och medföljande material tillhandahålls under villkoren för Eclipse Public License v1.0 som medföljer denna distribution och finns tillgänglig på
http://www.eclipse.org/legal/epl-v10.html