Perspektiivilaajennukset
Tunnus:
org.eclipse.ui.perspectiveExtensions
Kuvaus:
Tämä laajennuspiste on muiden lisäosien avulla
rekisteröityjen perspektiivien laajennus. Perspektiivi
määrittää ikkunan toimintopalkkien (valikoiden ja työkalurivin)
perussisällön sekä työympäristön sivun perusnäkymät
ja niiden asettelun.
Muut lisäosat voivat lisätä perspektiivin toimintoja tai näkymiä,
jotka tulevat näkyviin, kun perspektiivi
valitaan. Muiden lisäosien valinnaiset lisäykset
liitetään perusmääritykseen.
Merkintärakenne:
<!ELEMENT extension (perspectiveExtension*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - kohdelaajennuspisteen tarkka tunnus.
- id - laajennuksen ilmentymän valinnainen tunnus.
- name - laajennuksen ilmentymän valinnainen nimi.
<!ELEMENT perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetID - sen perspektiivin rekisteriin määritetty yksilöllinen tunnus, johon lisäys tehdään.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - sen toimintojoukon yksilöllinen tunnus, joka lisätään perspektiiviin.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - sen näkymän yksilöllinen tunnus, joka lisätään perspektiivin Ikkuna-valikon Näytä näkymä -alivalikkoon.
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - sen perspektiivin yksilöllinen tunnus, joka lisätään perspektiivin Ikkuna-valikon Avaa perspektiivi -alivalikkoon.
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - sen uuden ohjatun toiminnon yksilöllinen tunnus, joka lisätään perspektiivin Tiedosto-valikon Uusi-alivalikkoon.
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - sen näkymän yksilöllinen tunnus, joka lisätään perspektiivin Siirry-valikon Näytä kohteessa -kehotteessa.
<!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 - sen näkymän yksilöllinen tunnus, joka lisätään perspektiiviasetteluun.
- relative - perspektiivin olemassa olevan näkymän yksilöllinen tunnus. Tätä arvoa käytetään näkymän sijoittamisen viitepisteenä. Relationship-arvo määrittää näiden kahden näkymän välisen suhteen. Jos suhdemääritys on fast, tämä määritys ohitetaan.
- relationship - määrittää id- ja
relative-arvojen mukaisten objektien välisen suhteen.
Tuetut arvot ovat seuraavat:
fast - näkymälaajennus luodaan pikanäkymänä.
stack - näkymälaajennus sijoitetaan relative-arvon mukaisen näkymän
päälle.
left, right, top, bottom - näkymälaajennus sijoitetaan relative-arvon mukaisen
näkymän ylä- (top) tai alapuolelle (bottom) tai sen oikealle (right) tai vasemmalle (left) puolelle. Tätä arvoa käytettäessä on määritettävä myös
ratio-arvo.
- ratio - se prosenttiosuus relative-arvon mukaisen näkymän alueesta, joka varataan näkymälaajennusta varten. Jos näkymälaajennus on pikanäkymä, tämä arvo on se prosenttiosuus työympäristöstä, jonka käytössä oleva pikanäkymä peittää. Tämän arvo on oltava liukuluku 0,05 - 0,95.
- visible - määrittää, onko näkymä näkyvissä, kun perspektiivi avataan. Tämän määritteen kelvolliset arvot ovat true (tosi) tai false (epätosi).
Jos tälle määritteelle ei ole annettu arvoa, näkymä on oletusarvon mukaan näkyvissä perustilassa.
- closeable - määrittää, voiko näkymän sulkea kohdeperspektiivissä. Tämän määritteen kelvolliset arvot ovat true (tosi) tai false (epätosi). Jos tälle määritteelle ei anneta arvoa, näkymän voi sulkea, ellei perspektiiviä ole määritetty kiinteäksi (fixed).
- moveable - määrittää, voiko näkymää siirtää. Jos näkymää ei ole määritetty siirrettäväksi, sitä ei voi siirtää kansion sisällä eikä perspektiivin kansioiden välillä. Tämän määritteen kelvolliset arvot ovat true (tosi) tai false (epätosi).
Jos tälle määritteelle ei ole annettu arvoa, näkymää voi siirtää, ellei perspektiiviä ole määritetty kiinteäksi.
- standalone - määrittää, onko näkymä erillinen näkymä. Erillistä näkymää ei voi telakoida muihin saman kansion näkymiin. Tämän määritteen kelvolliset arvot ovat true (tosi) tai false (epätosi). Tämän määritteen arvo ohitetaan, jos relationship-määritteen arvo on fast tai stacked. Jos tälle määritteelle ei ole annettu arvoa, näkymää ei käsitellä erillisenä näkymänä vaan normaalina näkymänä (oletusarvo on false).
- showTitle - määrittää, onko näkymän otsikko näkyvissä. Tämän määritteen kelvolliset arvot ovat true (tosi) tai false (epätosi). Tämä määrite koskee vain erillisiä näkymiä. Jos tälle määritteelle ei ole annettu arvoa, näkymän otsikko on näkyvissä (oletusarvo on true).
Esimerkkejä:
Seuraavassa on perspektiivilaajennuksen esimerkki (huomaa, miten alielementtejä ja määritteitä on käytetty):
<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>
Edellä kuvatussa esimerkissä resurssiperspektiivin
perussisältöön lisätään toimintojoukko sekä näkymän,
uuden ohjatun toiminnon ja perspektiivin
pikavalinnat. Lisäksi pakettien selausnäkymä
määritetään asetettavaksi resurssien selausnäkymän
päälle ja lajihierarkianäkymä resurssien selausnäkymän
viereen.
API-tiedot:
Perspektiivilaajennuksessa määritetyt objektit lisätään kohdeperspektiivin perussisältöön. Käyttäjä voi poistaa perspektiivistä muokkauksia tai lisätä siihen muokkauksia työympäristön käyttöliittymän avulla.
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