DataLabels classe

Incapsula una raccolta di tutti gli oggetti DataLabel per la serie specificata.

Eredità: DataLabels → ChartTextFrame → ChartFrame

Il tipo DataLabels 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 `DataLabels.area`.
text_font	Ottiene un oggetto `ChartFrame.font` dell’oggetto ChartFrame specificato.
text_options	Ottiene e imposta le opzioni del testo.
font	Ottiene il font delle DataLabels;
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 dell’etichetta dati.
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.
show_value	Rappresenta il comportamento di visualizzazione dei valori delle etichette dati di un grafico specificato. True visualizza i valori. False li nasconde.
show_cell_range	Indica se visualizzare l’intervallo di celle come etichette dati.
show_percentage	Rappresenta il comportamento di visualizzazione del valore percentuale dell’etichetta dati di un grafico specificato. True visualizza il valore percentuale. False lo nasconde.
show_bubble_size	Rappresenta il comportamento di visualizzazione del valore percentuale dell’etichetta dati di un grafico specificato. True visualizza il valore percentuale. False lo nasconde.
show_category_name	Rappresenta il comportamento di visualizzazione del nome della categoria delle etichette dati di un grafico specificato. True per visualizzare il nome della categoria per le etichette dati di un grafico. False per nasconderlo.
show_series_name	Indica se il nome della serie viene visualizzato per le etichette dati in un grafico. True per mostrare il nome della serie. False per nasconderlo.
show_legend_key	Rappresenta il comportamento di visualizzazione della legenda delle etichette dati di un grafico specificato. Vero se la legenda dell’etichetta dati è visibile.
number_format	Rappresenta la stringa di formato per l’oggetto DataLabels.
number	Ottiene e imposta il formato numerico incorporato.
number_format_linked	Vero se il formato numerico è collegato alle celle (in modo che il formato dei numeri cambi nelle etichette quando cambia nelle celle).
separator_type	Ottiene o imposta il tipo di separatore utilizzato per le etichette dati su un grafico.
separator_value	Ottiene o imposta il valore del separatore utilizzato per le etichette dati su un grafico.
position	Rappresenta la posizione dell’etichetta dati.
is_never_overlap	Indica se le etichette dati visualizzate non si sovrappongono mai. (Per grafici a torta)
shape_type	Ottiene o imposta il tipo di forma dell’etichetta dati.

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.
`apply_font(self)`	Applica il font delle etichette dati a tutti i nodi figlio.

Esempio

from aspose.cells import Workbook
from aspose.cells.charts import LabelPositionType

# Set the DataLabels in the chart
wb = Workbook("chart.xlsx")
chart = wb.worksheets[0].charts[0]
for i in range(len(chart.n_series)):
    datalabels = chart.n_series[i].data_labels
    # Set the position of DataLabels
    datalabels.position = LabelPositionType.INSIDE_BASE
    # Show the category name in the DataLabels
    datalabels.show_category_name = True
    # Show the value in the DataLabels
    datalabels.show_value = True
    # Not show the percentage in the DataLabels
    datalabels.show_percentage = False
    # Not show the legend key.
    datalabels.show_legend_key = False

Guarda anche

ChartTextFrame classe DisplayUnitLabel classe