StarUML. Руководство разработчика. Глава 8. Расширение меню |
83 / 139 |
может быть опущена, рекомендуется включать её, чтобы файлы расширения меню были легко идентифицируемы.
<HEADER> <NAME>...</NAME> <VERSION>...</VERSION>
<DESCRIPTION>...</DESCRIPTION> <COMPANY>...</COMPANY> <COPYRIGHT>...</COPYRIGHT>
</HEADER>
•Элемент NAME: Содержит название адина (строковое значение).
•Элемент VERSION: Содержит информацию о версии (строковое значение).
•Элемент DESCRIPTION: Содержит краткое описание аддина (строковое значение).
•Элемент COMPANY: Содержит информацию о разработчике (строковое значение).
•Элемент COPYRIGHT: Содержит объявление об авторском праве (строковое значение).
Элемент BODY
Элемент BODY файла расширения меню содержит спецификации добавляемых пунктов меню. Информация этой секции должна быть точной.
<BODY>
<MAINMENU> <MAINITEM>...</MAINITEM> <MAINITEM>...</MAINITEM>
</MAINMENU>
<POPUPMENU> <POPUPITEM>...</POPUPITEM> <POPUPITEM>...</POPUPITEM>
</POPUPMENU>
</BODY>
Элемент BODY может быть разделен на определения главного меню и определения контекстного меню.
•Элемент MAINMENU: Описывает добавляемые элементы главного меню.
•Элемент POPUPMENU: Описывает добавляемые элементы всплывающих меню.
•Элемент MAINITEM: Содержит актуальную информацию о пункте меню (главное меню).
•Элемент POPUPITEM: Содержит актуальную информацию о пункте меню (контекстное меню).
Элементы главного меню и пункты всплывающих меню описываются отдельно. В соответствии с функциями, предоставляемыми каждым аддином, пункты меню можно добавлять в главное меню или в контекстные меню. Поэтому элемент MAINMENU или элемент POPUPMENU может быть опущен, но не оба сразу. Если же одни и те же функциональные возможности нужно добавить и в главное меню и в контекстное меню, соответствующая информация должна быть введена как в MAINMENU, так и в POPUPMENU. В этом случае эти два элемента должны вызывать один скрипт или иметь одинаковые значения свойства actionID. Однако, при добавлении пункта меню низшего уровня к основному пункту меню типа [Format] и [Unit], который доступен и в главном меню и в контекстных меню, информация должна добавляться в только MAINMENU.
Элемент MAINMENU
Элемент MAINMENU может содержать несколько элементов MAINITEM. Каждый элемент MAINITEM составляет один элемент главного меню. Чтобы определить суб-меню с пунктами
StarUML. Руководство разработчика. Глава 8. Расширение меню |
84 / 139 |
меню, элемент MAINITEM может в свою очередь содержать несколько элементов MAINITEM.
<MAINITEM base=”...” caption=”...” index=”...” beginGroup=”...” script=”...” actionId=”...” availableWhen=”...” iconFile=”...”>
<MAINITEM>...</MAINITEM> <MAINITEM>...</MAINITEM>
</MAINITEM>
Обратите внимание: Если пункт меню не соответствует субменю, для него должна быть указана ссылка на выполняемый скрипт или идентификатор вызываемой акции.
Свойство |
Описание |
Диапазон значений |
Пропуск |
|
|
|
|
|
|
|
Основное свойство добавляемого |
Допускается: FILE, EDIT, |
|
|
|
пункта меню. Это свойство |
FORMAT, MODEL, VIEW, |
Если опущено, новый |
|
base |
игнорируется, если элемент |
TOOLS, HELP, UNITS, |
пункт добавляется как |
|
|
MAINITEM находится внутри |
IMPORT, EXPORT, or |
субменю меню [Tools] . |
|
|
другого элемента MAINITEM. |
NEW_TOP. * |
|
|
|
Указывает отображаемое название |
|
|
|
|
пункта меню. Это значение может |
|
|
|
|
содержать код клавиши. Чтобы |
|
|
|
|
определить горячую клавишу, |
|
|
|
caption |
добавьте '&' и код символа за |
Строковое значение |
Не может быть опущено. |
|
|
этим значением. Учтите, что |
|
|
|
|
StarUML™ не проверяет |
|
|
|
|
дублирования горячих клавиш в |
|
|
|
|
других пунктах меню. |
|
|
|
|
Указывает порядковый номер |
|
|
|
|
пункта меню. Например, если это |
|
|
|
|
значение '0', пункт меню будет |
|
Обычно опущен. Если |
|
|
следовать первым за стандартными |
|
||
|
|
опущено, добавляется в |
||
index |
пунктами. Если данное значение |
Целое, большее 0. |
||
порядке регистрации |
||||
|
конфликтует с другими |
|
||
|
|
аддина. |
||
|
аналогичными значениями, меню |
|
||
|
|
|
||
|
может быть отображено |
|
|
|
|
некорректно. |
|
|
|
beginGroup |
Указывает, помещать ли сепаратор |
TRUE или FALSE. |
Если опущено, |
|
|
перед пунктом меню |
|
принимается FALSE. |
|
|
Содержит полное имя |
|
|
|
|
выполняемого скрипта, если |
|
|
|
script |
указано. Допускается |
Строковое значение |
Может быть опущено. |
|
относительный маршрут от |
||||
|
|
|
||
|
каталога аддина. Может содержать |
|
|
|
|
URL. |
|
|
|
|
Содержит положительное целое, |
|
|
|
|
которое передаётся COM объекту |
|
|
|
|
аддина. Если аддин добавляет |
|
|
|
actionId |
несколько пунктов меню, каждый |
Целое, большее 0. |
Может быть опущено. |
|
|
пункт может отличаться |
|
|
|
|
уникальным значением |
|
|
|
|
идентификатора. |
|
|
|
availableWhen |
Указывает когда пункт меню |
Допускается: ALWAYS, |
Если опущено, |
|
|
доступен. |
PROJECT_OPENED, |
принимается |
|
|
|
MODEL_SELECTED, |
PROJECT_OPENED |
|
|
|
VIEW_SELECTED, |
|
|
|
|
UNIT_SELECTED, or |
|
|
|
|
DIAGRAM_ACTIVATED. |
|
|
|
|
** |
|
|
|
|
|
|