Aktivity

org.eclipse.ui.activities

3.0

Bod rozšíření org.eclipse.ui.activities se používá k deklarování aktivit a přiřazených prvků. Aktivity jsou použity platformou k filtrování určitých příspěvků modulů plug-in z pohledu uživatele, až do chvíle, kdy o ně projeví zájem. Tím má Eclipse umožněn dynamický růst, na základě vzoru využití od uživatele.

<!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>

Tento prvek se používá k definování aktivit. Pokud existuje více než jeden z těchto prvků se stejným atributem id, je považován za platný pouze poslední deklarovaný prvek (v pořadí čtení registru).



<!ELEMENT activityRequirementBinding EMPTY>

<!ATTLIST activityRequirementBinding

requiredActivityId CDATA #REQUIRED

activityId         CDATA #REQUIRED>

Tento prvek umožňuje spojit aktivity s aktivitami. Tento vztah je takový, že pokud je někdy povoleno activityId, pak je povoleno také requiredActivityId.



<!ELEMENT activityPatternBinding EMPTY>

<!ATTLIST activityPatternBinding

activityId CDATA #REQUIRED

pattern    CDATA #REQUIRED>

Tento prvek umožňuje spojovat aktivity do vzorů.



<!ELEMENT category EMPTY>

<!ATTLIST category

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

Tento prvek se používá pro definování kategorií. Pokud existuje více než jeden z těchto prvků se stejným atributem id, je považován za platný pouze poslední deklarovaný prvek (v pořadí čtení registru).



<!ELEMENT categoryActivityBinding EMPTY>

<!ATTLIST categoryActivityBinding

activityId CDATA #REQUIRED

categoryId CDATA #REQUIRED>

Tento prvek umožňuje spojovat kategorie s aktivitami.



<!ELEMENT defaultEnablement EMPTY>

<!ATTLIST defaultEnablement

id CDATA #REQUIRED>

Tento prvek umožňuje zadat, že by daná aktivita měla být povolena jako výchozí nastavení.



V následujícím je uveden příklad několika definic aktivit a kategorií a také přiřazená spojení.

 

<extension point=

"org.eclipse.ui.activities"

>

<activity id=

"com.xyz.Activity"

description=

"Filters contributions from com.xyz"

name=

"My Activity"

/>

<activity id=

"com.xyz.OtherActivity"

description=

"Filters other contributions from com.xyz"

name=

"My Other Activity"

/>

<!-- jiná aktivita vyžaduje aktivitu -->

<activityRequirementBinding activityId=

"com.xyz.OtherActivity"

requiredActivityId=

"com.xyz.Activity"

/>

<category id=

"com.xyz.Category"

description=

"com.xyz Activities"

name=

"My Category"

/>

<!-- vložit aktivitu do kategorie -->

<categoryActivityBinding activityId=

"com.xyz.Activity"

categoryId=

"com.xyz.Category"

/>

<!-- spojit všechny příspěvky z modulu plug-in com.xyz -->

<activityPatternBinding id=

"com.xyz.Activity"

pattern=

"com\.xyz/.*"

/>

<!-- spojit my.contribution z modulu plug-in com.xyz.other -->

<activityPatternBinding id=

"com.xyz.OtherActivity"

pattern=

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

/>

<!-- naše aktivita by měla být povolena jako výchozí nastavení -->

<defaultEnablement id=

"com.xyz.Activity"

/>

</extension>

V současné době není žádné veřejné rozhraní API pro deklarování aktivit nebo přiřazených prvků, jiné než bod rozšíření. Stav aktivit na pracovní ploše je přístupný přes org.eclipse.ui.IWorkbench.getActivitySupport(). Z tohoto místa můžete odesílat dotazy do sady aktuálně povolených aktivit a aktualizovat ji.

Pracovní plocha neposkytuje žádné "výchozí aktivity". Definování aktivit je zamýšleno na úrovni produktu, jako například Eclipse SDK, aby byly úzce integrovány všechny (známé) komponenty, které produkt obsahuje.