Admin: 1 revision imported

2021-02-07T06:52:14Z

1 revision imported

Admin at 15:11, 17 August 2020

2020-08-17T15:11:56Z

New page

{{infobox function
|name=OnOpen
|object=
|caption=События форм
|type=1
|status=2
|db=0
|location=Любой глобальный модуль, текущий локальный модуль
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Предопределенные события]]}}
Событие, возникающее после того, как пользователь выберет пункт из встроенного меню на кнопке панели задач. Меню может быть задано программно, если меню не задано, кнопка меню не будет показана. Для задания меню см. атрибут [[Form.TaskbarMenu|TaskbarMenu]]. Подобное событие можно также описать в событиях, привязанных к форме, а не модулю (см. [[Студия/OnTaskbarMenuClick|OnTaskbarMenuClick]]), в этом случае, событие, привязанное к форме, будет вызвано до вызова функции. Если функция возвратит 1 в локальном модуле, будет произведен вызов такой же процедуры в глобальном модуле.
<p>Ниже дана цепочка вызова функций ''OnTaskbarMenuClick''. Следующая функция будет вызвана, если предыдущая возвратила единицу.</p>
# Событие '''OnTaskbarMenuClick''' в контейнере событий, привязанном к элементу формы, для которой произошла активация пункта меню.
# Функция '''OnTaskbarMenuClick''' в локальном модуле формы, для которой произошла активация пункта меню.
# Функция '''OnTaskbarMenuClick''' в одном из глобальных модулей.

== Синтаксис ==
<code>
'''OnTaskbarMenuClick'''(''<Индекс пункта меню (STRING)>'',''<Значение, ассоциированное с пунктом меню (STRING)>'',''<Текстовое представление пункта меню (STRING)>''):''<Вызвать стандартный обработчик пункта меню (INT)>''
</code>
==== Аргументы ====
* <code>''<Индекс пункта меню (STRING)>''</code> - Аргумент задает индекс выбранного пункта меню. Аргумент представляет собой строку вида <code><Индекс пункта меню>@<Индекс пункта подменю>...</code>. Для одноуровневых меню это будет просто индекс выбранного пункта в текстовом виде.
* <code>''<Значение, ассоциированное с пунктом меню (STRING)>''</code> - Аргумент задает текстовое представление выбранного пользователем пункта меню (т.е., текст, который был ассоциирован с элементом списка этого пункта меню).
* <code>''<Текстовое представление пункта меню (STRING)>''</code> - Аргумент задает элемент списка, ассоциированный с выбранным пользователем пунктом меню, превращенный в текст.

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

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

← Older revision	Revision as of 06:52, 7 February 2021
(No difference)

OnTaskbarMenuClick - Revision history

Admin: 1 revision imported

Admin at 15:11, 17 August 2020