Formen in Diagrammen
Hinzufügen von Beschriftungssteuerung zum Diagramm
Beschriftungen bieten eine Möglichkeit, Benutzern Informationen über den Inhalt eines Arbeitsblatts bereitzustellen. Aspose.Cells für Python via .NET ermöglicht das Hinzufügen und Bearbeiten von Beschriftungen even in Diagrammen.
Die Klasse aspose.cells.drawing.ShapeCollection stellt eine Methode namens add_label_in_chart zur Verfügung, die verwendet wird, um dem Diagramm eine Beschriftungssteuerung hinzuzufügen. Im Folgenden finden Sie eine Liste der Parameter, die für die Methode verwendet werden:
- top – der vertikale Versatz der Beschriftung von der oberen linken Ecke in Einheiten von 1/4000 des Diagrammbereichs.
- left – der horizontale Versatz der Beschriftung von der oberen linken Ecke in Einheiten von 1/4000 des Diagrammbereichs.
- height – die Höhe der Beschriftung, in Einheiten von 1/4000 des Diagrammbereichs.
- width – die Breite der Beschriftung, in Einheiten von 1/4000 des Diagrammbereichs.
Die Methode gibt ein aspose.cells.drawing.Label-Objekt zurück. Die Klasse Label stellt eine Beschriftung im Diagramm dar. Sie verfügt über einige wichtige Elemente:
- text (Eigenschaft) – gibt einen Beschriftungszeichenfolgenwert an.
- fill (Eigenschaft) – gibt die Farbfüllungseigenschaften an.
Im folgenden Beispiel wird gezeigt, wie eine Beschriftung dem Diagramm hinzugefügt wird. Das Beispiel verwendet eine Designerdatei (exp_piechart.xls), die ein Diagramm enthält. Wir verwenden diese Datei, um eine Beschriftung in das Diagramm einzufügen. Unten finden Sie den ursprünglichen Code zum Hinzufügen einer Beschriftung zum Diagramm. Die folgende Ausgabe wird beim Ausführen des Codes generiert.
| 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") |
Hinzufügen einer Textfeldsteuerung zum Diagramm
Eine Möglichkeit, wichtige Informationen in einem Bericht hervorzuheben, besteht darin, einen Textbereich zu verwenden. Geben Sie beispielsweise Text ein, um den Firmennamen hervorzuheben oder das geografische Gebiet mit den höchsten Verkäufen anzuzeigen. Die Klasse aspose.cells.drawing.ShapeCollection stellt eine Methode namens add_text_box_in_chart zur Verfügung, die verwendet wird, um dem Diagramm eine Textfeldsteuerung hinzuzufügen. Im Folgenden finden Sie die verwendete Parameterliste für die Methode:
- top – der vertikale Versatz des Textfelds von der oberen linken Ecke in Einheiten von 1/4000 des Diagrammbereichs.
- left – der horizontale Versatz des Textfelds von der oberen linken Ecke in Einheiten von 1/4000 des Diagrammbereichs.
- height – die Höhe des Textfelds, in Einheiten von 1/4000 des Diagrammbereichs.
- width – die Breite des Textfelds, in Einheiten von 1/4000 des Diagrammbereichs.
Die Methode gibt ein aspose.cells.drawing.TextBox-Objekt zurück. Die Klasse TextBox stellt ein Textfeld im Diagramm dar.
Im folgenden Beispiel wird gezeigt, wie ein Textfeld zu einem Diagramm hinzugefügt wird. Das Beispiel verwendet die vorherige Designerdatei (exp_piechart.xls), die ein Diagramm enthält. Wir verwenden diese Datei, um ein Textfeld in das Diagramm einzufügen, um den Diagrammtitel anzuzeigen. Unten finden Sie den ursprünglichen Code zum Hinzufügen eines Textfelds zum Diagramm.
| 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") |
Hinzufügen eines Bilds zum Diagramm
Aspose.Cells für Python via .NET ermöglicht das Einfügen von Bildern in ein Diagramm. Zum Beispiel ein Bild hinzufügen, um ein Diagramm oder dessen Inhalte zu betonen oder mehr Bedeutung zu verleihen oder eine Markenbilddatei einzufügen.
Die Klasse aspose.cells.drawing.ShapeCollection stellt eine Methode namens add_picture_in_chart zur Verfügung, die verwendet wird, um ein Bildobjekt dem Diagramm hinzuzufügen. Im Folgenden finden Sie die verwendete Parameterliste für die Methode:
- top – der vertikale Abstand des Bildes von der oberen linken Ecke in Einheiten von 1/4000 des Diagrammbereichs.
- left – der horizontale Abstand des Bildes von der oberen linken Ecke in Einheiten von 1/4000 des Diagrammbereichs.
- stream – ein Stream-Objekt, das die Bilddaten enthält.
- widthScale – die Skalierung der Bildbreite, ein Prozentsatz.
- heightScale – die Skalierung der Bildhöhe, ein Prozentsatz.
Die Methode gibt ein aspose.cells.drawing.Picture-Objekt zurück. Die Klasse Picture stellt ein Bildobjekt im Diagramm dar.
Das folgende Beispiel zeigt, wie Sie ein Bild zum Diagramm hinzufügen. Das Beispiel verwendet die vorige Designerdatei (exp_piechart.xls), die ein Diagramm enthält. Wir verwenden diese Datei, um ein Bild in das Diagramm einzufügen. Unten finden Sie den ursprünglichen Code zum Hinzufügen eines Bildes zum Diagramm.
| 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") |
Checkbox in das Diagramm einfügen
Aspose.Cells für Python via .NET ermöglicht das Einfügen von Kontrollkästchen in ein Diagrammblatt mittels MsoDrawingType-Aufzählung. Das folgende Beispiel zeigt, wie man ein Kontrollkästchen zu einem Diagrammblatt hinzufügt.
Das folgende Bild zeigt das Diagrammblatt mit der Checkbox in der Ausgabedatei.
Die Ausgabedatei, die durch den folgenden Code-Schnipsel generiert wurde, ist als Referenz angehängt.
| 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") |