Создание диаграмм с помощью VSTO и Aspose.Slides для .NET

Обзор

В этой статье показано, как программно создавать и настраивать диаграммы в презентациях Microsoft PowerPoint с помощью C#. С библиотекой Aspose.Slides для .NET вы можете автоматизировать генерацию профессиональных диаграмм, основанных на данных, без необходимости использовать Microsoft Office или библиотеки Interop. API предоставляет богатый набор возможностей для построения столбчатых, круговых, линейных диаграмм и других типов — с полным контролем над внешним видом, данными и макетом. Независимо от того, создаёте ли вы отчёты, информационные панели или деловые презентации, Aspose.Slides поможет вам получать высококачественные визуализации напрямую из ваших .NET‑приложений.

Пример VSTO

В этом разделе показано, как создать диаграмму в презентации Microsoft PowerPoint с помощью VSTO (Visual Studio Tools for Office). С помощью VSTO можно программно генерировать и настраивать диаграммы, комбинируя автоматизацию PowerPoint и Excel. Пример демонстрирует добавление 3D сгруппированной столбчатой диаграммы, заполнение её данными из листа Excel, настройку форматирования и макета, а также сохранение готовой презентации — всё из .NET‑приложения.

  1. Создать экземпляр презентации Microsoft PowerPoint.
  2. Добавить пустой слайд в презентацию.
  3. Добавить 3D сгруппированную столбчатую диаграмму и получить к ней доступ.
  4. Создать новый экземпляр рабочей книги Microsoft Excel и загрузить данные для диаграммы.
  5. Получить доступ к листу данных диаграммы, используя экземпляр рабочей книги Excel.
  6. Установить диапазон диаграммы на листе и удалить серии 2 и 3 из диаграммы.
  7. Изменить данные категорий диаграммы на листе данных.
  8. Изменить данные серии 1 на листе данных диаграммы.
  9. Получить доступ к заголовку диаграммы и задать свойства шрифта.
  10. Получить доступ к оси значений диаграммы и задать основной шаг, младший шаг, максимальное и минимальное значения.
  11. Получить доступ к оси глубины (серий) диаграммы и удалить её — в примере используется только одна серия.
  12. Задать углы вращения диаграммы по осям X и Y.
  13. Сохранить презентацию.
  14. Закрыть экземпляры Microsoft Excel и PowerPoint.
EnsurePowerPointIsRunning(true, true);

// Создать объект слайда.
Microsoft.Office.Interop.PowerPoint.Slide objSlide = null;

// Получить первый слайд презентации.
objSlide = objPres.Slides[1];

// Выбрать первый слайд и установить его макет.
objSlide.Select();
objSlide.Layout = Microsoft.Office.Interop.PowerPoint.PpSlideLayout.ppLayoutBlank;

// Добавить диаграмму по умолчанию на слайд.
objSlide.Shapes.AddChart(Microsoft.Office.Core.XlChartType.xl3DColumn, 20, 30, 400, 300);

// Получить добавленную диаграмму.
Microsoft.Office.Interop.PowerPoint.Chart ppChart = objSlide.Shapes[1].Chart;

// Получить данные диаграммы.
Microsoft.Office.Interop.PowerPoint.ChartData chartData = ppChart.ChartData;

// Создать экземпляр рабочей книги Excel для работы с данными диаграммы.
Microsoft.Office.Interop.Excel.Workbook dataWorkbook = (Microsoft.Office.Interop.Excel.Workbook)chartData.Workbook;

// Получить лист данных для диаграммы.
Microsoft.Office.Interop.Excel.Worksheet dataSheet = dataWorkbook.Worksheets[1];

// Установить диапазон данных для диаграммы.
Microsoft.Office.Interop.Excel.Range tRange = dataSheet.Cells.get_Range("A1", "B5");

// Применить указанный диапазон к таблице данных диаграммы.
Microsoft.Office.Interop.Excel.ListObject tbl1 = dataSheet.ListObjects["Table1"];
tbl1.Resize(tRange);

// Установить значения для категорий и соответствующих данных серий.
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("A2"))).FormulaR1C1 = "Bikes";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("A3"))).FormulaR1C1 = "Accessories";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("A4"))).FormulaR1C1 = "Repairs";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("A5"))).FormulaR1C1 = "Clothing";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("B2"))).FormulaR1C1 = "1000";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("B3"))).FormulaR1C1 = "2500";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("B4"))).FormulaR1C1 = "4000";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("B5"))).FormulaR1C1 = "3000";

// Установить заголовок диаграммы.
ppChart.ChartTitle.Font.Italic = true;
ppChart.ChartTitle.Text = "2007 Sales";
ppChart.ChartTitle.Font.Size = 18;
ppChart.ChartTitle.Font.Color = Color.Black.ToArgb();
ppChart.ChartTitle.Format.Line.Visible = Microsoft.Office.Core.MsoTriState.msoTrue;
ppChart.ChartTitle.Format.Line.ForeColor.RGB = Color.Black.ToArgb();

// Получить ось значений диаграммы.
Microsoft.Office.Interop.PowerPoint.Axis valaxis = ppChart.Axes(Microsoft.Office.Interop.PowerPoint.XlAxisType.xlValue, Microsoft.Office.Interop.PowerPoint.XlAxisGroup.xlPrimary);

// Установить значения единиц оси.
valaxis.MajorUnit = 2000.0F;
valaxis.MinorUnit = 1000.0F;
valaxis.MinimumScale = 0.0F;
valaxis.MaximumScale = 4000.0F;

// Получить ось глубины диаграммы.
Microsoft.Office.Interop.PowerPoint.Axis Depthaxis = ppChart.Axes(Microsoft.Office.Interop.PowerPoint.XlAxisType.xlSeriesAxis, Microsoft.Office.Interop.PowerPoint.XlAxisGroup.xlPrimary);
Depthaxis.Delete();

// Установить вращение диаграммы.
ppChart.Rotation = 20;   // Значение Y
ppChart.Elevation = 15;  // Значение X
ppChart.RightAngleAxes = false;

// Сохранить презентацию в формате PPTX.
objPres.SaveAs("VSTO_Sample_Chart.pptx", Microsoft.Office.Interop.PowerPoint.PpSaveAsFileType.ppSaveAsDefault, MsoTriState.msoTrue);

// Закрыть рабочую книгу и презентацию.
dataWorkbook.Application.Quit();
objPres.Application.Quit();

public static void EnsurePowerPointIsRunning(bool blnAddPresentation)
{
    EnsurePowerPointIsRunning(blnAddPresentation, false);
}

public static void EnsurePowerPointIsRunning()
{
    EnsurePowerPointIsRunning(false, false);
}

public static void EnsurePowerPointIsRunning(bool blnAddPresentation, bool blnAddSlide)
{
    string strName = null;

    // Попробовать получить свойство Name. Если возникает исключение, запустить новый экземпляр PowerPoint.
    try
    {
        strName = objPPT.Name;
    }
    catch (Exception ex)
    {
        StartPowerPoint();
    }

    // blnAddPresentation используется, чтобы убедиться, что презентация загружена.
    if (blnAddPresentation == true)
    {
        try
        {
            strName = objPres.Name;
        }
        catch (Exception ex)
        {
            objPres = objPPT.Presentations.Add(MsoTriState.msoTrue);
        }
    }

    // blnAddSlide используется, чтобы убедиться, что в презентации есть хотя бы один слайд.
    if (blnAddSlide)
    {
        try
        {
            strName = objPres.Slides[1].Name;
        }
        catch (Exception ex)
        {
            Microsoft.Office.Interop.PowerPoint.Slide objSlide = null;
            Microsoft.Office.Interop.PowerPoint.CustomLayout objCustomLayout = null;
            objCustomLayout = objPres.SlideMaster.CustomLayouts[1];
            objSlide = objPres.Slides.AddSlide(1, objCustomLayout);
            objSlide.Layout = Microsoft.Office.Interop.PowerPoint.PpSlideLayout.ppLayoutText;
            objCustomLayout = null;
            objSlide = null;
        }
    }
}

Результат:

Диаграмма, созданная с помощью VSTO

Пример Aspose.Slides for .NET

Следующий пример показывает, как создать простую диаграмму в презентации PowerPoint с помощью Aspose.Slides for .NET. Код демонстрирует добавление 3D сгруппированной столбчатой диаграммы, заполнение её образцовыми данными и настройку внешнего вида. Всего несколькими строками кода вы можете динамически генерировать диаграммы и интегрировать их в презентации без использования Microsoft Office.

  1. Создать экземпляр класса Presentation.
  2. Получить ссылку на первый слайд.
  3. Добавить 3D сгруппированную столбчатую диаграмму и получить к ней доступ.
  4. Получить доступ к данным диаграммы.
  5. Удалить неиспользуемые Series 2 и Series 3.
  6. Изменить категории диаграммы, обновив подписи.
  7. Обновить значения Series 1.
  8. Получить доступ к заголовку диаграммы и задать свойства шрифта.
  9. Настроить ось значений диаграммы: основной шаг, младший шаг, максимальное и минимальное значения.
  10. Задать углы вращения диаграммы по осям X и Y.
  11. Сохранить презентацию в формате PPTX.
// Создать пустую презентацию.
using (Presentation presentation = new Presentation())
{
    // Доступ к первому слайду.
    ISlide slide = presentation.Slides[0];

    // Добавить диаграмму по умолчанию.
    IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn3D, 20, 30, 400, 300);

    // Получить данные диаграммы.
    IChartData chartData = chart.ChartData;

    // Удалить лишние стандартные серии.
    chartData.Series.RemoveAt(1);
    chartData.Series.RemoveAt(1);

    // Изменить названия категорий диаграммы.
    chartData.Categories[0].AsCell.Value = "Bikes";
    chartData.Categories[1].AsCell.Value = "Accessories";
    chartData.Categories[2].AsCell.Value = "Repairs";
    chartData.Categories[3].AsCell.Value = "Clothing";

    // Установить индекс листа данных диаграммы.
    int worksheetIndex = 0;

    // Получить книгу данных диаграммы.
    IChartDataWorkbook workbook = chart.ChartData.ChartDataWorkbook;

    // Изменить значения рядов диаграммы.
    chartData.Series[0].DataPoints.AddDataPointForBarSeries(workbook.GetCell(worksheetIndex, 1, 1, 1000));
    chartData.Series[0].DataPoints.AddDataPointForBarSeries(workbook.GetCell(worksheetIndex, 2, 1, 2500));
    chartData.Series[0].DataPoints.AddDataPointForBarSeries(workbook.GetCell(worksheetIndex, 3, 1, 4000));
    chartData.Series[0].DataPoints.AddDataPointForBarSeries(workbook.GetCell(worksheetIndex, 4, 1, 3000));

    // Установить заголовок диаграммы.
    chart.HasTitle = true;
    chart.ChartTitle.AddTextFrameForOverriding("2007 Sales");
    IPortionFormat format = chart.ChartTitle.TextFrameForOverriding.Paragraphs[0].Portions[0].PortionFormat;
    format.FontItalic = NullableBool.True;
    format.FontHeight = 18;
    format.FillFormat.FillType = FillType.Solid;
    format.FillFormat.SolidFillColor.Color = Color.Black;

    // Установить параметры осей.
    chart.Axes.VerticalAxis.IsAutomaticMaxValue = false;
    chart.Axes.VerticalAxis.IsAutomaticMinValue = false;
    chart.Axes.VerticalAxis.IsAutomaticMajorUnit = false;
    chart.Axes.VerticalAxis.IsAutomaticMinorUnit = false;

    chart.Axes.VerticalAxis.MaxValue = 4000.0F;
    chart.Axes.VerticalAxis.MinValue = 0.0F;
    chart.Axes.VerticalAxis.MajorUnit = 2000.0F;
    chart.Axes.VerticalAxis.MinorUnit = 1000.0F;
    chart.Axes.VerticalAxis.TickLabelPosition = TickLabelPositionType.NextTo;

    // Установить вращение диаграммы.
    chart.Rotation3D.RotationX = 15;
    chart.Rotation3D.RotationY = 20;

    // Сохранить презентацию в файл PPTX.
    presentation.Save("Aspose_Sample_Chart.pptx", SaveFormat.Pptx);
}

Результат:

Диаграмма, созданная с помощью Aspose.Slides for .NET

Часто задаваемые вопросы

Могу ли я создавать другие типы диаграмм, такие как круговые, линейные или столбчатые, с помощью Aspose.Slides?

Да. Aspose.Slides for .NET поддерживает широкий спектр типы диаграмм, включая круговые, линейные, столбчатые, точечные, пузырьковые диаграммы и другие. При добавлении диаграммы вы можете указать нужный тип с помощью перечисления ChartType.

Могу ли я применять пользовательские стили или темы к диаграмме?

Да. Вы можете полностью настраивать внешний вид диаграммы, включая цвета, шрифты, заливки, контуры, линии сетки и макет. Однако точное применение тем Office, как в PowerPoint, требует ручной настройки отдельных стилей.

Можно ли экспортировать диаграмму как отдельное изображение, не привязанное к слайду?

Да, Aspose.Slides позволяет экспортировать любую форму — в том числе диаграммы — в отдельное изображение (например, PNG, JPEG) с помощью метода GetImage у shape.

Создание и встраивание диаграмм Excel в виде OLE‑объектов с VSTO и Aspose.Slides для .NET