Метод ОТЧЕТ.ОБЪЕДИНИТЬ_ЯЧЕЙКИ
Метод ОБЪЕДИНИТЬ_ЯЧЕЙКИ позволяет объединить указанные ячейки в таблице. Область объединения задается координатами столбцов и строк. Если имена столбцов не заданы (""), то добавляется объединение для всех не фиксированных столбцов.
ФУНКЦИЯ ОБЪЕДИНИТЬ_ЯЧЕЙКИ(СТРОКА: столбец1;
СТРОКА: столбец2;
ЦЕЛОЕ: строка1;
ЦЕЛОЕ: строка2;
*: знач = "")
Параметры
- столбец1
- Имя первого столбца объединения.
- столбец2
- Имя последнего столбца объединения.
- строка1
- Номер первой строки объединения.
- строка2
- Номер последней строки объединения. Номер первой строки объединения должен быть меньше номера последней строки объединения.
- знач
- Текст, отображающийся в объединенной ячейке. Если задана пустая строка – берется текст из левой верхней ячейки объединения.
Если создается объединение, где строка1 = строка2, то происходит привязка к строке. Такое объединение будет смещаться вместе со строкой при вставке/удалении строк перед заданной, а также при сортировке.
Объединения, занимающие несколько строк, не изменяют привязки к номерам строки при вставке и удалении, что обычно не соответствует требованиям к отчету. Поэтому при таких операциях следует удалить многострочные объединения, а потом снова добавить в нужное место. Структура вертикальных объединений при сортировке сохраняется, но в сортировке участвуют только верхние строки объединенного блока. Значения в столбцах и дополнительных атрибутах для подстрок игнорируются.
В случае, если заданы некорректные значения параметров (неверный порядок расположения объединяемых столбцов и строк, один или оба указанных столбца отсутствуют) – объединения ячеек не происходит.
Объединения ячеек не должны пересекаться. Если уже существует объединение для столбец1 и столбец2, то возможны два случая, не приводящих к ошибке. Когда новое объединение полностью находится внутри старого, то добавления меньшего объединения не происходит. Когда новое объединение полностью накрывает старое, то маленькое старое объединение заменяется большим новым. Во всех остальных случаях пересечения генерируется ошибка.