Näkymät
Tunnus:
org.eclipse.ui.views
Kuvaus:
Tämän laajennuspisteen avulla määritetään työympäristön lisänäkymät. Näkymä on työympäristösivun sisältämä graafinen komponentti. Tavallisesti sen avulla
selataan tietohierarkioita (kuten työtilaa),
avataan muokkausohjelma tai näytetään
aktiivisen muokkausohjelman ominaisuudet. Käyttäjä saa näkymän
näkyviin valikosta Ikkuna > Näytä näkymä tai hän voi sulkea sen
näkymän paikalliselta otsikkoriviltä.
Näkymät olisi ryhmitettävä luokkiin, jottei Näytä näkymä -valintaikkuna olisi graafisesti sekava.
Merkintärakenne:
<!ELEMENT extension (category | view | stickyView)*>
<!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 category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - yksilöllinen nimi, jonka avulla voi yksilöidä tämän luokan
- name - käännettävä nimi, jota käyttöliittymässä käytetään tästä luokasta
- parentCategory - valinnainen polku, joka koostuu vinoviivoin '/' erotetuista luokkatunnuksista. Tämän avulla voidaan luoda luokkahierarkia.
<!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 - yksilöllinen nimi, jonka avulla voi yksilöidä tämän näkymän
- name - käännettävä nimi, jota käyttöliittymässä käytetään tästä näkymästä
- category - valinnainen määrite, joka koostuu vinoviivoin '/' erotetuista luokkatunnuksista. Jokainen viitattu luokka on esiteltävä vastaavassa luokkaelementissä.
- class - sen luokan tarkennettu nimi, joka toteuttaa
rajapinnan org.eclipse.ui.IViewPart. Yleinen käytäntö
on muodostaa luokalle org.eclipse.ui.part.ViewPart aliluokka, joka perii oletustoiminnon.
- icon - näkymään liitettävän kuvakkeen suhteellinen nimi.
- fastViewWidthRatio - se prosenttiosuus työympäristön leveydestä, jonka näkymä vie aktiivisena pikanäkymänä.
Tämä on määritettävä liukulukuarvona välillä 0,05 ja 0,95.
Jos mitään arvoa ei anneta, käytetään oletusarvoa.
- allowMultiple - merkintä, joka osoittaa, sallitaanko tässä näkymässä useiden ilmentymien luonti metodin IWorkbenchPage.showView(String id, String secondaryId) avulla. Oletusarvo on epätosi.
<!ELEMENT description (#PCDATA)>
valinnainen alielementti, jonka rungon olisi sisällettävä teksti, jossa on lyhyt kuvaus näkymästä.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
Pysyvä näkymä on näkymä, joka näkyy oletusarvoisesti kaikissa perspektiiveissä ikkunassa, kun se avataan. Sen alkusijainti määritetään sijaintimääritteen avulla, mutta käyttäjä voi aina siirtää sitä tai sulkea sen. Tämän elementin käyttö luo ainoastaan näkymälle paikkamerkin, se ei näytä näkymää. Huomaa, että tätä elementtiä olisi käytettävä varoen ja ainoastaan niissä näkymissä, joiden täytyy näkyä eri perspektiiveissä.
Alkaen versiosta 3.0
- id - sen näkymän tunnus, josta tehdään pysyvä.
- location - valinnainen määrite, jonka avulla määritetään pysyvän näkymän sijainti suhteessa muokkausohjelman alueeseen. Jos sitä ei ole, näkymä sijoitetaan muokkausohjelman alueen oikealle puolelle.
- closeable - valinnainen määrite, jonka avulla määritetään, onko näkymän oltava suljettava. Jos sitä ei ole, näkymä on suljettava.
- moveable - valinnainen määrite, jonka avulla määritetään, onko näkymän oltava siirrettävä. Jos sitä ei ole, näkymä on siirrettävä.
Esimerkkejä:
Seuraavassa on esimerkki laajennuspisteestä:
<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>
Seuraavassa on esimerkki pysyvän näkymän esittelystä:
<extension point=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
API-tiedot:
Määritteen class arvon on oltava
sen luokan tarkennettu nimi, joka toteuttaa
rajapinnan org.eclipse.ui.IViewPart. Uutta näkymää kehitettäessä luodaan yleensä aliluokka luokalle org.eclipse.ui.part.ViewPart.
Toimitettu toteutus:
Eclipse-ympäristössä on useita vakionäkymiä, kuten siirtymis-, ominaisuus-, hahmotelma- ja tehtävänäkymät. Käyttäjän kannalta nämä näkymät eivät poikkea muista lisäosien lisäämistä näkymistä. Kaikki näkymät saadaan näkyviin Ikkuna-valikon Näytä näkymä -alivalikosta. Näkymän sijainti säilyy: se tallennetaan, kun näkymä suljetaan, ja se palautetaan, kun näkymä avataan uudelleen samassa istunnossa. Sijainti säilyy myös työympäristön istuntojen välillä.
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