Legend classe

Incapsula l’oggetto che rappresenta la legenda del grafico.

Eredità: Legend → ChartTextFrame → ChartFrame

Il tipo Legend espone i seguenti membri:

Proprietà

Proprietà	Descrizione
is_inner_mode	Indica se la dimensione dell’area del grafico include i segni di spunta e le etichette degli assi. False specifica che la dimensione determinerà la dimensione dell’area del grafico, dei segni di spunta e delle etichette degli assi.
border	Ottiene `Line`.
area	Ottiene `ChartFrame.area`.
text_font	Ottiene un oggetto `ChartFrame.font` dell’oggetto ChartFrame specificato.
text_options	Ottiene e imposta le opzioni del testo.
font	Ottiene un oggetto `ChartFrame.font` dell’oggetto ChartFrame specificato.
auto_scale_font	Vero se il testo nell’oggetto cambia dimensione del carattere quando cambia la dimensione dell’oggetto. Il valore predefinito è Vero.
background_mode	Ottiene e imposta la modalità di visualizzazione dello sfondo
background	Ottiene e imposta la modalità di visualizzazione dello sfondo
is_automatic_size	Indica se la cornice del grafico ha dimensioni automatiche.
x	Ottiene o imposta la coordinata x dell’angolo superiore sinistro in unità di 1/4000 dell’area del grafico.
y	Ottiene o imposta la coordinata y dell’angolo superiore sinistro in unità di 1/4000 dell’area del grafico.
height	Ottiene o imposta l’altezza della cornice in unità di 1/4000 dell’area del grafico.
width	Ottiene o imposta la larghezza della cornice in unità di 1/4000 dell’area del grafico.
shadow	Vero se la cornice ha un’ombra.
shape_properties	Ottiene l’oggetto `ChartFrame.shape_properties`.
is_default_pos_be_set	Indica se sono impostate le posizioni predefinite (DefaultX, DefaultY, DefaultWidth e DefaultHeight).
default_x	Rappresenta x della posizione predefinita in unità di 1/4000 dell’area del grafico.
default_y	Rappresenta la y della posizione predefinita in unità di 1/4000 dell’area del grafico.
default_width	Rappresenta la larghezza della posizione predefinita in unità di 1/4000 dell’area del grafico.
default_height	Rappresenta l’altezza della posizione predefinita in unità di 1/4000 dell’area del grafico.
default_x_ratio_to_chart	Rappresenta x della posizione predefinita in unità di frazione dell’area del grafico.
default_y_ratio_to_chart	Rappresenta la posizione predefinita in unità di frazione dell’area del grafico.
default_width_ratio_to_chart	Rappresenta la larghezza della posizione predefinita in unità di frazione dell’area del grafico.
default_height_ratio_to_chart	Rappresenta l’altezza della posizione predefinita in unità di frazione dell’area del grafico.
x_ratio_to_chart	Ottiene o imposta la coordinata x dell’angolo superiore sinistro in unità di rapporto dell’area del grafico.
y_ratio_to_chart	Ottiene o imposta la coordinata y dell’angolo superiore sinistro in unità di rapporto dell’area del grafico.
width_ratio_to_chart	Ottiene o imposta la larghezza della cornice in unità di rapporto dell’area del grafico.
height_ratio_to_chart	Ottiene o imposta l’altezza della cornice in unità di rapporto dell’area del grafico.
x_pixel	Ottiene o imposta la coordinata x dell’angolo superiore sinistro in unità Pixel.
y_pixel	Ottiene o imposta la coordinata y dell’angolo superiore sinistro in unità Pixel.
width_pixel	Ottiene o imposta la larghezza del fotogramma in unità Pixel.
height_pixel	Ottiene o imposta l’altezza del fotogramma in unità Pixel.
is_auto_text	Indica che il testo è generato automaticamente.
is_deleted	Indica se queste etichette dati vengono eliminate.
text_horizontal_alignment	Ottiene e imposta l’allineamento orizzontale del testo.
text_vertical_alignment	Ottiene o imposta l’allineamento verticale del testo.
rotation_angle	Rappresenta l’angolo di rotazione del testo.
is_automatic_rotation	Indica se il testo del grafico viene ruotato automaticamente.
text	Ottiene o imposta il testo del titolo di un frame.
linked_source	Ottiene e imposta un riferimento al foglio di lavoro.
text_direction	Rappresenta l’ordine di lettura del testo.
reading_order	Rappresenta l’ordine di lettura del testo.
direction_type	Ottiene e imposta la direzione del testo.
is_text_wrapped	Ottiene o imposta un valore che indica se il testo è a capo.
is_resize_shape_to_fit_text	Ottiene 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 al suo interno.
position	Ottiene o imposta il tipo di posizione della legenda.
legend_entries	Ottiene una raccolta di tutti gli oggetti LegendEntry nella legenda del grafico specificata. L’impostazione delle voci della legenda del grafico di superficie non è supportata. Quindi restituirà null se il tipo di grafico è un grafico di superficie.
legend_entries_labels	Ottiene le etichette delle voci della legenda dopo la chiamata al metodo Chart.Calculate().
is_over_lay	Ottiene o imposta se visualizzare la legenda senza sovrapporla al grafico.

Metodi

Metodo	Descrizione
`set_position_auto(self)`	Imposta la posizione del frame su automatico
`characters(self, start_index, length)`	Restituisce un oggetto Characters che rappresenta un intervallo di caratteri all’interno del testo.
`get_legend_labels(self)`	Ottiene 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

Floor classe LegendEntry classe