Вызывается при нажатии на гиперссылку форматированной строки, расположенной в элементе формы типа Расширение поля формы для поля надписи или в элементе формы Расширение декорации формы для надписи, у которого свойство Гиперссылка имеет значение Ложь.
Синтаксис
ОбработкаНавигационнойСсылки(<НавигационнаяСсылкаФорматированнойСтроки>, <СтандартнаяОбработка>)Полное описание, параметры и ограничения
ФормаКлиентскогоПриложения.ОбработкаНавигационнойСсылки (ClientApplicationForm.URLProcessing)
ФормаКлиентскогоПриложения (ClientApplicationForm)
ОбработкаНавигационнойСсылки (URLProcessing)
Доступен, начиная с версии 8.3.1.
Синтаксис:
ОбработкаНавигационнойСсылки(<НавигационнаяСсылкаФорматированнойСтроки>, <СтандартнаяОбработка>)
Параметры:
<НавигационнаяСсылкаФорматированнойСтроки>
Тип: Строка.
Значение гиперссылки форматированной строки.
<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет.
Значение по умолчанию: Истина.
Описание:
Вызывается при нажатии на гиперссылку форматированной строки, расположенной в элементе формы типа Расширение поля формы для поля надписи или в элементе формы Расширение декорации формы для надписи, у которого свойство Гиперссылка имеет значение Ложь.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).
Использование в версии:
Доступен, начиная с версии 8.3.1.
Методическая информация
Практические примеры
Разобрать событие «ОбработкаНавигационнойСсылки» на собственном элементе
Подготавливаем конкретную свою форму и вызываем событие обычным пользовательским действием. Основной блок — настоящий обработчик, а не прямой ручной вызов события.
Где и как запускать
Клиентский обработчик собственной управляемой формы; подготовка данных отдельно в ПриСозданииНаСервере.
Подготовка
Создайте внешнюю обработку с собственной управляемой формой, запуск — тонкий клиент, если ниже не указан другой клиент.
Добавьте СчетчикСобытий (Число 10.0) и СтатусУрока (Строка 200), выведите оба на форму. Дополнительный блок инициализации поместите в модуль этой же формы.
Основной обработчик назначьте через свойства нужного элемента → События. Параметр Элемент добавляется обработчику события элемента формы; у события самой формы его нет. Не создавайте вторую процедуру с тем же именем.
Создайте декорацию Памятка вида Надпись. Это не поле ввода и не картинка.
У Памятка установите Гиперссылка = Ложь: ссылка находится внутри форматированной строки, а не назначается всей надписи.
Назначьте событие ОбработкаНавигационнойСсылки самой форме, не элементу; обработчик элемента оставьте пустым.
После открытия щёлкните собственную ссылку О книге. Значение lesson:book — локальная метка примера, не адрес сайта.
&НаКлиенте
Процедура ОбработкаНавигационнойСсылки(НавигационнаяСсылкаФорматированнойСтроки, СтандартнаяОбработка)
Если НавигационнаяСсылкаФорматированнойСтроки = "lesson:book" Тогда
СтандартнаяОбработка = Ложь;
СчетчикСобытий = СчетчикСобытий + 1;
СтатусУрока = "Учебная книга: 3 экземпляра";
Сообщить(СтатусУрока);
КонецЕсли;
КонецПроцедурыТа же собственная форма: подготовка до интерактивного действия
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
СчетчикСобытий = 0;
СтатусУрока = "Ожидается действие пользователя";
Элементы.Памятка.Заголовок = Новый ФорматированнаяСтрока("О книге", , , , "lesson:book");
Элементы.Памятка.Гиперссылка = Ложь;
КонецПроцедурыРазбор по шагам
Разместите указанный элемент и отдельный инициализатор в правильном модуле.
Назначьте обработчик через свойства события и выполните указанное пользовательское действие.
Посмотрите собственный статус / результат; не путайте событие с похожими соседними событиями.
Как проверить результат
Нажатие собственной ссылки показывает памятку, не открывая браузер и не переходя по неизвестному адресу.
Для других ссылок обработчик сохраняет стандартную обработку. Гиперссылка = Истина вызывает другое событие — Нажатие.
Ожидаемый результат
Событие связано с реальным источником, известными собственными данными и воспроизводимым действием.
На что обратить внимание
Не добавляйте Элемент в события самой формы / модуль команды; у событий элементов формы он является контекстным параметром обработчика.
Разные дополнительные блоки относятся к явно названным модулям; одинаковые процедуры инициализации объединяются, а не дублируются.
Код 1С при сборке справочника не исполнялся; сеть, рабочие записи, печать и внешние компоненты не использовались.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.