Как получить секции в табличном документе?

Понятие "секции", существовавшее в 1С:Предприятии 7.7, не используется в 1С:Предприятии 8. Теперь табличный документ может содержать области, представляющие собой совокупность ячеек прямоугольной формы, состоящую из смежных ячеек. Для области может быть задано имя, по которому можно обращаться к этой области из встроенного языка.

Если табличный документ используется в качестве макета, на основании которого формируется итоговый табличный документ, возникает необходимость получения различных областей макета, для установки значений параметров и вывода этих областей в итоговый табличный документ. В этом случае следует воспользоваться методом  табличного документа ПолучитьОбласть(). Область будет получена в виде нового табличного документа.

Для получения области может быть использовано ее имя. Например:

Копировать в буфер обмена
Макет = ОтчетОбъект.ПолучитьМакет("МакетОтчета");

ПростойЗаголовок = Макет.ПолучитьОбласть("Заголовок");

Если необходимо получить область, которая находится на пересечении двух именованных областей, следует использовать следующий синтаксис:

Копировать в буфер обмена
ОсновнойЗаголовок = Макет.ПолучитьОбласть("Заголовок|Основной");

Область табличного документа можно получить также указывая номера строк и столбцов, ограничивающих нужную область. Например, прямоугольная область в левом верхнем углу табличного документа, шириной в 5 столбцов и высотой в 3 может быть получена следующим образом:

Копировать в буфер обмена
ПроизвольнаяОбласть = Макет.ПолучитьОбласть(1,1,3,5);

Для получения области табличного документа также может быть передан адрес в формате RC:

Копировать в буфер обмена
ПроизвольнаяОбласть = Макет.ПолучитьОбласть("R1C1:R3C5");

Наряду с методом ПолучитьОбласть() у табличного документа существует свойство "Область", имеющее аналогичный синтаксис.

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

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