Расширение формы элемента справочника.ПриИзмененииДанных

События · OnDataChange

Возникает при инициализации формы, перечитывании данных, смене объекта основного реквизита. Предназначено для отображения данных объекта в элементах управления, которые не связаны непосредственно с данными, например, отображение картинки.

Синтаксис

ПриИзмененииДанных()
Полное описание, параметры и ограничения

Расширение формы элемента справочника.ПриИзмененииДанных (Catalog item form extension.OnDataChange)

Расширение формы элемента справочника (Catalog item form extension)

ПриИзмененииДанных (OnDataChange)

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

Синтаксис:
ПриИзмененииДанных()
Описание:

Возникает при инициализации формы, перечитывании данных, смене объекта основного реквизита.
Предназначено для отображения данных объекта в элементах управления, которые не связаны непосредственно с данными, например, отображение картинки.

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

Толстый клиент.

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

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

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

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

ПриИзмененииДанных: обычная форма УчебныеКарточки

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

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

Основной код — модуль собственной обычной объектной формы, толстый клиент; открытие — модуль другой обычной учебной формы.

Подготовка

  1. Работайте только в собственной пустой учебной конфигурации. В Конфигураторе создайте Справочник УчебныеКарточки; не добавляйте эти учебные объекты в рабочую базу.

  2. Код — строковый длиной 10, наименование длиной 100. Для справочника, плана обмена и плана видов характеристик включите автонумерацию. Для счетов и видов расчёта код назначается явно в примере.

  3. Справочник неиерархический, без владельца. Имя УчебныеКарточки не означает наличие такого справочника в типовой конфигурации.

  4. Добавьте реквизиты Комментарий (Строка 100), Лимит (Число 15.2 с разрешённым отрицательным знаком), ЗапретУдаления (Булево). Не делайте их автоматически обязательными: дополнительные правила описаны отдельными обработчиками.

  5. У Справочник УчебныеКарточки создайте именно обычную объектную форму УчебнаяОбычная, не управляемую и не форму списка. Основной реквизит формы назовите Объект, тип — объект данного собственного метаданного.

  6. Выведите Объект.Лимит и Объект.Комментарий на форму. Оставьте штатные команды записи. Добавьте надпись УчебноеПояснение без связи с данными.

  7. В модуле этой формы назначьте событие ПриИзмененииДанных основной процедуре из примера. Процедуры соседних событий размещаются отдельно, каждая только один раз.

  8. В отдельной внешней обработке создайте обычную форму и кнопку ОткрытьСвойОбъект; последний дополнительный блок назначьте её обработчиком. Это настоящий производитель объекта, который получает его именованную форму.

  9. Запуск — толстый клиент, обычные формы, отдельная учебная конфигурация. Директивы &НаКлиенте / &НаСервере в модуль обычной формы не добавляются.

  10. Для обычного опыта задайте число 25. Старт процесса выполняется только подготовительным производителем задачи; сами события записи не стартуют процесс и не выполняют задачу.

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

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

  1. Открываем точную обычную форму собственного объекта, созданного дополнительным кодом.

  2. Платформа вызывает назначенный обработчик своей формы с параметрами установленной справки.

  3. При инициализации или перечитывании объекта обновляем отдельную надпись, которая не связана с данными. Это не событие изменения каждого символа в поле ввода.

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

  1. Откройте собственный объект: надпись показывает его комментарий.

  2. Перечитайте сохранённые данные штатной командой формы: надпись обновляется. Само событие ничего не записывает.

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

Событие проверяется в настоящей собственной объектной форме толстого клиента.

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

  1. Этот пример не предназначен для управляемой формы: контексты и последовательности событий различаются.

  2. Правило формы не защищает программную запись без этой формы; общие правила данных размещают в модуле объекта.

  3. Не вызывайте Записать повторно внутри ПередЗаписью, ПриЗаписи или ПослеЗаписи; здесь нет рекурсивной записи.

  4. ПриИзмененииДанных означает инициализацию / перечитывание / смену объекта, а не пользовательское ПриИзменении отдельного поля.

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

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

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

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

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