Макрокоманда справки InsertItem

Данная макрокоманда вставляет элемент меню в указанной позиции внутри существующего меню. Это может быть меню, созданное с помощью макрокоманды InsertMenu и и одно из стандартных меню WinHelp.

Синтаксис

InsertItem("menuid", "itemid", "itemname", "macro", position)

Параметры

Аргумент	Определение
menuid	Имя стандартного меню WinHelp или имя, использованное при создании меню с помощью макрокоманды InsertMenu. Имена стандартных меню: mnu_file (меню File), mnu_edit (меню Edit), mnu_bookmark (меню Bookmark) и mnu_helpon (меню Help). Иде тификатор меню должен быть заключен в кавычки. Именно в это меню вставляется нов й элемент.
itemid	Имя, которое WinHelp использует во внутренних операциях для идентифицирования лемента меню. Идентификатор элемента должен быть заключен в кавычки. Используя это имя в макрокоманде DisableItem или DeleteItem, вы можете удалить элемент и и сделать его недоступным или изменить состав операций, выполняемых им в опре еленных темах.
itemname	Имя, которым WinHelp обозначает данный элемент меню на экране. Это имя т актуется с учетом регистра символов и должно быть заключено в кавычки. Внутри кав чек поставьте знак & перед символом, который вы хотите использовать в качестве к авиши быстрого доступа для этого элемента.
macro	Макрокоманда справки или строка макрокоманд, которая выполняется при выборе да ного элемента меню. Эта макрокоманда должна быть заключена в кавычки. Если в строке задано несколько макрокоманд, их следует разделять точкой с запятой (;).
position	Целое число, задающее позицию внутри меню, в которой появится новый элемент. З ачение 0 определяет первую (самую верхнюю) позицию в меню.

Пример

Следующая макрокоманда вставляет элемент меню под названием Tools в качестве третьего элемента в меню, имеющее идентификатор mnu_books:

InsertItem("mnu_books", "mnu_tools", "&Tools", "JI(`tools.hlp',

`first_topic')", 3)

При выборе этого элемента меню произойдет переход к теме с контекстной строкой "first_topic" в файле TOOLS.HLP.

Комментарии

Данная макрокоманда поддерживается только в справке Windows.

WinHelp игнорирует эту макрокоманду, если она выполняется во вторичном окне.

Убедитесь, что назначаемые элементам меню клавиши доступа являются уникальн ми. Если вы назначаете клавишу, совпадающую с одной из других клавиш доступа в ме ю, WinHelp выдает сообщение об ошибке и игнорирует макрокоманду.