ТабличныйДокумент.ВставитьОбласть (SpreadsheetDocument.InsertArea)

ТабличныйДокумент (SpreadsheetDocument)

ВставитьОбласть (InsertArea)

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

Синтаксис:

ВставитьОбласть(<ИсходнаяОбласть>, <ОбластьПриемник>, <Сдвиг>, <ЗаполнятьПараметры>)

Параметры:

<ИсходнаяОбласть> (обязательный)

Тип: ОбластьЯчеекТабличногоДокумента.
Исходная область.

<ОбластьПриемник> (необязательный)

Тип: ОбластьЯчеекТабличногоДокумента.
Область-приемник. Если параметр не задан, то вставка области производится справа от исходной области (с учетом сдвига).

<Сдвиг> (необязательный)

Тип: ТипСмещенияТабличногоДокумента.
Определяет смещение ячеек таблицы при вставке. Имеет смысл только для прямоугольной области ячеек.
Для областей строк/колонок при любом значении параметра, отличающимся от БезСмещения, смещение будет происходить по вертикали/горизонтали соответственно.
Значение по умолчанию: БезСмещения.

<ЗаполнятьПараметры> (необязательный)

Тип: Булево.
Необходимость заполнения параметров их значениями.
В случае, если значение параметра не указано, в текст результирующих ячеек будут помещены имена параметров исходных ячеек.
Значение по умолчанию: Истина.

Описание:

Вставляет копию исходной области табличного документа в область-приемник.

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

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

Примечание:

Если размеры исходной области не соответствуют результирующей области, то при выполнении метода возникает ошибка.
Свойство Формат ячейки табличного документа не используется для форматирования значений, выводимых в при помощи шаблона.

Пример:

ТабДок = Новый ТабличныйДокумент;
Итог = 0;
Для К=1 По 10 Цикл
    ТабДок.Область("R"+(К+1)+"C1").Текст = "Строка "+К;
    ТабДок.Область("R"+(К+1)+"C2").Текст = К*10;
    Итог = Итог+К*10;
КонецЦикла;
ТабДок.ВставитьОбласть(ТабДок.Область("R2"), ТабДок.Область("R3"),
        ТипСмещенияТабличногоДокумента.ПоГоризонтали);
ТабДок.Область("R2C1").Текст = "Итого:";
ТабДок.Область("R2C2").Текст = Итог;
Рамка = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная, 1);
ТабДок.Область("R2C1:R2C2").Обвести(,Рамка,,Рамка);
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Защита = Ложь;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.Показать("Пример использования метода ВставитьОбласть()");

См. также:

ТабличныйДокумент, метод УдалитьОбласть

Использование в версии:

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

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