StarUML. Руководство разработчика. Глава 9. Написание дополнительных COM-объектов 90 / 139
Разработка файла описания аддина
Основная концепция файла описания аддина
Файл описания аддина (*.aid) - это текстовый XML-файл. Все аддины, подсоединяемые к StarUML, должны предоставлять собственный файл описания. StarUML регистрирует объект аддина в системном реестре и инициализирует объект аддина, а также связанный с ним файл расширения меню, на который ссылается файл описания.
Обратите внимание: Файл описания должен иметь расширение *.aid и находится в подкаталоге каталога модулей StarUML (<install-dir>\modules).
Структура файла описания аддина
Файл описания аддина создаётся согласно правилам формата XML, определяемые пользователем реквизиты аддина, должен располагаться в пределах элемента 'ADDIN'.
<?xml version="1.0" encoding="..."?> <ADDIN>
<NAME>...</NAME> <DISPLAYNAME>...</DISPLAYNAME> <COMOBJ>...</COMOBJ> <FILENAME>...</FILENAME> <COMPANY>...</COMPANY> <COPYRIGHT>...</COPYRIGHT> <HELPFILE>...</HELPFILE> <ICONFILE>...</ICONFILE> <ISACTIVE>...</ISACTIVE> <MENUFILE>...</MENUFILE> <VERSION>...</VERSION> <MODULES>
<MODULEFILENAME>...</MODULEFILENAME> </MODULES>
</ADDIN>
•Свойство encoding: Определяет кодировку XML документа (например. UTF-8, EUC-KR). Для получения информации об этом свойстве, см. документацию на XML.
•Элемент NAME: Определяет имя аддина. (строковое значение)
•Элемент DISPALYNAME: Определяет название аддина, которое отображается в интерфейсе пользователя. (строковое значение)
•Элемент COMOBJ: Определяет ProgID COM объекта. Этот элемент используется только для аддинов на базе COM объекта. (строковое значение)
•Элемент FILENAME: Указывает имя файла аддина. (строковое значение)
•Элемент COMPANY: Содержит информацию о разработчике аддина. (строковое значение)
•Элемент COPYRIGHT: Описывает объявление об авторском праве. (строковое значение)
•Элемент HELPFILE: Определяет URL, который содержит справку аддина. (строковое значение)
•Элемент ICONFILE: Содержит имя файла иконки аддина. (строковое значение)
•Элемент ISACTIVE: Определяет, активизируется ли аддин автоматически при старте программы. (булево значение)
•Элемент MENUFILE: Содержит имя файла расширения меню, связанного с аддином. (строковое значение)
•Элемент MODULES/MODULEFILENAME: Указывает имена файлов дополнительных COM-объектов в случае, если аддин использует другие COM-объекты. StarUML регистрирует все дополнительные COM-объекты, указанные в этом элементе при выполнении. (строковое значение)