ФормаКлиентскогоПриложения.ОбработкаАктивизации

События · ActivationProcessing

Возникает на клиенте в подчиненной форме, если в форме-владельце изменился активный объект или в форме-владельце был вызван метод ОповеститьОбАктивизации.

Синтаксис

ОбработкаАктивизации(<АктивныйОбъект>, <Источник>)
Полное описание, параметры и ограничения

ФормаКлиентскогоПриложения.ОбработкаАктивизации (ClientApplicationForm.ActivationProcessing)

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

ОбработкаАктивизации (ActivationProcessing)

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

Синтаксис:
ОбработкаАктивизации(<АктивныйОбъект>, <Источник>)
Параметры:

<АктивныйОбъект>
Тип: Произвольный.
Активный объект.

<Источник>
Тип: ФормаКлиентскогоПриложения, Форма.
Форма - источник сообщения.
Описание:

Возникает на клиенте в подчиненной форме, если в форме-владельце изменился активный объект или в форме-владельце был вызван метод ОповеститьОбАктивизации.

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

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

Примечание:
В обработчике данного события нельзя использовать серверные методы формы с директивой компиляции &НаСервере, а также изменять свойства, которые могут привести к серверному вызову.
Использование в версии:

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

Описание изменено в версии 8.3.15.

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

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

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

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

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

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

Подготовка

  1. В учебной конфигурации создайте собственный справочник УчебныеКарточки (код Строка 10, наименование 100), одну свою карточку Книга и обработку УчебныеСобытияФорм с управляемыми формами Основная и Детали.

  2. В Основная добавьте Книга типа СправочникСсылка.УчебныеКарточки и выберите собственную карточку. В Детали добавьте АктивнаяКарточка того же типа, СчетчикСобытий Число 10.0 и СтатусУрока Строка 200.

  3. Основной блок и инициализация относятся к форме Детали. Отдельный блок двух команд — только к Основная. Откройте Детали первой командой, затем второй передайте активную карточку; владелец задаётся третьим аргументом ОткрытьФорму.

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

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

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

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

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

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

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

  2. Если открыть Детали без владельца, нужной связи форм не будет. В обработчике нет серверного чтения карточки или вызова &НаСервере.

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

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

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

  1. ОбработкаАктивизации не допускает серверных методов формы и изменений свойств, вызывающих серверный вызов.

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

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

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

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

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

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

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

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