Elementtien factory-luokat
Tunnus:
org.eclipse.ui.elementFactories
Kuvaus:
Tämän laajennuspisteen avulla lisätään elementtien factory-luokkia
työympäristöön. Elementin factory-luokan avulla voidaan luoda
uudelleen IAdaptable-objekteja, jotka on määritetty
pysyviksi työympäristöä suljettaessa.
Elementin factory-luokan avulla voi esimerkiksi määrittää muokkausohjelman syötteen pysyväksi. Muokkausohjelman syötteen
on toteutettava org.eclipse.ui.EditorInput.
Muokkausohjelman IEditorInput-arvon käyttö jakautuu
eri vaiheisiin.
-
Muokkausohjelman alkuperäinen syöte välitetään muokkausohjelman luonnin
aikana.
-
Työympäristön tila tallennetaan sammutettaessa.
Tässä prosessissa työympäristö tallentaa tiedot
kaikista avoimista muokkausohjelmista ja niiden syötteistä. Syötteet
tallennetaan kaksiosaisina. Ne sisältävät factory-tunnuksen
ja alkeistiedot, joita tarvitaan elementin luonnissa
aloituksen yhteydessä. Lisätietoja on org.eclipse.ui.IPersistableElement-elementin
ohjeissa.
-
Aloituksen aikana luetaan työympäristön tila ja luodaan
uudelleen aiemman istunnon muokkausohjelmat.
Tässä prosessissa työympäristö luo uudelleen kunkin avoimen
muokkausohjelman syöte-elementin. Työympäristö tekee tämän määrittämällä
syöte-elementin alkuperäistä factory-tunnusta vastaavan
rekisteriin määritetyn pysyvän factory-luokan.
Jos vastaavuusmääritys on olemassa ja factory-luokka on kelvollinen,
työympäristö luo factory-luokasta ilmentymän. Tämän jälkeen
työympäristö lähettää factory-luokalle alkuperäisen elementin
luontipyynnön. Elementti luodaan tallennettujen alkeistietojen
perusteella. Tuloksena saatavan IAdaptable-objektin
lajiksi muutetaan IEditorInput-syöte, ja se välitetään
uuteen muokkausohjelmaan.
Merkintärakenne:
<!ELEMENT extension (factory*)>
<!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 factory EMPTY>
<!ATTLIST factory
id CDATA #REQUIRED
class CDATA #REQUIRED>
- id - tämän factory-luokan yksilöllinen nimi.
- class - sen luokan tarkka nimi, joka toteuttaa
org.eclipse.ui.IElementFactory-luokan.
Esimerkkejä:
Seuraavassa on esimerkki elementin factory-luokkalaajennuksesta:
<extension
point =
"org.eclipse.ui.elementFactories"
>
<factory
id =
"com.xyz.ElementFactory"
class=
"com.xyz.ElementFactory"
>
</factory>
</extension>
API-tiedot:
Class-määritteen arvon on
oltava sen luokan tarkka nimi, joka toteuttaa
org.eclipse.ui.IElementFactory-liittymän. Tämän luokan
ilmentymän on luotava IAdaptable-objekti
työympäristön tallennuksen perusteella.
Toimitettu toteutus:
Työympäristön mukana toimitetaan IResource-Factory-luokka.
Jotta voitaisiin luoda uudelleen muita
IAdaptable-objekteja, joita käytetään yleisesti
muissa objektimalleissa (esimerkiksi Java Model), on lisättävä muita factory-luokkia.
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