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

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

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

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

Класс aspose.cells.drawing.ShapeCollection содержит метод с именем add_label_in_chart, используемый для добавления элемента управления меткой в график. Ниже приведен список параметров, используемых для этого метода:

top – вертикальное смещение метки от верхнего левого угла в единицах 1/4000 от области графика.
left – горизонтальное смещение метки от верхнего левого угла в единицах 1/4000 от области графика.
height – высота метки в единицах 1/4000 от области графика.
width – ширина метки в единицах 1/4000 от области графика.

Метод возвращает объект aspose.cells.drawing.Label. Класс Label представляет собой метку в графике. Он имеет несколько важных членов:

text (свойство) – указывает строку заголовка метки.
fill (свойство) – указывает атрибуты цвета заливки.

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

	from aspose.cells import Workbook
	from aspose.cells.drawing import PlacementType

	# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
	# The path to the documents directory.
	dataDir = RunExamples.GetDataDir(".")
	# Open the existing file.
	workbook = Workbook(dataDir + "chart.xls")
	# Get the designer chart in the second sheet.
	sheet = workbook.worksheets[1]
	chart = sheet.charts[0]
	# Add a new label to the chart.
	label = chart.shapes.add_label_in_chart(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 = PlacementType.FREE_FLOATING
	# Save the excel file.
	workbook.save(dataDir + "chart.out.xls")

view raw Charts-InsertingControlsintoCharts-AddingLabelControl-1.py hosted with ❤ by GitHub

Добавление элемента управления текстовым полем в график

Один из способов выделить важную информацию в отчете – использование текстового поля. Например, введите текст для выделения названия компании или для указания географического региона с наибольшими продажами. Класс aspose.cells.drawing.ShapeCollection предоставляет метод с именем add_text_box_in_chart, который используется для добавления элемента управления текстовым полем в график. Ниже приведен список параметров, используемых для метода:

top – вертикальное смещение текстового поля от верхнего левого угла в единицах 1/4000 от области графика.
left – горизонтальное смещение текстового поля от верхнего левого угла в единицах 1/4000 от области графика.
height – высота текстового поля в единицах 1/4000 от области графика.
ширина - ширина текстового блока в единицах 1/4000 от области диаграммы.

Метод возвращает объект aspose.cells.drawing.TextBox. Класс TextBox представляет собой текстовый блок на диаграмме.

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

	from aspose.cells import Workbook
	from aspose.cells.drawing import MsoLineDashStyle
	from aspose.pydrawing import Color

	# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
	# The path to the documents directory.
	dataDir = RunExamples.GetDataDir(".")
	# Open the existing file.
	workbook = Workbook(dataDir + "chart.xls")
	# Get the designer chart in the second sheet.
	sheet = workbook.worksheets[1]
	chart = sheet.charts[0]
	# Add a new textbox to the chart.
	textbox0 = chart.shapes.add_text_box_in_chart(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.is_bold = True
	# Set the font size.
	textbox0.font.size = 14
	# Set font attribute to italic.
	textbox0.font.is_italic = True
	# Get the filformat of the textbox.
	fillformat = textbox0.fill
	# Get the lineformat type of the textbox.
	lineformat = textbox0.line
	# Set the line weight.
	lineformat.weight = 2.0
	# Set the dash style to solid.
	lineformat.dash_style = MsoLineDashStyle.SOLID
	# Save the excel file.
	workbook.save(dataDir + "chart.out.xls")

view raw Charts-InsertingControlsintoCharts-AddingTextBoxControl-1.py hosted with ❤ by GitHub

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

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

Класс aspose.cells.drawing.ShapeCollection предоставляет метод с именем add_picture_in_chart, который используется для добавления объекта изображения на диаграмму. Ниже приведен список параметров, используемых для метода:

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

Метод возвращает объект aspose.cells.drawing.Picture. Класс Picture представляет собой объект изображения на диаграмме.

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

	from aspose.cells import Workbook
	from aspose.cells.drawing import MsoLineDashStyle

	# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
	# The path to the documents directory.
	dataDir = RunExamples.GetDataDir(".")
	# Open the existing file.
	workbook = Workbook(dataDir + "chart.xls")
	# Get an image file to the stream.
	stream = open(dataDir + "logo.jpg", "rb")
	# Get the designer chart in the second sheet.
	sheet = workbook.worksheets[0]
	chart = sheet.charts[0]
	# Add a new picture to the chart.
	pic0 = chart.shapes.add_picture_in_chart(50, 50, stream, 40, 40)
	# Get the lineformat type of the picture.
	lineformat = pic0.line
	# Set the dash style.
	lineformat.dash_style = MsoLineDashStyle.SOLID
	# Set the line weight.
	lineformat.weight = 4.0
	# Save the excel file.
	workbook.save(dataDir + "chart.out.xls")

view raw Charts-InsertingControlsintoCharts-AddingPictureToChart-1.py hosted with ❤ by GitHub

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

Aspose.Cells для Python via .NET позволяет вставлять флажки в лист диаграммы с помощью перечисления MsoDrawingType. Следующий пример демонстрирует добавление флажка на лист диаграммы.

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

todo:image_alt_text

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

	from aspose.cells import SheetType, Workbook
	from aspose.cells.charts import ChartType
	from aspose.cells.drawing import MsoDrawingType, PlacementType

	# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
	# Instantiating a Workbook object
	workbook = Workbook()
	# Adding a chart to the worksheet
	index = workbook.worksheets.add(SheetType.CHART)
	sheet = workbook.worksheets[index]
	sheet.charts.add_floating_chart(ChartType.COLUMN, 0, 0, 1024, 960)
	sheet.charts[0].n_series.add("{1,2,3}", False)
	# Add checkbox to the chart.
	sheet.charts[0].shapes.add_shape_in_chart(MsoDrawingType.CHECK_BOX, PlacementType.MOVE, 400, 400, 1000, 600)
	sheet.charts[0].shapes[0].text = "CheckBox 1"
	# Save the excel file.
	workbook.save(outputDir + "InsertCheckboxInChartSheet_out.xlsx")

view raw Charts-InsertingControlsintoCharts-InsertCheckboxInChartSheet-1.py hosted with ❤ by GitHub

Продвинутые темы

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

Управление осями диаграмм Excel Как создать диаграммы акций