Obsługa działań

org.eclipse.ui.activitySupport

3.1

Ten punkt rozszerzenia jest używany do rejestrowania różnych rozszerzeń obsługi dotyczących infrastruktury działań.

<!ELEMENT extension (triggerPoint | triggerPointAdvisor | triggerPointAdvisorProductBinding | categoryImageBinding | activityImageBinding)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT triggerPoint (hint*)>

<!ATTLIST triggerPoint

id CDATA #REQUIRED>

Określa punkt wyzwalania. Punkt wyzwalania to identyfikator, który jest używany przez mechanizm działań do ustalenia, czy akcja powinna spowodować włączenie działań.



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

Wskazówka reprezentuje dane, które mogą zostać użyte przez infrastrukturę Eclipse do określenia zachowania mechanizmu obsługi działań związanego z obsługującym je punktem wyzwalania.

Następujące wskazówki są "powszechnie znane" i oczekuje się, że doradcy punktów wyzwalania zatwierdzą je:

interactive
Określa, czy ten punkt wyzwalania jest wskazówką typu interaktywnego, tzn. stanowi jawny wynik akcji podjętej przez użytkownika, takiej jak na przykład aktywowanie kreatora w oknie dialogowym kreatora. Dopuszczalne wartości to true i false.



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

Doradca punktu wyzwalania jest mechanizmem strategii, który jest sprawdzany zawsze, gdy system podejmuje akcję powodującą wyłączenie powiązanych z nim działań. Zadanie doradcy polega na podaniu informacji, czy akcja powinna być kontynuowana, a jeśli tak, to które działania należy włączyć.



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

Określa powiązanie między produktem a doradcą. Te powiązania określają, który doradca jest odpowiedni dla bieżącego produktu (zgodnie z definicją w metodzie org.eclipse.core.runtime.Platform.getProduct()).



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Ten element umożliwia powiązanie ikon z kategoriami. Ikony te mogą być używane przez te komponenty interfejsu użytkownika, które chcą realizować wizualizację kategorii w określony sposób.



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Ten element umożliwia powiązanie ikon z działaniami. Ikony te mogą być używane przez te komponenty interfejsu użytkownika, które chcą realizować wizualizację działań w określony sposób.



Poniżej przedstawiono przykładowy nieinteraktywny punkt wyzwalania:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactive"

value=

"false"

/>

</triggerPoint>

</extension>

Poniżej przedstawiono przykładowego doradcę punktu wyzwalania przypisanego do określonego produktu:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPointAdvisor id=

"com.example.xyz.myTriggerPointAdvisor"

class=

"com.example.xyz.AdvisorImpl"

/>

<triggerPointAdvisorProductBinding productId=

"myProduct"

triggerPointAdvisorId=

"com.example.xyz.myTriggerPointAdvisor"

/>

</extension>

Poniżej przedstawiono przykładowe przypisanie obrazów do działań i kategorii:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<activityImageBinding id=

"some.activity.id"

icon=

"icons/someIcon.gif"

/>

<categoryImageBinding id=

"some.category.id"

icon=

"icons/someIcon.gif"

/>

</extension>

Wartość atrybutu class znacznika triggerPointAdvisor musi być pełną nazwą klasy implementującej interfejs org.eclipse.ui.activities.ITriggerPointAdvisor.

Implementacja środowiska roboczego (interfejs org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor) jest dostępna dla klientów na potrzeby tworzenia podklas i ponownego wykorzystywania.