Описание конечного элемента меню

<описание-конечного-элемента-меню> = ( menuItem | - )
  <строка-заголовока-элемента>,
  <идентификатор-команды> [(<параметр>)]
  [, [ <строка-подсказки> ]
  [, [ <идентификатор-темы-справочника> ]
  [, [ <строка-горячего-ключа> ]
  [, [ <идентификатор-горячего-ключа> ]
  [, [ <идентификатор-линии-статуса> ]
  [, [ <код-страны> ]
  [, [ ReplaceOwner ]
  [, <вычисляемая-видимость> ]
  [, <пиктограмма> ]
  ]]]]]]] ;

Вместо ключевого слова menuItem можно использовать символ тире "-".

<строка-заголовока-элемента> - название пункта меню, строка в кавычках. Для выделения символа "быстрого выбора" необходимо поставить его между символами тильда "~".

<идентификатор-команды> - идентификатор с префиксом cm. Если после него идут скобки, то в них в кавычках ставится строка - параметр команды. При выборе пункта меню приложением формируется событие с указанным идентификатором. См. также "Обработчики событий. ".

<параметр> - параметры, передаваемые с некоторыми командами. См. приложения "Команды, обрабатываемые стандартным приложением" и "Команды, обрабатываемые DESK".

<строка-подсказки> - текст, появляющийся на линии статуса, когда пункт меню находится в фокусе.

<идентификатор-темы-справочника> - идентификатор с префиксом hc.

<строка-горячего-ключа> - строка в кавычках, символьное представление для горячего ключа (строка прижимается вправо).

<идентификатор-горячего-ключа> - идентификатор определяющий код клавиши.

<идентификатор-линии-статуса> - идентификатор с префиксом sc.

Значения Help-контекста (идентификатор темы справочника), Status-контекста (идентификатор линии статуса) и строки подсказки можно не задавать. Тогда значения будут наследоваться от владельца этого элемента. Для подменю эти значения наследуются от родительской меню, которая в свою очередь наследует их от Application.

<код-страны> - см. "Ограничение видимости пунктов меню. ". Параметр <код-страны> доступен начиная с Атлантис 5.1.30.

Атрибут ReplaceOwner включает режим замены родительского меню. Если в подменю имеется только один видимый элемент меню и для этого элемента включен режим ReplaceOwner, то подменю не показывается, а данный элемент меню заменяет свой родительский пункт меню.

Если параметр опущен, то по умолчанию считаеться, что он выключен.

Атрибут ReplaceOwner доступен начиная с Атлантис 5.1.32.

<вычисляемая-видимость> - см. "Ограничение видимости пунктов меню. ". Параметр <вычисляемая-видимость> доступен начиная с Атлантис 5.4.15.

<пиктограмма> - идентификатор иконки (см. "Иконки. "). Опция доступна начиная с Атлантис 5.4.21. Для того, чтобы пиктограмма отображалась в меню, необходимо подключить визуальную схему, например, указав параметр:

Windows.LayoutXML = <имя-схемы>

В схеме в тэге application должен быть задан атрибут NewMenu:

<application NewMenu="1">

Пример

bmGreen2 BitMap "ToolGreenCM2.bmp"
...
Test menu
{
  - 'Menu Value11', cmValue1, 'Menu Value01',,,,, ccRussia,,, bmGreen2;
  - 'Tестовый1', cmExecute(RunInterface('TestInterface',10)),
	'Запуск интерфейса', hcNoContext,,,scNoContext;
  - 'Tестовый2', cmExecute(RunForm('TestForm')),
	'Запуск формы', hcNoContext,,,scNoContext;
  - 'Tестовый3', cmExecute(RunDialog('TestDialog',11)),
	'Запуск диалога', hcNoContext,,,scNoContext;
  - 'Tестовый4', cmExecute(message('Привет из меню')),
	'Просто сообщение', hcNoContext,,,scNoContext;
  - 'Help line o~n~', cmEnableHelpLine,
	'Turn help line on', hcSystemUsage,,,scMenuContext;
  - 'Help line o~f~f', cmDisableHelpLine,
	'Turn help line off', hcSystemUsage,,,scMenuContext;
}

Версия

Параметр <пиктограмма> доступен начиная с Атлантис 5.4.21.

Параметр <вычисляемая-видимость> доступен начиная с Атлантис 5.4.15.

Параметр <код-страны> доступен начиная с Атлантис 5.1.30.

Атрибут ReplaceOwner доступен начиная с Атлантис 5.1.32.