ВставитьОбласть

[1cwiki]

Раздел

Общие объекты

Подразделы

Табличный документ

ТипСтатьи

Методы

Синтаксис:

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

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

Тип: ОбластьЯчеекТабличногоДокумента.
Исходная область.
<ОбластьПриемник> (необязательный)

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

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

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

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

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

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

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

Код Выделить Развернуть

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