Вставить простую столбчатую диаграмму в документ Word

В этом руководстве объясняется, как использовать Aspose.Words для .NET для вставки простой гистограммы в документ. Предоставленный исходный код демонстрирует, как создать диаграмму, добавить данные серии и сохранить документ.

Шаг 1. Настройте проект

Убедитесь, что у вас есть следующие предварительные условия:

Установлена библиотека Aspose.Words для .NET. Вы можете загрузить его, используя для установки диспетчер пакетов NuGet.
Путь к каталогу документов, в котором будет сохранен выходной документ.

Шаг 2. Создайте новый документ и вставьте диаграмму.

Создать новыйDocument объект иDocumentBuilder для построения документа.

// Путь к каталогу ваших документов
string dataDir = "YOUR DOCUMENT DIRECTORY";

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Далее используйтеInsertChart методDocumentBuilder чтобы вставить гистограмму в документ. Вы можете указать различные типы и размеры диаграмм в соответствии с вашими требованиями.

Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
Chart chart = shape.Chart;

Шаг 3. Добавьте данные серии на диаграмму

Добавьте данные серии на диаграмму. В этом примере мы добавим несколько серий по две категории в каждой.

ChartSeriesCollection seriesColl = chart.Series;
seriesColl.Clear();

string[] categories = new string[] { "Category 1", "Category 2" };

seriesColl.Add("Aspose Series 1", categories, new double[] { 1, 2 });
seriesColl.Add("Aspose Series 2", categories, new double[] { 3, 4 });
seriesColl.Add("Aspose Series 3", categories, new double[] { 5, 6 });
seriesColl.Add("Aspose Series 4", categories, new double[] { 7, 8 });
seriesColl.Add("Aspose Series 5", categories, new double[] { 9, 10 });

Шаг 4. Сохраните документ.

Наконец, сохраните документ в указанном каталоге, используя командуSave методDocument объект.

doc.Save(dataDir + "WorkingWithCharts.InsertSimpleColumnChart.docx");

На этом реализация вставки простой гистограммы с использованием Aspose.Words для .NET завершена.

Пример исходного кода для вставки простой столбчатой диаграммы с использованием Aspose.Words для .NET

	// Путь к каталогу ваших документов
	string dataDir = "YOUR DOCUMENT DIRECTORY";

	Document doc = new Document();
	DocumentBuilder builder = new DocumentBuilder(doc);
	// Вы можете указать различные типы и размеры диаграмм.
	Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
	Chart chart = shape.Chart;
	ChartSeriesCollection seriesColl = chart.Series;
	Console.WriteLine(seriesColl.Count);
	// Удалить созданную по умолчанию серию.
	seriesColl.Clear();
	// Создайте массив имен категорий. В этом уроке у нас есть две категории.
	string[] categories = new string[] { "Category 1", "Category 2" };
	// Обратите внимание: массивы данных не должны быть пустыми и массивы должны быть одинакового размера.
	seriesColl.Add("Aspose Series 1", categories, new double[] { 1, 2 });
	seriesColl.Add("Aspose Series 2", categories, new double[] { 3, 4 });
	seriesColl.Add("Aspose Series 3", categories, new double[] { 5, 6 });
	seriesColl.Add("Aspose Series 4", categories, new double[] { 7, 8 });
	seriesColl.Add("Aspose Series 5", categories, new double[] { 9, 10 });
	doc.Save(dataDir + "WorkingWithCharts.InsertSimpleColumnChart.docx");

Заключение

В этом уроке вы узнали, как вставить простую гистограмму в документ Word с помощью Aspose.Words для .NET. Следуя пошаговому руководству и используя предоставленный исходный код, вы можете создать новый документ, вставить столбчатую диаграмму, добавить несколько рядов с категориями и соответствующими значениями и сохранить документ вместе с диаграммой.

Aspose.Words for .NET предоставляет мощный и гибкий API для обработки слов с диаграммами в документах Word. Простая столбчатая диаграмма — это эффективный способ представления и сравнения данных в разных категориях. С помощью Aspose.Words for .NET вы можете легко создавать столбчатые диаграммы с пользовательскими данными, добавлять несколько рядов для визуального сравнения и настраивать внешний вид диаграммы в соответствии с вашими требованиями.

Используя Aspose.Words для .NET, вы можете автоматизировать процесс создания документов с помощью гистограмм, экономя время и усилия при создании документов вручную. Библиотека предлагает широкий спектр типов диаграмм, включая простые столбчатые диаграммы, а также различные параметры настройки, позволяющие адаптировать внешний вид диаграммы в соответствии с вашими потребностями.

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

Вопрос 1. Что такое столбчатая диаграмма?

Столбчатая диаграмма — это тип диаграммы, в которой данные отображаются с помощью вертикальных полос разной высоты. Каждый столбец представляет категорию, а высота столбца соответствует значению этой категории. Столбчатые диаграммы обычно используются для сравнения данных по разным категориям или для отслеживания изменений с течением времени.

В2. Могу ли я добавить несколько рядов в гистограмму?

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

Вопрос 3. Могу ли я настроить внешний вид гистограммы?

Да, Aspose.Words for .NET позволяет вам настраивать различные аспекты внешнего вида гистограммы. Вы можете изменить такие свойства, как цвет ряда, метки осей, метки данных и форматирование области диаграммы. Библиотека предоставляет богатый набор API-интерфейсов для управления визуальными элементами диаграммы и создания индивидуального внешнего вида, соответствующего вашим потребностям.

Вопрос 4. Могу ли я сохранить документ со вставленной гистограммой в разных форматах?

Да, Aspose.Words for .NET позволяет сохранять документ со вставленной гистограммой в различных форматах, таких как DOCX, PDF, HTML и других. Вы можете выбрать желаемый формат вывода в соответствии с вашими требованиями и использоватьSave методDocument объект для сохранения документа. Вставленная гистограмма сохранится в сохраненном документе.

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

Да, после вставки гистограммы в документ вы можете изменить ее данные и внешний вид с помощью API, предоставляемых Aspose.Words для .NET. Вы можете обновить данные серии, добавив новые категории и значения, изменить цвета и форматирование столбцов, настроить свойства осей и применить различные параметры форматирования для создания динамических и визуально привлекательных диаграмм в документах Word.