Вставляет копию исходной области табличного документа в область-приемник.
Синтаксис
ВставитьОбласть(<ИсходнаяОбласть>, <ОбластьПриемник>, <Сдвиг>, <ЗаполнятьПараметры>)Примеры платформы
ТабДок = Новый ТабличныйДокумент;
Итог = 0;
Для К=1 По 10 Цикл
ТабДок.Область("R"+(К+1)+"C1").Текст = "Строка "+К;
ТабДок.Область("R"+(К+1)+"C2").Текст = К*10;
Итог = Итог+К*10;
КонецЦикла;
ТабДок.ВставитьОбласть(ТабДок.Область("R2"), ТабДок.Область("R3"),
ТипСмещенияТабличногоДокумента.ПоГоризонтали);
ТабДок.Область("R2C1").Текст = "Итого:";
ТабДок.Область("R2C2").Текст = Итог;
Рамка = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная, 1);
ТабДок.Область("R2C1:R2C2").Обвести(,Рамка,,Рамка);
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Защита = Ложь;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.Показать("Пример использования метода ВставитьОбласть()");Полное описание, параметры и ограничения
ТабличныйДокумент.ВставитьОбласть (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.
Методическая информация
Практические примеры
Копировать прямоугольный блок без сдвига соседних ячеек
Пример для вставки готового блока в отведённое место. Приёмник совпадает с исходником по размеру; соседняя ячейка остаётся на месте.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
Источник = Новый ТабличныйДокумент;
Источник.Область(1, 1).Текст = "Книга";
Источник.Область(1, 2).Текст = "750";
Источник.Область(2, 1).Текст = "Ручка";
Источник.Область(2, 2).Текст = "50";
ТабДок.Область(3, 5).Текст = "Контрольная ячейка";
ТабДок.ВставитьОбласть(Источник.Область(1, 1, 2, 2), ТабДок.Область(3, 2, 4, 3),
ТипСмещенияТабличногоДокумента.БезСмещения);
Сообщить(ТабДок.Область(3, 2).Текст = "Книга");
Сообщить(ТабДок.Область(4, 3).Текст = "50");
Сообщить(ТабДок.Область(3, 5).Текст = "Контрольная ячейка");
Источник.Область(1, 1).Текст = "Изменён только источник";
Сообщить(ТабДок.Область(3, 2).Текст = "Книга");
ТабДок.ТолькоПросмотр = Истина;
Возврат ТабДок;
КонецФункции
Разбор по шагам
Источник размером 2×2 копируется в строки 3–4, колонки 2–3 нового документа. Приёмник задаём явно, не полагаемся на положение по умолчанию.
БезСмещения означает запись копии в указанную область. Уже занятое содержимое приёмника могло бы быть заменено; в упражнении место пустое.
Изменяем источник после вставки и проверяем независимость копии. Соседняя контрольная ячейка не переместилась.
Как проверить результат
Четыре проверки дают Истина.
В показе блок Книга/750 и Ручка/50 находится в колонках B–C, строках 3–4; контрольная надпись в E3.
Ожидаемый результат
Копирование блока с явной геометрией и без неожиданного сдвига.
На что обратить внимание
БезСмещения не означает запрет перезаписи приёмника. Не вставляйте поверх ценных данных без проверки.
Координаты табличного документа начинаются с 1, индексы коллекций — с 0.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Вставить учебную строку с вертикальным сдвигом и удалить её
Строки табличного документа — координаты, а не записи базы. Вставляем копию собственной области строк и проверяем смещение исходного итога.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
ТабДок.Область(1, 1).Текст = "Книга";
ТабДок.Область(2, 1).Текст = "Ручка";
ТабДок.Область(3, 1).Текст = "Итого 800";
Вставка = Новый ТабличныйДокумент;
Вставка.Область(1, 1).Текст = "Учебная вставка";
ИсходнаяСтрока = Вставка.Область(1, , 1, );
СтрокаПриемник = ТабДок.Область(2, , 2, );
ТабДок.ВставитьОбласть(ИсходнаяСтрока, СтрокаПриемник, ТипСмещенияТабличногоДокумента.ПоВертикали);
Сообщить(ТабДок.Область(2, 1).Текст = "Учебная вставка");
Сообщить(ТабДок.Область(3, 1).Текст = "Ручка");
Сообщить(ТабДок.Область(4, 1).Текст = "Итого 800");
ТабДок.УдалитьОбласть(ТабДок.Область(2, , 2, ), ТипСмещенияТабличногоДокумента.ПоВертикали);
Сообщить(ТабДок.Область(2, 1).Текст = "Ручка");
Сообщить(ТабДок.Область(3, 1).Текст = "Итого 800");
ТабДок.ТолькоПросмотр = Истина;
Возврат ТабДок;
КонецФункции
Разбор по шагам
Пропущенные колонки в Область(2,,2,) обозначают область всей строки. Исходная и принимающая области здесь по одной строке.
Вертикальный сдвиг освобождает место: Ручка переезжает из 2 в 3, итог из 3 в 4.
Удаление той же вставленной строки с вертикальным сдвигом возвращает исходные координаты. Нет изменения товаров или регистра.
Как проверить результат
Пять проверок дают Истина.
В итоговом показе снова три строки: Книга, Ручка, Итого 800. Вставка была проверена до удаления.
Ожидаемый результат
Обратимая вставка в собственный табличный документ с контролем координат.
На что обратить внимание
Это удаление области только нового документа в памяти, не удаление строк исходного отчёта или объектов базы.
Для прямоугольных областей размеры должны совпадать; направление сдвига имеет отдельный смысл.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.