Contrôles dans les graphiques

Parfois, vous devez insérer des objets de dessin tels que des étiquettes, des zones de texte, des images, etc. dans un graphique. Aspose.Cells peut ajouter les contrôles à un graphique lors de l’exécution.

Ajout d’un contrôle d’étiquette au graphique

Les libellés permettent de fournir des informations aux utilisateurs sur le contenu d’une feuille de calcul. Aspose.Cells vous permet d’ajouter et de manipuler des étiquettes même dans les graphiques.

LeShapeCollection classe fournit une méthode nomméeaddLabelInChart, utilisé pour ajouter un contrôle d’étiquette à un graphique. Voici une liste des paramètres utilisés pour la méthode :

• Haut – le décalage vertical de l’étiquette à partir du coin supérieur gauche en unités de 1/4000 de la zone du graphique.
• gauche – le décalage vertical de l’étiquette à partir du coin supérieur gauche en unités de 1/4000 de la zone du graphique.
• la taille – la hauteur de l’étiquette, en unités de 1/4000 de la surface du graphique.
• largeur – la largeur de l’étiquette, en unités de 1/4000 de la surface du graphique.

La méthode renvoie un objet de laÉtiquette classe, où leÉtiquetteclass représente une étiquette dans le graphique. Il a quelques membres importants comme détaillé ci-dessous:

• TexteLa propriété spécifie la chaîne de légende d’une étiquette.
• Remplir La propriété spécifie les attributs de couleur de remplissage.

L’exemple suivant montre comment ajouter une étiquette au graphique. L’exemple utilise un fichier de concepteur contenant un graphique. Nous utilisons ce fichier pour insérer une étiquette dans le graphique.

Vous trouverez ci-dessous une capture d’écran du fichier de concepteur.

La charte du créateur

Vous trouverez ci-dessous le code d’origine pour ajouter une étiquette au graphique. La sortie suivante est générée lors de l’exécution du code.

Une étiquette est ajoutée dans le graphique

// 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.");

Ajout du contrôle TextBox au graphique

Une façon de mettre en évidence des informations importantes dans un rapport consiste à utiliser une zone de texte. Par exemple, saisissez du texte pour mettre en surbrillance le nom de l’entreprise ou pour indiquer la région géographique avec les ventes les plus élevées. LeShapeCollection classe fournit une méthode nomméeaddTextBoxInChart, qui est utilisé pour ajouter un contrôle de zone de texte à un graphique. Voici la liste des paramètres utilisés pour la méthode :

• Haut – le décalage vertical de la zone de texte à partir du coin supérieur gauche en unités de 1/4000 de la zone du graphique.
• gauche – le décalage vertical de la zone de texte à partir du coin supérieur gauche en unités de 1/4000 de la zone du graphique.
• la taille– la hauteur de la zone de texte, en unités de 1/4000 de la zone du graphique.
• largeur – la largeur de la zone de texte, en unités de 1/4000 de la zone du graphique.

La méthode renvoie un objet de laZone de texte classe où leZone de textela classe représente une zone de texte dans le graphique.

L’exemple suivant montre comment ajouter une zone de texte à un graphique. L’exemple utilise le fichier de concepteur précédent qui contient un graphique. Nous utilisons ce fichier pour insérer une zone de texte dans le graphique afin d’afficher le titre du graphique.

Vous trouverez ci-dessous le code d’origine pour ajouter une zone de texte au graphique. La sortie suivante est générée lors de l’exécution du code.

Une zone de texte est ajoutée dans le graphique

// 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.");

Ajouter une image au graphique

Aspose.Cells vous permet d’insérer des images dans un graphique. Par exemple, ajoutez une image pour souligner ou donner plus de sens à un graphique ou à son contenu, ou insérez un fichier d’image de marque.

LeShapeCollection classe fournit une méthode nomméeaddPictureInChart, qui est utilisé pour ajouter un objet image au graphique. Voici la liste des paramètres utilisés pour la méthode :

• Haut– le décalage vertical de l’image par rapport au coin supérieur gauche en unités de 1/4000 de la zone de carte.
• gauche– le décalage vertical de l’image par rapport au coin supérieur gauche en unités de 1/4000 de la zone de carte.
• flux – un objet flux qui contient les données d’image.
• Échellelargeur – l’échelle de la largeur de l’image, une valeur en pourcentage.
• Échelle de hauteur – l’échelle de la hauteur de l’image, une valeur en pourcentage.

La méthode renvoie un objet de laPhoto classe où lePhotoLa classe représente un objet image dans le graphique.

L’exemple suivant montre comment ajouter une image au graphique. L’exemple utilise le fichier de concepteur précédent qui contient un graphique. Nous utilisons ce fichier pour insérer une image dans le graphique.

Vous trouverez ci-dessous le code d’origine pour ajouter une image au graphique. La sortie suivante est générée lors de l’exécution du code

Une image est insérée dans le graphique

// 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.");

Ajouter une case à cocher dans le graphique

Aspose.Cells vous permet d’insérer des cases à cocher dans une feuille de graphique en utilisantMsoDrawingTypeMsoDrawingType énumération. L’exemple suivant illustre l’ajout d’une case à cocher à une feuille de graphique.

L’image suivante montre la feuille de graphique avec la case à cocher dans le fichier de sortie.

Lefichier de sortiegénéré par l’extrait de code suivant est joint pour votre référence.

// 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");