ДекорацияФормы.ПолучитьДействие

Методы · GetAction

Получает имя установленного обработчика события.

Синтаксис

ПолучитьДействие(<ИмяСобытия>)
Полное описание, параметры и ограничения

ДекорацияФормы.ПолучитьДействие (FormDecoration.GetAction)

ДекорацияФормы (FormDecoration)

ПолучитьДействие (GetAction)

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

Синтаксис:
ПолучитьДействие(<ИмяСобытия>)
Параметры:

<ИмяСобытия> (обязательный)
Тип: Строка.
Имя события, для которого устанавливается новое действие.
Возвращаемое значение:
Тип: Строка.

Описание:

Получает имя установленного обработчика события.

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

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

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

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

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

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

Сделать учебную надпись кликабельной без перехода на сайт

Гиперссылка включает Нажатие() с нулём параметров. Обработчик показывает собственное значение; браузер, сеть и запись не используются.

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

Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.

Подготовка

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

  2. Не создавайте вручную УчебноеНазвание, УчебнаяГруппа, ПолеУчебногоНазвания и УчебнаяНадпись: код добавляет их сам.

  3. В событиях формы назначьте ПриСозданииНаСервере одноимённому обработчику. Вставьте весь модуль на уровне модуля, включая клиентские процедуры.

  4. Откройте сохранённую учебную EPF в настольном тонком/толстом или веб-клиенте. Данные принадлежат только этой форме; справочники, документы и регистры не используются.

  5. Внешняя кнопка находится вне учебной группы и остаётся доступной для обратного переключения. Код не обходит ограничения на внешние обработки.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Новые = Новый Массив;
    Новые.Добавить(Новый РеквизитФормы("УчебноеНазвание", Новый ОписаниеТипов("Строка")));
    ЭтаФорма.ИзменитьРеквизиты(Новые);
    ЭтаФорма.УчебноеНазвание = "Книга";
    Группа = Элементы.Добавить("УчебнаяГруппа", Тип("ГруппаФормы"));
    Группа.Вид = ВидГруппыФормы.ОбычнаяГруппа;
    Группа.Заголовок = "Собственные учебные данные";
    Группа.Группировка = ГруппировкаПодчиненныхЭлементовФормы.Вертикальная;
    Поле = Элементы.Добавить("ПолеУчебногоНазвания", Тип("ПолеФормы"), Группа);
    Поле.Вид = ВидПоляФормы.ПолеВвода;
    Поле.ПутьКДанным = "УчебноеНазвание";
    Поле.Заголовок = "Название";
    Надпись = Элементы.Добавить("УчебнаяНадпись", Тип("ДекорацияФормы"), Группа);
    Надпись.Вид = ВидДекорацииФормы.Надпись;
    Надпись.Заголовок = "Данные только в памяти формы";
    Надпись.Гиперссылка = Истина;
    Надпись.Заголовок = "Показать собственное название";
    Надпись.УстановитьДействие("Нажатие", "УчебнаяНадписьНажатие");
    Сообщить(Надпись.ПолучитьДействие("Нажатие") = "УчебнаяНадписьНажатие");


    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Выполнить учебное действие";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры

&НаКлиенте
Процедура УчебноеДействие(Команда)
    Сообщить("Внешняя кнопка и надпись не запускают запись: " + ЭтаФорма.УчебноеНазвание);
КонецПроцедуры

&НаКлиенте
Процедура УчебнаяНадписьНажатие()
    Сообщить("Название из собственной формы: " + ЭтаФорма.УчебноеНазвание);
КонецПроцедуры

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

  1. Гиперссылка относится к расширению декорации вида Надпись.

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

  3. Клиентская процедура УчебнаяНадписьНажатие() не имеет Элемент или СтандартнаяОбработка.

  4. Нажатие мышью/клавиатурой вызывает только Сообщить с данными собственной формы.

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

  1. При создании проверка обработчика Истина.

  2. Измените название на Ручка и нажмите надпись: сообщение содержит Ручка; сайт и документы не открываются.

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

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

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

  1. Это не событие поля ввода ПриИзменении(Элемент).

  2. ОбработкаНавигационнойСсылки форматированной строки — другое событие с другой сигнатурой.

  3. Не подставляйте внешние URL или произвольные команды в этот учебный обработчик.

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

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

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

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

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