Tulajdonságoldalak

org.eclipse.ui.propertyPages

Ez a kiterjesztési pont szolgál dott típusú objektumok további tulajdonságoldalainak felvételére. Megadás után a tulajdonságoldalak az adott típusú objektumok Tulajdonságok párbeszédablakában jelennek meg.

A tulajdonságoldalak felhasználóbarát módszert kínálnak az objektum tulajdonságainak kezelésére. Szemben a Tulajdonságok nézettel, amelyi korlátozza az objektumtulajdonságok szerkesztését, a tulajdonságoldalakon szabadabban, nagyobb és összetettebb vezérlőelemek, címkék és ikonok alkalmazhatók. A logikailag összetartozó tulajdonságok összegyűjthetők egy oldalra, nincsenek szétszórva a tulajdonságlapon. A legtöbb alkalmazás esetében azonban a legjobb megoldást bizonyos tulajdonságok a tulajdonságlapon, mások a tulajdonságoldalakon elérhetővé tétele jelenti.

A tulajdonságoldalak egy párbeszédablakban jelennek meg, amely normális esetben az objektum előugró menüjének Tulajdonságok menüpontját kiválasztva jelenik meg. Az objektumosztályon kívül opcionálisan megadható egy névszűrő is, csak meghatározott objektumtípusok tulajdonságoldalainak bejegyzéséhez.

Ha ezek a szűrési mechanizmusok nem lennének elegendők, akkor a tulajdonságoldal használhatja a filter mechanizmust. Ebben az esetben a célobjektum attribútumai egy sor kulcs-érték párként vannak megadva. A kijelölésnek megfelelő attribútumok típusspecifikusak és túlmutatnak magán a munkaterület tartományán, vagyis a munkaterület delegálni fogja a szűrést ezen a szinten a tényleges kijelölésnek.

<!ELEMENT extension (page*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT page (filter* , keywordReference*)>

<!ATTLIST page

id          CDATA #REQUIRED

name        CDATA #REQUIRED

icon        CDATA #IMPLIED

objectClass CDATA #REQUIRED

class       CDATA #REQUIRED

nameFilter  CDATA #IMPLIED

adaptable   (true | false)

category    CDATA #IMPLIED>


<!ELEMENT filter EMPTY>

<!ATTLIST filter

name  CDATA #REQUIRED

value CDATA #REQUIRED>

Ez az elem használatos az aktuális kijelölésben szereplő egyes objektumok attribútumállapotainak kiértékelésére. Akkor igaz, ha a kijelölés minden egyes objektuma egy adott attribútumállapottal bír. A kijelölés minden egyes objektumának meg kell valósítania (vagy adaptálnia kell) az org.eclipse.ui.IActionFilter felületet.



<!ELEMENT keywordReference EMPTY>

<!ATTLIST keywordReference

id CDATA #IMPLIED>

Adatlap általi kulcsszóhivatkozás. Tekintse meg a kulcsszavak kiterjesztési pontot.



Az alábbiakban bemutatunk egy példát egy tulajdonságoldal-meghatározásra:

   

<extension point=

"org.eclipse.ui.propertyPages"

>

<page id=

"com.xyz.projectPage"

name=

"XYZ Java tulajdonságok"

objectClass=

"org.eclipse.core.resources.IFile"

class=

"com.xyz.ppages.JavaPropertyPage"

nameFilter=

"*.java"

>

<filter name=

"readOnly"

value=

"true"

/>

</page>

</extension>

A class attribútumnak az org.eclipse.ui.IWorkbenchPropertyPage felületet megvalósító osztály teljes képzésű nevét kell tartalmaznia.

A munkaterület egyes objektumain vannak bejegyzett tulajdonságoldalai. A bedolgozók további tulajdonságoldalakat jegyezhetnek be ezen objektumokhoz. A tulajdonságoldalak nem korlátozódnak a munkaterület erőforrásaira: a munkaterületen megjelenő összes objektum (még a bedolgozók által létrehozott, tartományspecifikus objektumok is) rendelkezhetnek tulajdonságoldalakkal és más bedolgozó bejegyezhetnek hozzájuk tulajdonságoldalakat.