Копирование диапазона
Copy range
Last updated
Copy range
Last updated
Элемент копирует диапазон ячеек и вставляет его в другой лист Excel. Путь до файла-источника указывается в контейнере Приложение Excel.
Существует возможность вставить скопированный диапазон как в файл-источник, так и во внешний файл Excel. Выбор файла назначения определяется настройками, указанными в свойствах элемента.
Обязательные для заполнения свойства отмечены символом *. Описание общих свойств см. в разделе Свойства элемента.
Диапазон-источник* [String] — диапазон ячеек, которые следует скопировать. Диапазон можно указать в точности либо использовать символ подстановки * вместо столбца или номера строки. Например: "A1:*12" или "A1:D*".
Диапазон-приемник* [String] — диапазон ячеек для вставки данных. Можно указать диапазон полностью либо только стартовую ячейку. Пример: "A1".
Страница-источник [String] — название страницы-источника данных. Если указан индекс страницы, название можно не заполнять. Пример: "Лист1".
Индекс страницы-источника [Int32] — номер страницы-источника. Нумерация начинается с нуля. Если указано название страницы, индекс можно не заполнять. Пример: 0.
Страница-приемник [String] — название страницы-приемника данных. Пример: "Лист2".
Индекс страницы-приемника [Int32] — номер страницы-приемника. Нумерация начинается с нуля. Пример: 1.
Формат — формат, в котором следует скопировать данные. Возможные значения:
All — скопируются все значения, форматы и формулы из диапазона. Значение по умолчанию.
Values — скопируются только значения. Формат ячеек и формулы будут проигнорированы — вместо формул подставится готовый результат.
Formulas — скопируются значения и формулы. Чтобы значение формул корректно отображалось при вставке, добавьте после копирования диапазона компонент Пересчет формул.
Formats — скопируются только формат ячеек, шрифт и цвета. Значения и формулы проигнорируются.
Путь к документу [String] — путь к внешнему файлу Excel, в который следует вставить данные. Логика работы:
если путь указан — робот обновит внешний файл Excel и автоматически сохранит его состояние. При этом состояние файла-источника, открытого в текущем контейнере Приложение Excel, не изменится. Помните, что внешний файл и указанная страница-приемник должны существовать заранее.
если путь не указан — робот вставит скопированный диапазон в файл-источник, открытый в текущем контейнере Приложение Excel. Для того чтобы сохранить изменения в файле-источнике, воспользуйтесь элементом Сохранить документ.
Пример использования элемента в процессе с типом Только код (Pure code):
