Axis classe

Axis classe

Incapsula l’oggetto che rappresenta un asse del grafico.

Il tipo Axis espone i seguenti membri:

Proprietà

ProprietàDescrizione
areaOttiene Axis.area.
is_automatic_min_valueIndica se il valore minimo viene assegnato automaticamente.
min_valueRappresenta il valore minimo sull’asse dei valori.
is_automatic_max_valueIndica se il valore massimo viene assegnato automaticamente.
max_valueRappresenta il valore massimo sull’asse dei valori.
is_automatic_major_unitIndica se l’unità principale dell’asse viene assegnata automaticamente.
major_unitRappresenta le unità principali dell’asse.
is_automatic_minor_unitIndica se l’unità minore dell’asse viene assegnata automaticamente.
minor_unitRappresenta le unità minori dell’asse.
axis_lineOttiene l’aspetto di un Asse.
major_tick_markRappresenta il tipo di segno di spunta principale per l’asse specificato.
minor_tick_markRappresenta il tipo di segno di spunta minore per l’asse specificato.
tick_label_positionRappresenta la posizione delle etichette dei segni di spunta sull’asse specificato.
cross_atRappresenta il punto sull’asse dei valori in cui l’asse delle categorie lo interseca.
cross_typeRappresenta Axis.cross_type sull’asse specificato dove l’altro asse si incrocia.
log_baseRappresenta la base logaritmica. Il valore predefinito è 10. Valido solo per Excel 2007.
is_logarithmicRappresenta se il tipo di scala dell’asse dei valori è logaritmico o meno.
is_plot_order_reversedRappresenta se Microsoft Excel traccia i punti dati dall’ultimo al primo.
axis_between_categoriesRappresenta se l’asse dei valori interseca l’asse delle categorie tra le categorie.
tick_labelsRestituisce un oggetto Axis.tick_labels che rappresenta le etichette dei segni di spunta per l’asse specificato.
tick_label_spacingRappresenta il numero di categorie o serie tra le etichette con segno di spunta. Si applica solo agli assi di categoria e serie.
is_auto_tick_label_spacingIndica se la spaziatura delle etichette di spunta è automatica
tick_mark_spacingRestituisce o imposta il numero di categorie o serie tra i segni di spunta. Si applica solo agli assi di categorie e serie.
display_unitRappresenta l’etichetta dell’unità per l’asse specificato.
cust_unitSpecifica un valore personalizzato per l’unità di visualizzazione.
custom_unitSpecifica un valore personalizzato per l’unità di visualizzazione.
custom_display_unitSpecifica un valore personalizzato per l’unità di visualizzazione.
display_unit_labelRappresenta un’etichetta di unità su un asse nel grafico specificato.
Le etichette delle unità sono utili per rappresentare graficamente valori elevati, ad esempio milioni o miliardi.
is_display_unit_label_shownIndica se l’etichetta dell’unità di visualizzazione viene mostrata sull’asse specificato.
titleOttiene il titolo dell’asse.
category_typeRappresenta il tipo di asse delle categorie.
base_unit_scaleRappresenta la scala dell’unità di base per l’asse delle categorie.
major_unit_scaleRappresenta la scala dell’unità principale per l’asse delle categorie.
minor_unit_scaleRappresenta la scala dell’unità principale per l’asse delle categorie.
is_visibleIndica se l’asse è visibile.
major_grid_linesRappresenta le principali linee della griglia su un asse del grafico.
minor_grid_linesRappresenta le linee della griglia secondaria su un asse del grafico.
has_multi_level_labelsIndica se le etichette devono essere visualizzate su più livelli.
axis_labelsOttiene le etichette dell’asse dopo la chiamata al metodo Chart.Calculate().
binsRappresenta i contenitori su un asse del grafico (istogramma/Pareto)

Metodi

MetodoDescrizione
get_axis_texts(self)Ottiene le etichette dell’asse dopo la chiamata al metodo Chart.Calculate().

Esempio

Dai seguenti codici puoi imparare come impostare l’unità, il valore massimo e minimo di Axis.

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

# Instantiating a Workbook object
workbook = Workbook()
# Adding a new worksheet to the Excel object
sheetIndex = workbook.worksheets.add()
# Obtaining the reference of the newly added worksheet by passing its sheet index
worksheet = workbook.worksheets[sheetIndex]
# Adding a sample value to "A1" cell
worksheet.cells.get("A1").put_value(50)
# Adding a sample value to "A2" cell
worksheet.cells.get("A2").put_value(100)
# Adding a sample value to "A3" cell
worksheet.cells.get("A3").put_value(150)
# Adding a sample value to "B1" cell
worksheet.cells.get("B1").put_value(4)
# Adding a sample value to "B2" cell
worksheet.cells.get("B2").put_value(20)
# Adding a sample value to "B3" cell
worksheet.cells.get("B3").put_value(50)
# Adding a chart to the worksheet
chartIndex = worksheet.charts.add(ChartType.COLUMN, 5, 0, 25, 5)
# Accessing the instance of the newly added chart
chart = worksheet.charts[chartIndex]
# Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B3"
chart.n_series.add("A1:B3", True)
# Set the max value of value axis
chart.value_axis.max_value = 200
# Set the min value of value axis
chart.value_axis.min_value = 0
# Set the major unit
chart.value_axis.major_unit = 25.0
# Category(X) axis crosses at the maxinum value.
chart.value_axis.cross_type = CrossType.MAXIMUM
# Set he number of categories or series between tick-mark labels.
chart.category_axis.tick_label_spacing = 2
# do your business
# Saving the Excel file
workbook.save("book1.xlsx")

Guarda anche