ФормаКлиентскогоПриложения.ОбработкаНавигационнойСсылки

События · URLProcessing

Вызывается при нажатии на гиперссылку форматированной строки, расположенной в элементе формы типа Расширение поля формы для поля надписи или в элементе формы Расширение декорации формы для надписи, у которого свойство Гиперссылка имеет значение Ложь.

Синтаксис

ОбработкаНавигационнойСсылки(<НавигационнаяСсылкаФорматированнойСтроки>, <СтандартнаяОбработка>)
Полное описание, параметры и ограничения

ФормаКлиентскогоПриложения.ОбработкаНавигационнойСсылки (ClientApplicationForm.URLProcessing)

ФормаКлиентскогоПриложения (ClientApplicationForm)

ОбработкаНавигационнойСсылки (URLProcessing)

Доступен, начиная с версии 8.3.1.

Синтаксис:
ОбработкаНавигационнойСсылки(<НавигационнаяСсылкаФорматированнойСтроки>, <СтандартнаяОбработка>)
Параметры:

<НавигационнаяСсылкаФорматированнойСтроки>
Тип: Строка.
Значение гиперссылки форматированной строки.

<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет.
Значение по умолчанию: Истина.
Описание:

Вызывается при нажатии на гиперссылку форматированной строки, расположенной в элементе формы типа Расширение поля формы для поля надписи или в элементе формы Расширение декорации формы для надписи, у которого свойство Гиперссылка имеет значение Ложь.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

Использование в версии:

Доступен, начиная с версии 8.3.1.

Методическая информация

Практические примеры

Разобрать событие «ОбработкаНавигационнойСсылки» на собственном элементе

Подготавливаем конкретную свою форму и вызываем событие обычным пользовательским действием. Основной блок — настоящий обработчик, а не прямой ручной вызов события.

Где и как запускать

Клиентский обработчик собственной управляемой формы; подготовка данных отдельно в ПриСозданииНаСервере.

Подготовка

  1. Создайте внешнюю обработку с собственной управляемой формой, запуск — тонкий клиент, если ниже не указан другой клиент.

  2. Добавьте СчетчикСобытий (Число 10.0) и СтатусУрока (Строка 200), выведите оба на форму. Дополнительный блок инициализации поместите в модуль этой же формы.

  3. Основной обработчик назначьте через свойства нужного элемента → События. Параметр Элемент добавляется обработчику события элемента формы; у события самой формы его нет. Не создавайте вторую процедуру с тем же именем.

  4. Создайте декорацию Памятка вида Надпись. Это не поле ввода и не картинка.

  5. У Памятка установите Гиперссылка = Ложь: ссылка находится внутри форматированной строки, а не назначается всей надписи.

  6. Назначьте событие ОбработкаНавигационнойСсылки самой форме, не элементу; обработчик элемента оставьте пустым.

  7. После открытия щёлкните собственную ссылку О книге. Значение lesson:book — локальная метка примера, не адрес сайта.

&НаКлиенте
Процедура ОбработкаНавигационнойСсылки(НавигационнаяСсылкаФорматированнойСтроки, СтандартнаяОбработка)
    Если НавигационнаяСсылкаФорматированнойСтроки = "lesson:book" Тогда
        СтандартнаяОбработка = Ложь;
        СчетчикСобытий = СчетчикСобытий + 1;
        СтатусУрока = "Учебная книга: 3 экземпляра";
        Сообщить(СтатусУрока);
    КонецЕсли;
КонецПроцедуры
Та же собственная форма: подготовка до интерактивного действия
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    СчетчикСобытий = 0;
    СтатусУрока = "Ожидается действие пользователя";
    Элементы.Памятка.Заголовок = Новый ФорматированнаяСтрока("О книге", , , , "lesson:book");
    Элементы.Памятка.Гиперссылка = Ложь;
КонецПроцедуры

Разбор по шагам

  1. Разместите указанный элемент и отдельный инициализатор в правильном модуле.

  2. Назначьте обработчик через свойства события и выполните указанное пользовательское действие.

  3. Посмотрите собственный статус / результат; не путайте событие с похожими соседними событиями.

Как проверить результат

  1. Нажатие собственной ссылки показывает памятку, не открывая браузер и не переходя по неизвестному адресу.

  2. Для других ссылок обработчик сохраняет стандартную обработку. Гиперссылка = Истина вызывает другое событие — Нажатие.

Ожидаемый результат

Событие связано с реальным источником, известными собственными данными и воспроизводимым действием.

На что обратить внимание

  1. Не добавляйте Элемент в события самой формы / модуль команды; у событий элементов формы он является контекстным параметром обработчика.

  2. Разные дополнительные блоки относятся к явно названным модулям; одинаковые процедуры инициализации объединяются, а не дублируются.

  3. Код 1С при сборке справочника не исполнялся; сеть, рабочие записи, печать и внешние компоненты не использовались.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.