Фигуры в диаграммах

Иногда вам нужно вставить в диаграмму объекты рисования, такие как метки, текстовые поля, изображения и т. д. Aspose.Cells может добавлять элементы управления на диаграмму во время выполнения.

Добавление элемента управления Label на диаграмму

Метки предоставляют средства для предоставления пользователям информации о содержимом электронной таблицы. Aspose.Cells позволяет добавлять метки и управлять ими даже в диаграммах.

Aspose.Cells.Drawing.ShapeCollection класс предоставляет метод с именемАддлейбелинчарт, используемый для добавления элемента управления меткой на диаграмму. Ниже приведен список параметров, используемых для метода:

• вершина – вертикальное смещение метки от левого верхнего угла в единицах 1/4000 площади графика.
• оставил – вертикальное смещение метки от левого верхнего угла в единицах 1/4000 площади графика.
• рост – высота метки, в единицах 1/4000 площади диаграммы.
• ширина – ширина метки, в единицах 1/4000 площади графика.

Метод возвращаетAspose.Cells.Drawing.Labelобъект.Этикетка класс представляет метку на диаграмме. В него входят несколько важных членов:

• Текст(свойство) – задает строку заголовка метки.
• Наполнять (свойство) – задает атрибуты цвета заливки.

В следующем примере показано, как добавить метку к диаграмме. В примере используется файл конструктора (exp_piechart.xls), в котором есть диаграмма. Мы используем этот файл, чтобы вставить метку в диаграмму. Ниже приведен исходный код для добавления метки к диаграмме. При выполнении кода генерируется следующий вывод.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Open the existing file.
Workbook workbook = new Workbook(dataDir + "chart.xls");

// Get the designer chart in the second sheet.
Worksheet sheet = workbook.Worksheets[1];
Aspose.Cells.Charts.Chart chart = sheet.Charts[0];

// Add a new label to the chart.
Aspose.Cells.Drawing.Label label = chart.Shapes.AddLabelInChart(100, 100, 350, 900);

// Set the caption of the label.
label.Text = "A Label In Chart";

// Set the Placement Type, the way the
// Label is attached to the cells.
label.Placement = Aspose.Cells.Drawing.PlacementType.FreeFloating;

// Save the excel file.
workbook.Save(dataDir + "chart.out.xls");

Добавление элемента управления TextBox на диаграмму

Один из способов выделить важную информацию в отчете — использовать текстовое поле. Например, введите текст, чтобы выделить название компании или указать географический регион с самыми высокими продажами.Aspose.Cells.Drawing.ShapeCollection класс предоставляет метод с именемАддтекстбоксинчарткоторый используется для добавления элемента управления текстовым полем на диаграмму. Ниже приведен список параметров, используемых для метода:

• вершина – вертикальное смещение текстового поля от верхнего левого угла в единицах 1/4000 площади графика.
• оставил – вертикальное смещение текстового поля от верхнего левого угла в единицах 1/4000 площади графика.
• рост– высота текстового поля, в единицах 1/4000 площади графика.
• ширина – ширина текстового поля, в единицах 1/4000 площади диаграммы.

Метод возвращаетAspose.Cells.Drawing.TextBox объект.Текстовое окнокласс представляет собой текстовое поле на диаграмме.

В следующем примере показано, как добавить текстовое поле на диаграмму. В примере используется предыдущий файл конструктора (exp_piechart.xls), в котором есть диаграмма. Мы используем этот файл, чтобы вставить текстовое поле в диаграмму, чтобы показать заголовок диаграммы. Ниже приведен исходный код для добавления текстового поля на диаграмму.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Open the existing file.
Workbook workbook = new Workbook(dataDir + "chart.xls");
 
// Get the designer chart in the second sheet.
Worksheet sheet = workbook.Worksheets[1];
Aspose.Cells.Charts.Chart chart = sheet.Charts[0];

// Add a new textbox to the chart.
Aspose.Cells.Drawing.TextBox textbox0 = chart.Shapes.AddTextBoxInChart(100, 1100, 350, 2550);

// Fill the text.
textbox0.Text = "Sales By Region";

// Get the textbox text frame.
// Aspose.Cells.Drawing.MsoTextFrame textframe0 = textbox0.TextFrame;

// Set the textbox to adjust it according to its contents.
// textframe0.AutoSize = true;

// Set the font color.
textbox0.Font.Color = Color.Maroon;

// Set the font to bold.
textbox0.Font.IsBold = true;

// Set the font size.
textbox0.Font.Size = 14;

// Set font attribute to italic.
textbox0.Font.IsItalic = true;

// Get the filformat of the textbox.
Aspose.Cells.Drawing.FillFormat fillformat = textbox0.Fill;

// Get the lineformat type of the textbox.
Aspose.Cells.Drawing.LineFormat lineformat = textbox0.Line;
     
// Set the line weight.
lineformat.Weight = 2;

// Set the dash style to solid.
lineformat.DashStyle = Aspose.Cells.Drawing.MsoLineDashStyle.Solid;

// Save the excel file.
workbook.Save(dataDir + "chart.out.xls");

Добавление изображения на диаграмму

Aspose.Cells позволяет вставлять изображения в диаграмму. Например, добавьте изображение, чтобы подчеркнуть или придать больше смысла диаграмме или ее содержимому, или вставьте файл изображения бренда.

Aspose.Cells.Drawing.ShapeCollection класс предоставляет метод с именемAddPictureInChart, который используется для добавления объекта изображения на диаграмму. Ниже приведен список параметров, используемых для метода:

• вершина– смещение картинки по вертикали от левого верхнего угла в единицах 1/4000 площади карты.
• оставил– смещение картинки по вертикали от левого верхнего угла в единицах 1/4000 площади карты.
• транслировать – объект потока, который содержит данные изображения.
• ширинаМасштаб – масштаб ширины изображения, процентное значение.
• масштаб высоты – масштаб высоты изображения, процентное значение.

Метод возвращаетAspose.Cells.Drawing.Picture объект.Рисуноккласс представляет объект изображения на диаграмме.

В следующем примере показано, как добавить изображение на диаграмму. В примере используется предыдущий файл конструктора (exp_piechart.xls), в котором есть диаграмма. Мы используем этот файл для вставки изображения в диаграмму. Ниже приведен исходный код для добавления изображения на график.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Open the existing file.
Workbook workbook = new Workbook(dataDir + "chart.xls");

// Get an image file to the stream.
FileStream stream = new FileStream(dataDir + "logo.jpg", FileMode.Open, FileAccess.Read);

// Get the designer chart in the second sheet.
Worksheet sheet = workbook.Worksheets[0];
Aspose.Cells.Charts.Chart chart = sheet.Charts[0];

// Add a new picture to the chart.
Aspose.Cells.Drawing.Picture pic0 = chart.Shapes.AddPictureInChart(50, 50, stream, 40, 40);

// Get the lineformat type of the picture.
Aspose.Cells.Drawing.LineFormat lineformat = pic0.Line;          

// Set the dash style.
lineformat.DashStyle = Aspose.Cells.Drawing.MsoLineDashStyle.Solid;

// Set the line weight.
lineformat.Weight = 4;    

// Save the excel file.
workbook.Save(dataDir + "chart.out.xls");

Добавление флажка в диаграмму

Aspose.Cells позволяет вставлять флажки в лист диаграммы с помощьюМсодравингтипе перечисление. В следующем примере показано добавление флажка на лист диаграммы.

На следующем изображении показан лист диаграммы с флажком в выходном файле.

выходной файлсгенерированный следующим фрагментом кода, прилагается для справки.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Adding a chart to the worksheet
int index = workbook.Worksheets.Add(SheetType.Chart);

Worksheet sheet = workbook.Worksheets[index];
sheet.Charts.AddFloatingChart(ChartType.Column, 0, 0, 1024, 960);
sheet.Charts[0].NSeries.Add("{1,2,3}", false);

// Add checkbox to the chart.
sheet.Charts[0].Shapes.AddShapeInChart(MsoDrawingType.CheckBox, PlacementType.Move, 400, 400, 1000, 600);
sheet.Charts[0].Shapes[0].Text = "CheckBox 1";

// Save the excel file.
workbook.Save(outputDir + "InsertCheckboxInChartSheet_out.xlsx");

Предварительные темы

• Добавить водяной знак WordArt на диаграмму