Forme nei grafici

A volte è necessario inserire oggetti di disegno come etichette, caselle di testo, immagini e così via in un grafico. Aspose.Cells per Python via .NET può aggiungere i controlli al grafico a runtime.

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 per Python via .NET consente di aggiungere e manipolare etichette anche nei grafici.

La classe aspose.cells.drawing.ShapeCollection fornisce un metodo chiamato add_label_in_chart, utilizzato 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.
• larghezza – la larghezza dell’etichetta, in unità dello 1/4000 dell’area del grafico.

Il metodo restituisce l’oggetto aspose.cells.drawing.Label. La classe Label rappresenta un’etichetta nel grafico. Ha alcuni membri importanti:

• text (proprietà) – specifica una stringa di sottotitolo dell’etichetta.
• fill (proprietà) – specifica gli attributi del colore di riempimento.

L’esempio seguente mostra come aggiungere un’etichetta al grafico. L’esempio utilizza un file di progettazione (exp_piechart.xls) che ha un grafico al suo interno. Usiamo questo file per inserire un’etichetta nel grafico. Di seguito è riportato il codice originale per aggiungere un’etichetta al grafico. L’output seguente viene generato durante l’esecuzione del codice.

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

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 aspose.cells.drawing.ShapeCollection fornisce un metodo chiamato add_text_box_in_chart, 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 in alto a sinistra in unità di 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 aspose.cells.drawing.TextBox. La classe TextBox rappresenta una casella di testo nel grafico.

L’esempio seguente mostra come aggiungere una casella di testo a un grafico. L’esempio utilizza il file di progettazione precedente (exp_piechart.xls) che contiene un grafico. Utilizziamo questo file per inserire una casella di testo nel grafico per mostrare il titolo del grafico. Di seguito è riportato il codice originale per aggiungere una casella di testo al grafico.

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

Aggiunta di un’immagine al grafico

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

La classe aspose.cells.drawing.ShapeCollection fornisce un metodo chiamato add_picture_in_chart, 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 aspose.cells.drawing.Picture. La classe Picture rappresenta un oggetto immagine nel grafico.

L’esempio seguente mostra come aggiungere un’immagine al grafico. L’esempio utilizza il file di progettazione precedente (exp_piechart.xls) 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.

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

Aggiunta di una casella di controllo nel grafico

Aspose.Cells per Python via .NET consente di inserire caselle di controllo in un foglio di grafico usando 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 frammento di codice seguente è allegato per il tuo riferimento.

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

Argomenti avanzati

• Aggiungi WordArt Watermark al grafico