Руководство разработчика

Обработчик ТАБ_ФОРМА.макрос

Обработчик события макрос вызывается для вычисления значения подстановки макроса "специального" типа (константа ТФ_МАКРО_СПЕЦ). Ячейки типа макрос заполняются непосредственно при выводе формы на экран или на принтер. Обработчик макрос может использовать для расчета внешние данные (например, системное время), данные формы (например, сумма неких ячеек формы), информацию о текущей странице (только в режиме предварительного просмотра и при печати). В последнем случае вызов обработчика может происходить многократно, если ячейка макроса расположена в шапке, повторяющейся на разных страницах.

Во время вычисления макроса действует ограничение на вызов методов, которые изменяют табличную форму и состояние окна. В частности, не должны вызываться методы ОБНОВИТЬ, УСТ_КУР, а также другие УСТ_... методы. При попытке вызова методы, возвращающие логическое значение, возвращают НЕТ, а прочие методы - генерируют ошибку времени выполнения.

Данное событие относится к спонтанным, для его отладки необходимо отключить соответствующую опцию в параметрах проекта.

ФУНКЦИЯ ЛОГИКА: <имя функции>(ПЕРЕМ ТАБ_ФОРМА: форма; 
                              ТФ_ЯЧЕЙКА: ячейка; 
                              ТФ_ПАРАМ_МАКРОСА: парам; 
                              ПЕРЕМ *: знач)

Параметры

форма
Экземпляр табличной формы.
ячейка
Ячейка типа макрос, для которой осуществляется вычисление.
парам
Параметры макроса, включающие номер страницы, диапазон строк раздела, попадающих на страницу и др.
знач
Значение для подстановки.

Возвращаемое значение

ДА – если значение подстановки успешно вычислено и должно быть отображено, НЕТ – в противном случае.


См. также: