Вставка диаграммы
Элемент создает диаграмму на листе 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 .
- Скачайте архив со всеми обучающими материалами по ссылке: Скачать архив Learning .
- Распакуйте архив и откройте в Студии проект WorkWithExcelExample.
- Элемент Вставка диаграммы находится в процессе
Main.ltw. Описание процесса можно найти в файлах проекта.
Только код
Пример использования элемента в процессе с типом Только код (Pure code):
C#
//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");