Поддержка групп действий

org.eclipse.ui.activitySupport

3.1

Эта точка расширения служит для регистрации различных расширений поддержки для инфраструктуры групп действий.

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

Позволяет указать триггер. Триггер - это идентификатор, использующийся для определения должно ли действие приводить к включению групп действий.



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

Представляет данные, которые могут быть использованы инфраструктурой eclipse для определения поведения поддержки групп действий относительно триггера.

Советник триггер должен принимать во внимание следующие "подсказки":

interactive
Является ли триггер интерактивным. Т.е. это непосредственный результат действия, производимого пользователем, например - запуск мастера в окне диалога мастера. Допустимые значения: true и false.



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

Советник триггера - это механизм, приводимый в действие перед выполнением действий, с которым ассоциированы отключенные группы действий. Он определяет, выполнять ли действие и, если выполнять, то какие группы действий необходимо включить.



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

Задает связь между продуктом и советником. По этой связи определяется советник, соответствующий текущему продукту (как это определено в org.eclipse.core.runtime.Platform.getProduct()).



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Этот элемент позволяет назначать значки категориям. Их смогут использовать компоненты пользовательского интерфейса для большей наглядности.



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

Этот элемент позволяет назначать значки группам действий. Их смогут использовать компоненты пользовательского интерфейса для большей наглядности.



Ниже приведен пример неинтерактивного триггера:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactive"

value=

"false"

/>

</triggerPoint>

</extension>

Ниже приведен пример триггера, привязанного к продукту:

  

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

Ниже приведен пример назначения изображений группам действий и категориям:

  

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

Значение атрибута class тега triggerPointAdvisor должно быть полным именем класса, реализующего org.eclipse.ui.activities.ITriggerPointAdvisor.

Реализация в рабочей среде (org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor) может быть наследована классами клиента.