Копирование диапазона
Last updated
Last updated
Компонент, позволяющий скопировать диапазон ячеек Excel и вставить в другой лист. Вставку возможно осуществить как внутри одного документа, так и во внешний файл Excel.
Диапазон копируется в соответствии с форматом, заданным в одноименном свойстве. Доступны следующие варианты:
All (по умолчанию) - будут скопированы все значения, форматы и формулы из диапазона.
Values - будут скопированы только значения. Формат ячеек и формулы будут проигнорированы - вместо формул подставится готовый результат.
Formulas - будут скопированы значения и формулы. Чтобы значение формул корректно отображалось при вставке, добавьте после копирования диапазона компонент Пересчет формул.
Formats - будет скопирован только формат ячеек, шрифт и цвета. Значения и формулы проигнорируются.
ВАЖНО! После копирования диапазона не забудьте использовать элемент Сохранить документ, чтобы внесенные изменения применились.
Описание общих свойств элемента см. в разделе Свойства элемента.
Символ *
в названии свойства указывает на обязательность заполнения.
Диапазон-источник* [String]: Укажите диапазон ячеек, которые нужно скопировать. Диапазон можно указать в точности: "A1:D12" либо использовать символ * вместо столбца или номера строки, например: "A1:*12" или "A1:D*".
Диапазон-приемник* [String]: Укажите диапазон ячеек для вставки данных. Например, A1:D12
или A1
.
Страница-источник [String]: Введите наименование страницы-источника данных.
Индекс страницы-источника [Int32]: Номер страницы-источника (отсчет с 0).
Страница-приемник [String]: Наименование страницы-приемника данных.
Индекс страницы-приемника [Int32]: Номер страницы-приемника (отсчет с 0).
Формат: Выберите, в каком формате нужно скопировать данные. Описание значений приведено выше.
Путь к документу [String]: Если данные нужно вставить во внешний файл Excel, укажите к нему путь. Если он не задан, диапазон будет вставлен внутри файла-источника.
Пример использования элемента в процессе с типом Только код (Pure code):
C#
Primo.Office.OdfOxml.ExcelApp app = Primo.Office.OdfOxml.ExcelApp.Init(wf, [file]);
app.CopyRange(range, rangeTo, [sheet], [sheetIdx], [sheetTo], [sheetIdxTo], [format], [file]);