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

Метод ОТЧЕТ.ОБЪЕДИНИТЬ_СТОЛБЦЫ

Метод ОБЪЕДИНИТЬ_СТОЛБЦЫ позволяет объединить заданные столбцы таблицы. Необходимо указать имена объединяемых столбцов и заголовок, который выводится в объединенной ячейке. Результатом объединения будет появление в заголовке отчета еще одной строки с заданным текстом, которая объединяет указанные столбцы. Каждый вызов метода ОБЪЕДИНИТЬ_СТОЛБЦЫ добавляет еще одну объединяющую строку в заголовок таблицы. Соответственно, количество строк, отводимых для заголовка таблицы, равно максимальному количеству объединений + 1. Максимально создается 10 строк, а если объединений задано больше, то в окно отладки выводиится предупреждение. Строки в заголовке отчета автоматически объединяются по вертикали в случае, если для столбца не задано ни одного объединения, а также в случае, если объединение не прерывается другим объединением.

Если имена обоих столбцов не заданы (""), то добавляется объединение для всех не фиксированных столбцов.

ФУНКЦИЯ ОБЪЕДИНИТЬ_СТОЛБЦЫ(СТРОКА: столбец1; 
                           СТРОКА: столбец2; 
                           СТРОКА: текст)

Параметры

столбец1
Имя первого столбца объединения.
столбец2
Имя последнего столбца объединения.
текст
Текст, который выводится в заголовке объединенного столбца.

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


См. также: