OnTaskbarMenuClick

OnOpen (События форм)
Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Расположение: Любой глобальный модуль, текущий локальный модуль Визуальность: Нет

• Начальная страница
• Общее описание
• Предопределенные события

Событие, возникающее после того, как пользователь выберет пункт из встроенного меню на кнопке панели задач. Меню может быть задано программно, если меню не задано, кнопка меню не будет показана. Для задания меню см. атрибут TaskbarMenu. Подобное событие можно также описать в событиях, привязанных к форме, а не модулю (см. OnTaskbarMenuClick), в этом случае, событие, привязанное к форме, будет вызвано до вызова функции. Если функция возвратит 1 в локальном модуле, будет произведен вызов такой же процедуры в глобальном модуле.

Ниже дана цепочка вызова функций OnTaskbarMenuClick. Следующая функция будет вызвана, если предыдущая возвратила единицу.

1. Событие OnTaskbarMenuClick в контейнере событий, привязанном к элементу формы, для которой произошла активация пункта меню.
2. Функция OnTaskbarMenuClick в локальном модуле формы, для которой произошла активация пункта меню.
3. Функция OnTaskbarMenuClick в одном из глобальных модулей.

Синтаксис

OnTaskbarMenuClick(<Индекс пункта меню (STRING)>,<Значение, ассоциированное с пунктом меню (STRING)>,<Текстовое представление пункта меню (STRING)>):<Вызвать стандартный обработчик пункта меню (INT)>

Аргументы

• <Индекс пункта меню (STRING)> - Аргумент задает индекс выбранного пункта меню. Аргумент представляет собой строку вида <Индекс пункта меню>@<Индекс пункта подменю>.... Для одноуровневых меню это будет просто индекс выбранного пункта в текстовом виде.
• <Значение, ассоциированное с пунктом меню (STRING)> - Аргумент задает текстовое представление выбранного пользователем пункта меню (т.е., текст, который был ассоциирован с элементом списка этого пункта меню).
• <Текстовое представление пункта меню (STRING)> - Аргумент задает элемент списка, ассоциированный с выбранным пользователем пунктом меню, превращенный в текст.

Возвращаемое значение

Функция должна возвратить ноль (переменная Result при вызове инициализирована нулем), чтобы закончить цепочку вызова, либо единицу, чтобы отказаться продолжить цепочку вызова функции (см. выше).

Примеры

Function OnOpen(Index,Value,Caption)
  If Value="Выход" Then
    Form.Destroy(0);
    Exit;
  ElseIf Value="Обновить" Then
    ОбновитьТаблицы();
    Exit;
  EndIf;
  //Продолжить цепочку в глобальном модуле
  Result:=1;
EndFunction