Метод табличного документа ВставитьОбласть() предназначен для копирования некоторой области ячеек табличного документа в другой или тот же табличный документ.
Данный метод принимает следующие параметры:
В случае если область-приемник не указана, вставка области будет производиться в область, непосредственно следующую за исходной областью: для областей - строк, область вставки будет расположена ниже исходной области, областей - колонок - справа от исходной области.
Для прямоугольных областей положение зависит от параметра "Сдвиг": для сдвига по вертикали - ниже исходной области, для других значений - справа от исходной области.
Если копирование происходит из одного табличного документа в другой, и область приемник не указана, вставка также будет происходить в область, которая следует за областью, с таким же положением, как у исходной области.
Например, если из одного табличного документа копируется область с координатами (строка 1, колонка 1) и область - приемник не указана, а параметр "Сдвиг" имеет значение ТипСмещенияТабличногоДокумента.ПоВертикали, то вставка в другой табличный документ произойдет в область с координатами (строка 2, колонка 1).
Сдвиг - данный параметр указывает, каким образом производить смещение областей.
В случае если данный параметр имеет значение ТипСмещенияТабличногоДокумента.ПоГоризонтали, при вставке прямоугольной области осуществится сдвиг всех ячеек, расположенных в области - приемнике, и ячеек, расположенных праве ее, в тех же строках.
При указании сдвига ТипСмещенияТабличногоДокумента.ПоВертикали осуществится смещение вниз.
Если же сдвиг указан ТипСмещенияТабличногоДокумента.БезСмещения, то смещения ячеек происходить не будет, т.е. содержимое области - приемника будет заменено на содержимое исходной области.
При вставке областей строк и областей колонок типы сдвига ТипСмещенияТабличногоДокумента.ПоГоризонтали и ТипСмещенияТабличногоДокумента.ПоВертикали игнорируются, а сдвиг будет происходить для строк - по вертикали, для колонок - по горизонтали.
Заполнять параметры - необходимость заполнять параметры, которые присутствуют в области - источнике. В случае если данный параметр имеет значение Истина, параметры ячеек будут заменены соответствующими значениями. Если Ложь - никаких действий с параметрами производиться не будет, и область будет скопирована с параметрами.