Controlli nei grafici

A volte è necessario inserire oggetti disegno come etichette, caselle di testo, immagini e così via in un grafico. Aspose.Cells può aggiungere i controlli a un grafico durante l’esecuzione.

Aggiunta del Controllo Etichetta al Grafico

Le etichette forniscono un modo per fornire informazioni agli utenti sul contenuto di un foglio di calcolo. Aspose.Cells consente di aggiungere e manipolare le etichette anche nei grafici.

La classe ShapeCollection fornisce un metodo chiamato addLabelInChart, usato per aggiungere un controllo etichetta a un grafico. Di seguito è riportato un elenco dei parametri utilizzati per il metodo:

• top – lo spostamento verticale dell’etichetta dall’angolo in alto a sinistra in unità dello 1/4000 dell’area del grafico.
• sinistra – lo spostamento verticale dell’etichetta dall’angolo in alto a sinistra in unità dello 1/4000 dell’area del grafico.
• altezza – l’altezza dell’etichetta, in unità dello 1/4000 dell’area del grafico.
• width – la larghezza dell’etichetta, in unità pari a 1/4000 dell’area del grafico.

Il metodo restituisce un oggetto della classe Label, in cui la classe Label rappresenta un’etichetta nel grafico. Ha alcuni membri importanti come dettagliato di seguito:

• La proprietà Text specifica una stringa di didascalia dell’etichetta.
• La proprietà Fill specifica gli attributi del colore di riempimento.

L’esempio seguente mostra come aggiungere un’etichetta al grafico. L’esempio utilizza un file del designer che contiene un grafico. Utilizziamo questo file per inserire un’etichetta nel grafico.

Di seguito è riportata un’istantanea del file del designer.

Il grafico del designer

Di seguito è riportato il codice originale per aggiungere un’etichetta al grafico. L’output seguente viene generato durante l’esecuzione del codice.

È stata aggiunta un’etichetta nel grafico

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

Aggiunta del controllo TextBox al grafico

Un modo per evidenziare informazioni importanti in un report è utilizzare una casella di testo. Ad esempio, inserire del testo per evidenziare il nome dell’azienda o per indicare la regione geografica con le vendite più alte. La classe ShapeCollection fornisce un metodo chiamato addTextBoxInChart, che viene utilizzato per aggiungere un controllo casella di testo a un grafico. Di seguito è riportato l’elenco dei parametri utilizzati per il metodo:

• top – lo spostamento verticale della casella di testo dall’angolo in alto a sinistra in unità di 1/4000 dell’area del grafico.
• left – lo spostamento verticale della casella di testo dall’angolo superiore sinistro in unità pari a 1/4000 dell’area del grafico.
• height – l’altezza della casella di testo, in unità di 1/4000 dell’area del grafico.
• width – la larghezza della casella di testo, in unità di 1/4000 dell’area del grafico.

Il metodo restituisce un oggetto della classe TextBox dove la classe TextBox rappresenta una casella di testo nel grafico.

Nell’esempio seguente viene mostrato come aggiungere una casella di testo a un grafico. L’esempio utilizza il file del designer precedente che contiene un grafico. Utilizziamo questo file per inserire una casella di testo nel grafico in modo da mostrare il titolo del grafico.

Di seguito è riportato il codice originale per aggiungere una casella di testo al grafico. Il seguente output viene generato durante l’esecuzione del codice.

È stata aggiunta una casella di testo nel grafico

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

Aggiunta di un’immagine al grafico

Aspose.Cells consente di inserire immagini in un grafico. Ad esempio, aggiungi un’immagine per enfatizzare o dare più significato a un grafico o ai suoi contenuti, o inserisci un file immagine del marchio.

La classe ShapeCollection fornisce un metodo chiamato addPictureInChart, che viene utilizzato per aggiungere un oggetto immagine al grafico. Di seguito è riportato l’elenco dei parametri utilizzati per il metodo:

• top – lo spostamento verticale dell’immagine dall’angolo in alto a sinistra in unità di 1/4000 dell’area del grafico.
• left – lo spostamento verticale dell’immagine dall’angolo in alto a sinistra in unità di 1/4000 dell’area del grafico.
• stream – un oggetto stream che contiene i dati dell’immagine.
• widthScale – la scala della larghezza dell’immagine, un valore percentuale.
• heightScale – la scala dell’altezza dell’immagine, un valore percentuale.

Il metodo restituisce un oggetto della classe Picture dove la classe Picture rappresenta un oggetto immagine nel grafico.

Nell’esempio seguente viene mostrato come aggiungere un’immagine al grafico. L’esempio utilizza il file del designer precedente che contiene un grafico. Utilizziamo questo file per inserire un’immagine nel grafico.

Di seguito è riportato il codice originale per aggiungere un’immagine al grafico. Il seguente output viene generato durante l’esecuzione del codice

È stata inserita un’immagine nel grafico

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

Aggiunta di una casella di controllo nel grafico

Aspose.Cells consente di inserire caselle di controllo in un foglio di grafico utilizzando l’enumerazione MsoDrawingType. L’esempio seguente dimostra come aggiungere una casella di controllo a un foglio di grafico.

L’immagine seguente mostra il foglio di lavoro del grafico con la casella di controllo nel file di output.

Il file di output generato dal seguente frammento di codice è allegato per il tuo riferimento.

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