Вызывается перед открытием диалогов получения навигационной ссылки и добавления в избранное. Параметр <СписокНавигационыхСсылок> предварительно заполняется описаниями вариантов стандартных навигационных ссылок, поддерживаемых платформой. В обработчике можно добавить новые варианты, переставить или удалить стандартные варианты, указать ключ любого из элементов списка, в т.ч. стандартного, в качестве ключа по умолчанию. Если у формы установлено свойство АвтоНавигационнаяСсылка имеет значение Ложь, то обработчику передается пустой <СписокНавигационыхСсылок>.
Синтаксис
ОбработкаПолученияСпискаНавигационныхСсылок(<СписокНавигационыхСсылок>, <КлючПоУмолчанию>)Полное описание, параметры и ограничения
ФормаКлиентскогоПриложения.ОбработкаПолученияСпискаНавигационныхСсылок (ClientApplicationForm.URLListGetProcessing)
ФормаКлиентскогоПриложения (ClientApplicationForm)
ОбработкаПолученияСпискаНавигационныхСсылок (URLListGetProcessing)
Доступен, начиная с версии 8.3.19.
Синтаксис:
ОбработкаПолученияСпискаНавигационныхСсылок(<СписокНавигационыхСсылок>, <КлючПоУмолчанию>)
Параметры:
<СписокНавигационыхСсылок>
Тип: СписокВыбораНавигационнойСсылки.
Предварительно заполняется описаниями вариантов стандартных навигационных ссылок, поддерживаемых платформой. В обработчике можно добавить новые варианты, переставить или удалить стандартные варианты.
Если у формы свойство АвтоНавигационнаяСсылка имеет значение Ложь, то обработчику передается пустой <СписокНавигационыхСсылок>.
<КлючПоУмолчанию>
Тип: Произвольный.
В данный параметр нужно поместить значение ключа из списка ссылок, соответствующего ссылке, которую нужно использовать по умолчанию.
Описание:
Вызывается перед открытием диалогов получения навигационной ссылки и добавления в избранное. Параметр <СписокНавигационыхСсылок> предварительно заполняется описаниями вариантов стандартных навигационных ссылок, поддерживаемых платформой. В обработчике можно добавить новые варианты, переставить или удалить стандартные варианты, указать ключ любого из элементов списка, в т.ч. стандартного, в качестве ключа по умолчанию.
Если у формы установлено свойство АвтоНавигационнаяСсылка имеет значение Ложь, то обработчику передается пустой <СписокНавигационыхСсылок>.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.19.
Методическая информация
Практические примеры
Собственный вариант навигационной ссылки
Короткий пример для реального события собственной формы: источник вызова, место установки и ограничения указаны явно.
Где и как запускать
Модуль собственной управляемой формы; директива и полный заголовок обработчика включены в код.
Подготовка
Своя управляемая форма учебной обработки. Добавьте Статус Строка 250 и видимое поле. Основную процедуру назначьте одноимённому событию формы; у событий формы нет первого параметра Элемент.
Создайте собственную общую управляемую форму УчебнаяПамятка с надписью об учебных книгах. Назначьте оба обработчика событиям формы. Откройте диалог получения ссылки или добавления в избранное; выберите Памятка по книгам.
&НаКлиенте
Процедура ОбработкаПолученияСпискаНавигационныхСсылок(СписокНавигационыхСсылок, КлючПоУмолчанию)
СписокНавигационыхСсылок.Добавить("УчебнаяПамятка", "Памятка по книгам");
КлючПоУмолчанию = "УчебнаяПамятка";
КонецПроцедуры
&НаКлиенте
Процедура ОбработкаПолученияНавигационнойСсылки(Ключ, Представление, НавигационнаяСсылка, СтандартнаяОбработка)
Если Ключ = "УчебнаяПамятка" Тогда
НавигационнаяСсылка = "e1cib/app/ОбщаяФорма.УчебнаяПамятка";
СтандартнаяОбработка = Ложь;
Сообщить("Подготовлена ссылка на свою учебную памятку");
КонецЕсли;
КонецПроцедурыРазбор по шагам
Подготовьте указанную собственную форму и её реквизиты.
Назначьте процедуру точному событию в Конфигураторе.
Выполните описанное действие в своём клиенте; обработчик сам себя искусственно не вызывает.
Как проверить результат
Вариант использует собственный строковый ключ, а ссылка ведёт на реальную созданную общую форму. Для чужих стандартных ключей исходный флаг не перезаписывается.
Это внутренняя e1cib-ссылка, не внешняя сеть. Добавление варианта не создаёт форму автоматически.
Проверьте назначение процедуры в свойствах события: простое наличие одноимённого текста в модуле не является вызовом обработчика.
Ожидаемый результат
Событие имеет контекст и наблюдаемый прикладной результат, без фиктивного вызова платформы.
На что обратить внимание
Мобильные события не воспроизводятся в обычном настольном клиенте.
Статус не является подтверждением выполнения кода в 1С при сборке HTML.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.