Возникает при инициализации формы, перечитывании данных, смене объекта основного реквизита. Предназначено для отображения данных объекта в элементах управления, которые не связаны непосредственно с данными, например, отображение картинки.
Синтаксис
ПриИзмененииДанных()Полное описание, параметры и ограничения
Расширение формы элемента справочника.ПриИзмененииДанных (Catalog item form extension.OnDataChange)
Расширение формы элемента справочника (Catalog item form extension)
ПриИзмененииДанных (OnDataChange)
Доступен, начиная с версии 8.0.
Синтаксис:
ПриИзмененииДанных()
Описание:
Возникает при инициализации формы, перечитывании данных, смене объекта основного реквизита.
Предназначено для отображения данных объекта в элементах управления, которые не связаны непосредственно с данными, например, отображение картинки.
Доступность:
Толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
ПриИзмененииДанных: обычная форма УчебныеКарточки
При инициализации или перечитывании объекта обновляем отдельную надпись, которая не связана с данными. Это не событие изменения каждого символа в поле ввода.
Где и как запускать
Основной код — модуль собственной обычной объектной формы, толстый клиент; открытие — модуль другой обычной учебной формы.
Подготовка
Работайте только в собственной пустой учебной конфигурации. В Конфигураторе создайте Справочник УчебныеКарточки; не добавляйте эти учебные объекты в рабочую базу.
Код — строковый длиной 10, наименование длиной 100. Для справочника, плана обмена и плана видов характеристик включите автонумерацию. Для счетов и видов расчёта код назначается явно в примере.
Справочник неиерархический, без владельца. Имя УчебныеКарточки не означает наличие такого справочника в типовой конфигурации.
Добавьте реквизиты Комментарий (Строка 100), Лимит (Число 15.2 с разрешённым отрицательным знаком), ЗапретУдаления (Булево). Не делайте их автоматически обязательными: дополнительные правила описаны отдельными обработчиками.
У Справочник УчебныеКарточки создайте именно обычную объектную форму УчебнаяОбычная, не управляемую и не форму списка. Основной реквизит формы назовите Объект, тип — объект данного собственного метаданного.
Выведите Объект.Лимит и Объект.Комментарий на форму. Оставьте штатные команды записи. Добавьте надпись УчебноеПояснение без связи с данными.
В модуле этой формы назначьте событие ПриИзмененииДанных основной процедуре из примера. Процедуры соседних событий размещаются отдельно, каждая только один раз.
В отдельной внешней обработке создайте обычную форму и кнопку ОткрытьСвойОбъект; последний дополнительный блок назначьте её обработчиком. Это настоящий производитель объекта, который получает его именованную форму.
Запуск — толстый клиент, обычные формы, отдельная учебная конфигурация. Директивы &НаКлиенте / &НаСервере в модуль обычной формы не добавляются.
Для обычного опыта задайте число 25. Старт процесса выполняется только подготовительным производителем задачи; сами события записи не стартуют процесс и не выполняют задачу.
Процедура ПриИзмененииДанных()
ТекстПояснения = "Комментарий объекта: " + Объект.Комментарий;
ЭлементыФормы.УчебноеПояснение.Заголовок = ТекстПояснения;
Сообщить(ТекстПояснения);
КонецПроцедурыОтдельная обычная учебная форма: собственный объект и его точная форма
Процедура ОткрытьСвойОбъект(Кнопка)
СвойОбъект = Справочники.УчебныеКарточки.СоздатьЭлемент();
СвойОбъект.Наименование = "Учебная карточка";
СвойОбъект.Лимит = 100;
СвойОбъект.Комментарий = "Учебный пример";
ФормаОбъекта = СвойОбъект.ПолучитьФорму("УчебнаяОбычная");
ФормаОбъекта.Открыть();
КонецПроцедурыРазбор по шагам
Открываем точную обычную форму собственного объекта, созданного дополнительным кодом.
Платформа вызывает назначенный обработчик своей формы с параметрами установленной справки.
При инициализации или перечитывании объекта обновляем отдельную надпись, которая не связана с данными. Это не событие изменения каждого символа в поле ввода.
Как проверить результат
Откройте собственный объект: надпись показывает его комментарий.
Перечитайте сохранённые данные штатной командой формы: надпись обновляется. Само событие ничего не записывает.
Ожидаемый результат
Событие проверяется в настоящей собственной объектной форме толстого клиента.
На что обратить внимание
Этот пример не предназначен для управляемой формы: контексты и последовательности событий различаются.
Правило формы не защищает программную запись без этой формы; общие правила данных размещают в модуле объекта.
Не вызывайте Записать повторно внутри ПередЗаписью, ПриЗаписи или ПослеЗаписи; здесь нет рекурсивной записи.
ПриИзмененииДанных означает инициализацию / перечитывание / смену объекта, а не пользовательское ПриИзменении отдельного поля.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.