Студия/OnGetRightClickMenu
| OnGetRightClickMenu (Визуальные события) | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
Событие, возникающее до вывода на экран всплывающего меню, ассоциированного с текущей таблицей, вызываемого нажатием правой клавиши мыши. Событие позволяет изменить меню по умолчанию.
Аргументы
<ResultList (LIST)>- Переменная содержит список, который будет превращен в меню, список может содержать элементы, являющиеся списками, эти элементы будут выведены, как подчиненные меню. При вызове список содержит меню по умолчанию (которое вывелось бы, если бы обработчик отсутствовал). Элементы списка, в зависимости от содержания, имеют следующее предназначение:- Значение элемента списка имеет тип "Список значений" -- пункт меню будет выведен, как подменю.
- Представление элемента списка равно "-" -- пункт меню будет выведен как разделитель.
- Значение элемента списка имеет цифровой идентификатор связанного элемента таблицы (см. Константы кодов связанных элементов), представление элемента не является пустой строкой -- будет выеден стандартный пункт меню с заданным представлением, если для элемента задана иконка, она также будет выведена, иначе будет выведена стандартная иконка данного связанного элемента, если она задана. При активации пользователем пункта меню, выбудет вызываться цепочка события OnAttachedButtons с идентификатором активированного связанного элемента совпадающим с цифровым значением элемента списка. Существуют также особые значения, принимаемые данным событием:
- -2 -- Пункт "копировать в буфер обмена", который не вызовет событие OnAttachedButtons
- любые цифры, вне диапазона заданных идентификаторов связанных элементов -- событие OnAttachedButtons по-прежнему будет вызвано с неизвестным идентификатором, стандартного действия данный пункт меню иметь не будет.
<Result (INT)>- (возможен аргумент-переменная (ByRef)) Переменная результата может принимать значения:- 0 (по умолчанию) -- Разрешить показ всплывающего меню.
- 1 -- Запретить показ всплывающего меню.
Примеры
//Пример обработчика OnGetRightClickMenu
//Добавим разделитель
ResultList.Add("","-");
//Добавим новый пункт
ResultList.Add(_ABB_HELP,"Подсказка по данной таблице");
ResultList.Icon(ResultList.Size(),25);
