Расширение элемента памятки

org.eclipse.ui.cheatsheets.cheatSheetItemExtension

3.0

Эта точка расширения используется тогда, когда в шаг памятки необходимо добавить дополнительную кнопку. Новый атрибут можно поместить в тег "item" файла содержимого памятки, и когда при обработке памятки будет прочитано это значение, то будет проверено, зарегистрирован ли через эту точку расширения класс, который будет обрабатывать этот атрибут. Имя атрибута, находящееся в файле содержимого памятки, сверяется со всеми значениями атрибута "itemAttribute" всех реализаций зарегистрированных точек cheatsheetItemExtension. Если найдено совпадение, то для обработки атрибута этого элемента структура памятки загружает указанный класс и вызывает его для обработки атрибута, заданного в файле содержимого памятки. После анализа значения атрибута элемента класс остается доступным для структуры памятки. При выводе элемента в панели памяток снова вызывается этот класс для обработки дополнений компонентов в составном элементе управления. Элементы, которые добавляются в этот составной элемент управления, отображаются в шаге памятки (в текущей реализации - рядом со значком справки). Они отображаются только для шага, описанного тегом "item", представляющим атрибут в файле содержимого памятки. Пример использования этой точки расширения - добавление маленькой (16x16) кнопки с изображением, при нажатии которой открывается окно диалога.

<!ELEMENT extension (itemExtension)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT itemExtension EMPTY>

<!ATTLIST itemExtension

itemAttribute CDATA #REQUIRED

class         CDATA #REQUIRED>

Это расширение элемента служит для добавления элементов в шаги памятки. С помощью этой точки расширения можно добавлять к шагу памятки значки и кнопки (в текущей реализации - рядом со значком справки). Для атрибута, помещаемого в тег элемента памятки, следует указать имя. Также следует задать класс, который будет анализировать значение атрибута, полученного из файла содержимого памятки при ее загрузке. Значение атрибута должно быть строкового типа. Указанный класс должен быть производным от класса org.eclipse.ui.cheatsheets.AbstractItemExtensionElement. После анализа и загрузки файла содержимого памятки снова вызывается класс, указанный в точке расширения. Он вызывается через интерфейс и служит для добавления графических объектов или кнопок к шагу памятки (в текущей реализации - следом за кнопкой справки).



Пример реализации этой точки расширения:

<extension point=

"org.eclipse.ui.cheatsheets.cheatSheetItemExtension"

>

<itemExtension itemAttribute=

"xyzButton"

class=

"com.example.HandleParsingAndAddButton"

>

</itemExtension>

</extension>

Атрибут элемента для этой точки расширения:

<item title=

"XYZ Title"

xyzButton=

"/icon/button.gif"

/>

Обратите внимание, что значение атрибута в теге item может быть любым. Это возможно благодаря тому, что класс, анализирующий этот атрибут - это класс HandleParsingAndAddButton (в этом примере он анализирует строку /icon/button.gif). Позднее эта информация понадобится для загрузки рисунка в формате GIF, который послужит значком для новой кнопки.

Дополнительные сведения об API см. в документации по Java для org.eclipse.ui.cheatsheets.AbstractItemExtensionElement.

На данный момент реализация не поставляется.