Вставка диаграммы

Insert chart

Элемент создает диаграмму на листе Excel. Путь до файла и другие базовые параметры настраиваются в контейнере Приложение Excel.

Дополнительно используйте элемент Сохранить документ, иначе изменения в файле не сохранятся.

Свойства

Символ * в названии свойства указывает на обязательность заполнения. Описание общих свойств см. в разделе Свойства элемента.

СвойствоТипОписаниеПример

Excel:

Диапазон

String

Диапазон данных. Если не указан, будет использован выделенный диапазон. Если указан символ "*", будет использован весь лист

"A1:D12"

Страница

String

Название страницы в книге Excel

"List1"

Индекс страницы

Int32

Порядковый номер страницы. Нумерация начинается с нуля. Если указано название страницы, номер можно пропустить

0

Высота

Int32

Высота диаграммы

800

Ширина

Int32

Ширина диаграммы

800

Сверху

Int32

Отступ сверху

0

Слева

Int32

Отступ слева

100

Тип

-

Тип диаграммы. Возможные значения:

1. Area — диаграмма с областями. Тип диаграммы по умолчанию.

2. Bar — линейчатая диаграмма.

3. Column — гистограмма.

4. Doughnut — кольцевая диаграмма.

5. Line Chart — линейный график.

6. Pie — круговая диаграмма.

7. XY scatter — точечная диаграмма.

Area

Вывод:

Переменная*

LTools.Offile.Model.Excel.ExcelChartItem

Переменная, в которой будет храниться ссылка на диаграмму

Подробнее о видах диаграмм читайте здесь:

Пример заполненных свойств приведен на рисунке ниже.

Пример использования

RPA-проект, демонстрирующий работу элемента, можно найти в нашем публичном репозитории Learning.

  1. Скачайте архив со всеми обучающими материалами по ссылке: Скачать архив Learning.

  2. Распакуйте архив и откройте в Студии проект WorkWithExcelExample.

  3. Элемент Вставка диаграммы находится в процессе Main.ltw. Описание процесса можно найти в файлах проекта.

Только код

Пример использования элемента в процессе с типом Только код (Pure code):

//app - [LTools.Office.ExcelApp] Приложение Excel
//range - Диапазон: [String] Диапазон данных (A1:D12). Если не указан, будет использован выделенный диапазон.  Если указан символ "*", будет использован весь лист
//sheet - Страница: [String] Наименование страницы
//sheetIdx - Индекс страницы: [Int32] Индекс страницы
//cht - Тип: Тип диаграммы
//cLeft - Слева: [Int32] Отступ слева
//cTop - Сверху: [Int32] Отступ сверху
//cWidth - Ширина: [Int32] Ширина диаграммы
//cHeight - Высота: [Int32] Высота диаграммы
//LTools.Office.Model.Excel.ExcelChartItem data = app.InsertChart(range, cht, [sheet], [sheetIdx], [cLeft], [cTop], [cWidth], [cHeight]);

LTools.Office.ExcelApp app = LTools.Office.ExcelApp.Init(wf, ".\\book.xlsx", ";", LTools.Office.Model.InteropTypes.DX);
LTools.Office.Model.Excel.ExcelChartItem data = app.InsertChart("*", LTools.Office.Model.Excel.ChartTypes.Line, "Лист1", 0, 10, 10, 800, 800);
app.SaveAs(".\\bookdiagram.xlsx");