Legend classe

Legend classe

Incapsula l’oggetto che rappresenta la legenda del grafico.

Eredità: LegendChartTextFrameChartFrame

Il tipo Legend espone i seguenti membri:

Proprietà

ProprietàDescrizione
is_inner_modeIndica se la dimensione dell’area del tracciato include i segni di graduazione e le etichette degli assi.
False specifica che la dimensione determinerà la dimensione dell’area del tracciato, dei segni di graduazione e delle etichette degli assi.
borderOttiene lo Line.
areaOttiene lo ChartFrame.area.
text_fontOttiene un oggetto ChartFrame.font dell’oggetto ChartFrame specificato.
text_optionsOttiene e imposta le opzioni del testo.
fontOttiene un oggetto ChartFrame.font dell’oggetto ChartFrame specificato.
auto_scale_fontVero se il testo nell’oggetto cambia la dimensione del carattere quando cambia la dimensione dell’oggetto. Il valore predefinito è Vero.
background_modeOttiene e imposta la modalità di visualizzazione dello sfondo
backgroundOttiene e imposta la modalità di visualizzazione dello sfondo
is_automatic_sizeIndica se la cornice del grafico viene dimensionata automaticamente.
xOttiene o imposta la coordinata x dell’angolo superiore sinistro in unità di 1/4000 dell’area del grafico.
yOttiene o imposta la coordinata y dell’angolo superiore sinistro in unità di 1/4000 dell’area del grafico.
heightOttiene o imposta l’altezza del fotogramma in unità di 1/4000 dell’area del grafico.
widthOttiene o imposta la larghezza del frame in unità di 1/4000 dell’area del grafico.
shadowVero se la cornice ha un’ombra.
shape_propertiesOttiene l’oggetto ChartFrame.shape_properties.
is_default_pos_be_setIndica se è impostata la posizione predefinita (DefaultX, DefaultY, DefaultWidth e DefaultHeight).
default_xRappresenta x della posizione predefinita
default_yRappresenta y della posizione predefinita
default_widthRappresenta la larghezza della posizione predefinita
default_heightRappresenta l’altezza della posizione predefinita
is_auto_textIndica che il testo è generato automaticamente.
is_deletedIndica se queste etichette dati vengono eliminate.
text_horizontal_alignmentOttiene e imposta l’allineamento orizzontale del testo.
text_vertical_alignmentOttiene o imposta l’allineamento verticale del testo.
rotation_angleRappresenta l’angolo di rotazione del testo.
is_automatic_rotationIndica se il testo del grafico viene ruotato automaticamente.
textOttiene o imposta il testo del titolo di un frame.
linked_sourceOttiene e imposta un riferimento al foglio di lavoro.
text_directionRappresenta l’ordine di lettura del testo.
reading_orderRappresenta l’ordine di lettura del testo.
direction_typeOttiene e imposta la direzione del testo.
is_text_wrappedOttiene o imposta un valore che indica se il testo è andato a capo.
is_resize_shape_to_fit_textOttiene o imposta se una forma deve essere adattata automaticamente per contenere completamente il testo descritto al suo interno. L’adattamento automatico è
quando il testo all’interno di una forma viene ridimensionato per contenere tutto il testo all’interno.
positionOttiene o imposta il tipo di posizione della legenda.
legend_entriesOttiene una raccolta di tutti gli oggetti LegendEntry nella legenda del grafico specificata.
L’impostazione delle voci della legenda del grafico a superficie non è supportata.
Quindi restituirà null se il tipo di grafico è di tipo grafico a superficie.
legend_entries_labelsOttiene le etichette delle voci della legenda dopo la chiamata al metodo Chart.Calculate().
is_over_layOttiene o imposta se altri elementi del grafico possono sovrapporsi a questo elemento del grafico.

Metodi

MetodoDescrizione
set_position_autoImposta la posizione del telaio su automatico
charactersRestituisce un oggetto Characters che rappresenta un intervallo di caratteri all’interno del testo.
get_legend_labelsOttiene le etichette delle voci della legenda dopo la chiamata al metodo Chart.Calculate().

Esempio

from aspose.cells import Workbook
from aspose.cells.charts import ChartType, LegendPositionType

workbook = Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells
cells.get(0, 1).put_value("Income")
cells.get(1, 0).put_value("Company A")
cells.get(2, 0).put_value("Company B")
cells.get(3, 0).put_value("Company C")
cells.get(1, 1).put_value(10000)
cells.get(2, 1).put_value(20000)
cells.get(3, 1).put_value(30000)
chartIndex = sheet.charts.add(ChartType.COLUMN, 9, 9, 21, 15)
chart = sheet.charts[chartIndex]
chart.set_chart_data_range("A1:B4", True)
# Set Legend's width and height
legend = chart.legend
# Legend is at right side of chart by default.
# If the legend is at left or right side of the chart, setting Legend.X property will not take effect.
# If the legend is at top or bottom side of the chart, setting Legend.Y property will not take effect.
legend.y = 1500
legend.width = 50
legend.height = 50
# Set legend's position
legend.position = LegendPositionType.LEFT

Guarda anche