Расширение поля формы для поля табличного документа.ОбработкаРасшифровки

События · DetailProcessing

Возникает при двойном щелчке мыши (нажатии клавиши Enter) на ячейке или рисунке, которые содержат значение расшифровки.

Синтаксис

ОбработкаРасшифровки(<Расшифровка>, <СтандартнаяОбработка>, <ДополнительныеПараметры>)
Полное описание, параметры и ограничения

Расширение поля формы для поля табличного документа.ОбработкаРасшифровки (Form field extension for a spreadsheet document field.DetailProcessing)

Расширение поля формы для поля табличного документа (Form field extension for a spreadsheet document field)

ОбработкаРасшифровки (DetailProcessing)

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

Синтаксис:
ОбработкаРасшифровки(<Расшифровка>, <СтандартнаяОбработка>, <ДополнительныеПараметры>)
Параметры:

<Расшифровка>
Тип: Произвольный.
Значение расшифровки точки, серии или значения диаграммы.

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

<ДополнительныеПараметры>
Тип: Структура.
Если событие сформировано элементом формы ДиаграммаГанта и выполняется обработка расшифровки для значения или интервала диаграммы Ганта, то в этот параметр помещается структура со свойством Дата(Date) типа Дата, значение которого соответствует точке выбора.
В других случаях этот параметр будет содержать пустую структуру.
Параметр недоступен в режиме совместимости конфигурации Версия8_3_9 и ниже.
Описание:

Возникает при двойном щелчке мыши (нажатии клавиши Enter) на ячейке или рисунке, которые содержат значение расшифровки.

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

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

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

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

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

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

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

Возникает при двойном щелчке мыши (нажатии клавиши Enter) на ячейке или рисунке, которые содержат значение расшифровки. Показать собственную расшифровку ячейки.

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

Клиентский модуль собственной управляемой формы. Элемент передаёт платформа; дополнительный блок — отдельный серверный обработчик создания.

Подготовка

  1. Создайте внешнюю учебную обработку с управляемой формой. Реквизиты формы: Статус (Строка 200), Счетчик (Число 10.0), РазрешитьСохранение (Булево). Выведите Статус и РазрешитьСохранение на форму.

  2. Основной обработчик назначается событию указанного элемента Образец, а не событию формы. Код вставляется на уровне модуля формы с директивой НаКлиенте. Дополнительный серверный блок назначьте событию формы ПриСозданииНаСервере.

  3. Открывайте обработку в настольном тонком клиенте. Каждый урок проверяйте в отдельном варианте формы; HTML показывает код, но не исполняет его.

  4. Добавьте реквизит УчебныйДокумент типа ТабличныйДокумент и элемент Образец вида ПолеТабличногоДокумента, путь к данным УчебныйДокумент. У поля Редактирование Истина и Защита Ложь; ячейка A1 разрешена для интерактивного редактирования.

  5. В свойствах элемента Образец → События назначьте ОбработкаРасшифровки процедуре ОбразецОбработкаРасшифровки. Подготовка использует текущую сигнатуру установленной справки плюс неявный параметр Элемент управляемой формы.

&НаКлиенте
Процедура ОбразецОбработкаРасшифровки(Элемент, Расшифровка, СтандартнаяОбработка, ДополнительныеПараметры)
    СтандартнаяОбработка = Ложь;
    Статус = "Код учебной ячейки: " + Строка(Расшифровка);
    Сообщить(Статус);
КонецПроцедуры
Подготовить собственное содержимое формы
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Счетчик = 0;
    РазрешитьСохранение = Ложь;
    Статус = "Готово";
    Документ = Новый ТабличныйДокумент;
    Ячейка = Документ.Область(1, 1);
    Ячейка.Текст = "Книга";
    Ячейка.Расшифровка = "УЧЕБНЫЙ-КОД";
    Ячейка.Защита = Ложь;
    УчебныйДокумент = Документ;
    Элементы.Образец.Редактирование = Истина;
    Элементы.Образец.Защита = Ложь;
    Элементы.Образец.Вывод = ИспользованиеВывода.Разрешить;
КонецПроцедуры

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

  1. Дополнительный серверный блок создаёт собственные данные, элемент подготовлен в редакторе формы.

  2. Платформа вызывает назначенный обработчик вследствие действия пользователя; процедуру с придуманными параметрами вручную не вызываем.

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

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

  1. Для A1 с Расшифровка УЧЕБНЫЙ-КОД двойной щелчок или Enter вызывает обычную расшифровку; правая кнопка или клавиша меню — дополнительную.

  2. Выводится переданный код, не номер строки и не ссылка из другой конфигурации. Дополнительная расшифровка не запускает стандартное контекстное действие.

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

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

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

  1. Настольный тонкий клиент — контекст этого урока. Доступность и порядок событий в веб- и мобильном клиентах могут отличаться.

  2. Код не открывает внешние страницы, не отправляет сообщения и не обращается к рабочим документам.

  3. Свойство СтандартнаяОбработка и параметр Отказ имеют разные назначения: первый заменяет стандартное действие, второй отменяет операцию.

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

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

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

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

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