Steuerelemente in Diagrammen
Hinzufügen von Beschriftungssteuerung zum Diagramm
Labels bieten eine Möglichkeit, Benutzern Informationen über den Inhalt eines Tabellenblatts zu geben. Aspose.Cells ermöglicht es Ihnen, Labels hinzuzufügen und zu manipulieren, sogar in Diagrammen.
Die Klasse ShapeCollection bietet eine Methode namens addLabelInChart, die verwendet wird, um eine Label-Steuerung zu einem Diagramm hinzuzufügen. Hier ist eine Liste der für die Methode verwendeten Parameter:
- 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 des Labels in Einheiten von 1/4000 des Diagrammbereichs.
Die Methode gibt ein Objekt der Klasse Label zurück, wobei die Klasse Label ein Label im Diagramm darstellt. Sie hat einige wichtige Elemente, wie nachstehend detailliert beschrieben:
- Die Eigenschaft Text gibt einen Beschriftungsstring an.
- Die Eigenschaft Fill gibt die Füllfarbeattribute an.
Das folgende Beispiel zeigt, wie ein Label zum Diagramm hinzugefügt wird. Das Beispiel verwendet eine Designerdatei, die ein Diagramm enthält. Wir verwenden diese Datei, um ein Label in das Diagramm einzufügen.
Hier ist ein Screenshot der Designerdatei.
Das Designer-Diagramm
Hier ist der ursprüngliche Code zum Hinzufügen eines Labels zum Diagramm. Der folgende Ausgang wird beim Ausführen des Codes generiert.
Ein Label wird im Diagramm hinzugefügt
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
// The path to the documents directory. | |
String dataDir = Utils.getSharedDataDir(AddingLabelControl.class) + "charts/"; | |
String filePath = dataDir + "chart.xls"; | |
Workbook workbook = new Workbook(filePath); | |
Worksheet worksheet = workbook.getWorksheets().get(0); | |
// Load the chart from source worksheet | |
Chart chart = worksheet.getCharts().get(0); | |
Label label = chart.getShapes().addLabelInChart(100, 100, 350, 900); | |
label.setText("Write Label here"); | |
label.setPlacement(PlacementType.FREE_FLOATING); | |
label.getFill().getSolidFill().setColor(Color.getChocolate()); | |
// Output the file | |
workbook.save(dataDir + "ALControl_out.xls"); | |
// Print message | |
System.out.println("Label added to chart successfully."); |
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 ShapeCollection stellt eine Methode namens addTextBoxInChart 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 Abstand der Textbox 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 Objekt der Klasse TextBox zurück, wobei die Klasse TextBox ein Textfeld im Diagramm darstellt.
Das folgende Beispiel zeigt, wie man ein Textfeld zu einem Diagramm hinzufügt. Das Beispiel verwendet die vorherige Designerdatei, 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 Originalcode, um ein Textfeld zum Diagramm hinzuzufügen. Die folgende Ausgabe wird beim Ausführen des Codes generiert.
Ein Textfeld wird im Diagramm hinzugefügt
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
// The path to the documents directory. | |
String dataDir = Utils.getSharedDataDir(AddingTextBoxControl.class) + "charts/"; | |
String filePath = dataDir + "chart.xls"; | |
// Create a new Workbook. | |
// Open the existing file. | |
Workbook workbook = new Workbook(filePath); | |
Worksheet worksheet = workbook.getWorksheets().get(0); | |
// Load the chart from source worksheet | |
Chart chart = worksheet.getCharts().get(0); | |
// Add a new textbox to the chart. | |
TextBox txt = chart.getShapes().addTextBoxInChart(100, 100, 850, 2500); | |
txt.setText("Aspose"); | |
txt.getFont().setItalic(true); | |
txt.getFont().setSize(20); | |
txt.getFont().setBold(true); | |
// Get the filformat of the textbox. | |
FillFormat fillformat = txt.getFill(); | |
fillformat.setFillType(FillType.SOLID); | |
fillformat.getSolidFill().setColor(Color.getSilver()); | |
// Get the lineformat type of the textbox. | |
LineFormat lineformat = txt.getLine(); | |
lineformat.setWeight(2); | |
lineformat.setDashStyle(MsoLineDashStyle.SOLID); | |
// Output the file | |
workbook.save(dataDir + "ATBoxControl_out.xls"); | |
// Print message | |
System.out.println("TextBox added to chart successfully."); |
Hinzufügen eines Bilds zum Diagramm
Mit Aspose.Cells können Sie Bilder in ein Diagramm einfügen. Fügen Sie beispielsweise ein Bild hinzu, um ein Diagramm oder seine Inhalte zu betonen oder mehr Bedeutung zu verleihen oder fügen Sie eine Markenbild-Datei ein.
Die Klasse ShapeCollection stellt eine Methode namens addPictureInChart 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 Objekt der Klasse Picture zurück, wobei die Klasse Picture ein Bildobjekt im Diagramm darstellt.
Das folgende Beispiel zeigt, wie man ein Bild zu einem Diagramm hinzufügt. Das Beispiel verwendet die vorherige Designerdatei, die ein Diagramm enthält. Wir verwenden diese Datei, um ein Bild in das Diagramm einzufügen.
Unten finden Sie den Originalcode, um ein Bild zum Diagramm hinzuzufügen. Die folgende Ausgabe wird beim Ausführen des Codes generiert.
Ein Bild wird in das Diagramm eingefügt
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
// The path to the documents directory. | |
String dataDir = Utils.getSharedDataDir(AddingPictureToChart.class) + "charts/"; | |
String filePath = dataDir + "chart.xls"; | |
FileInputStream stream = new FileInputStream(dataDir + "logo.jpg"); | |
Workbook workbook = new Workbook(filePath); | |
Worksheet worksheet = workbook.getWorksheets().get(0); | |
// Load the chart from source worksheet | |
Chart chart = worksheet.getCharts().get(0); | |
Picture pic = chart.getShapes().addPictureInChart(50, 50, stream, 40, 40); | |
LineFormat lineformat = pic.getLine(); | |
lineformat.setFillType(FillType.SOLID); | |
lineformat.getSolidFill().setColor(Color.getBlue()); | |
lineformat.setDashStyle(MsoLineDashStyle.DASH_DOT_DOT); | |
// Output the file | |
workbook.save(dataDir + "APToChart_out.xls"); | |
// Print message | |
System.out.println("Picture added to chart successfully."); |
Checkbox in das Diagramm einfügen
Aspose.Cells ermöglicht es Ihnen, Kontrollkästchen in ein Diagrammblatt einzufügen, indem Sie die MsoDrawingType-Aufzählung verwenden. 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 zur Ihrer Referenz angehängt.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
// directories | |
String outputDir = Utils.Get_OutputDirectory(); | |
// Instantiating a Workbook object | |
Workbook workbook = new Workbook(); | |
// Adding a chart to the worksheet | |
int index = workbook.getWorksheets().add(SheetType.CHART); | |
Worksheet sheet = workbook.getWorksheets().get(index); | |
sheet.getCharts().addFloatingChart(ChartType.COLUMN, 0, 0, 1024, 960); | |
sheet.getCharts().get(0).getNSeries().add("{1,2,3}", false); | |
// Add checkbox to the chart. | |
sheet.getCharts().get(0).getShapes().addShapeInChart(MsoDrawingType.CHECK_BOX, PlacementType.MOVE, 400, 400, 1000, 600); | |
sheet.getCharts().get(0).getShapes().get(0).setText("CheckBox 1"); | |
// Convert chart to image with additional settings | |
workbook.save(outputDir + "InsertCheckboxInChartSheet_out.xlsx"); |