Tevékenységek

org.eclipse.ui.activities

3.0

Az org.eclipse.ui.activities kiterjesztési pont tevékenységeket és társított elemeket ad meg. A tevékenységeket a platform használja adott bedolgozó-közreadások felhasználói nézetből kiszűréséhez addig, amíg érdeklődést nem tanúsítanak irántuk. Ennek segítségével az Eclipse dinamikusan nőhet a felhasználó használati mintája alapján.

<!ELEMENT extension (activity , activityRequirementBinding , activityPatternBinding , category , categoryActivityBinding , defaultEnablement)*>

<!ATTLIST extension

id    CDATA #IMPLIED

name  CDATA #IMPLIED

point CDATA #REQUIRED>


<!ELEMENT activity EMPTY>

<!ATTLIST activity

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

Ez az elem tevékenységeket ad meg. Ha több ilyen elem létezik ugyanabban az id attribútumban, akkor csak az utolsó megadott elem (a nyilvántartás olvasása érdekében) érvényes.



<!ELEMENT activityRequirementBinding EMPTY>

<!ATTLIST activityRequirementBinding

requiredActivityId CDATA #REQUIRED

activityId         CDATA #REQUIRED>

Az elem lehetővé teszi a tevékenységek másik tevékenységekhez kötését. A kapcsolat olyan, hogyha az activityId engedélyezve van, akkor a requiredActivityId szintén engedélyezett.



<!ELEMENT activityPatternBinding EMPTY>

<!ATTLIST activityPatternBinding

activityId CDATA #REQUIRED

pattern    CDATA #REQUIRED>

Az elem lehetővé teszi a tevékenységek mintákhoz kötését.



<!ELEMENT category EMPTY>

<!ATTLIST category

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

Ez az elem kategóriákat ad meg. Ha több ilyen elem létezik ugyanabban az id attribútumban, akkor csak az utolsó megadott elem (a nyilvántartás olvasása érdekében) érvényes.



<!ELEMENT categoryActivityBinding EMPTY>

<!ATTLIST categoryActivityBinding

activityId CDATA #REQUIRED

categoryId CDATA #REQUIRED>

Ez az elem lehetővé teszi a kategóriák tevékenységekhez kötését.



<!ELEMENT defaultEnablement EMPTY>

<!ATTLIST defaultEnablement

id CDATA #REQUIRED>

Az elem segítségével megadható, hogy egy adott tevékenységet alapértelmezés szerint engedélyezni kell.



Az alábbiakban számos tevékenységre és kategóriára, valamint a társított kötésekre látható példa.

 

<extension point=

"org.eclipse.ui.activities"

>

<activity id=

"com.xyz.Activity"

description=

"com.xyz hozzáadásainak szűrése"

name=

"Saját tevékenység"

/>

<activity id=

"com.xyz.OtherActivity"

description=

"com.xyz egyéb hozzáadásainak szűrése"

name=

"Saját egyéb tevékenység"

/>

<!-- az egyéb tevékenység megkövetel tevékenységeket -->

<activityRequirementBinding activityId=

"com.xyz.OtherActivity"

requiredActivityId=

"com.xyz.Activity"

/>

<category id=

"com.xyz.Category"

description=

"com.xyz tevékenységek"

name=

"Saját kategória"

/>

<!-- a tevékenység kategóriába helyezése -->

<categoryActivityBinding activityId=

"com.xyz.Activity"

categoryId=

"com.xyz.Category"

/>

<!-- a com.xyz bedolgozó összes közreadásának kötése -->

<activityPatternBinding id=

"com.xyz.Activity"

pattern=

"com\.xyz/.*"

/>

<!-- a com.xyz.other bedolgozó my.contribution elemének kötése -->

<activityPatternBinding id=

"com.xyz.OtherActivity"

pattern=

"com\.xyz\.other/my.contribution"

/>

<!-- a tevékenységet alapértelmezés szerint engedélyezni kell -->

<defaultEnablement id=

"com.xyz.Activity"

/>

</extension>

Pillanatnyilag nincs nyilvános API a kiterjesztési ponttól különböző tevékenységek vagy társított elemek megadásához. A tevékenységek állapota a munkaterületen az org.eclipse.ui.IWorkbench.getActivitySupport() metódus segítségével érhető el. Innen lekérdezheti és frissítheti az aktuálisan engedélyezett tevékenységek halmazát.

A munkaterület nem ad meg "alapértelmezett tevékenységeket". A tevékenységeket termékszinten kell megadni, mint például az Eclipse SDK, így szorosan integrálható a termékben lévő összes (ismert) összetevő.