Axis classe

Axis classe

Encapsule l’objet qui représente un axe de graphique.

Le type Axis expose les membres suivants :

Propriétés

PropriétéDescription
areaObtient le Axis.area.
is_automatic_min_valueIndique si la valeur minimale est attribuée automatiquement.
min_valueReprésente la valeur minimale sur l’axe des valeurs.
is_automatic_max_valueIndique si la valeur maximale est automatiquement attribuée.
max_valueReprésente la valeur maximale sur l’axe des valeurs.
is_automatic_major_unitIndique si l’unité principale de l’axe est automatiquement attribuée.
major_unitReprésente les unités principales de l’axe.
is_automatic_minor_unitIndique si l’unité mineure de l’axe est automatiquement attribuée.
minor_unitReprésente les unités mineures de l’axe.
axis_lineObtient l’apparence d’un axe.
major_tick_markReprésente le type de graduation principale pour l’axe spécifié.
minor_tick_markReprésente le type de graduation mineure pour l’axe spécifié.
tick_label_positionReprésente la position des étiquettes de graduation sur l’axe spécifié.
cross_atReprésente le point sur l’axe des valeurs où l’axe des catégories le croise.
cross_typeReprésente le Axis.cross_type sur l’axe spécifié où l’autre axe croise.
log_baseReprésente la base logarithmique. La valeur par défaut est 10. Applicable uniquement à Excel 2007.
is_logarithmicIndique si le type d’échelle de l’axe des valeurs est logarithmique ou non.
is_plot_order_reversedReprésente si Microsoft Excel trace les points de données du dernier au premier.
axis_between_categoriesReprésente si l’axe des valeurs croise l’axe des catégories entre les catégories.
tick_labelsRenvoie un objet Axis.tick_labels qui représente les étiquettes de graduation pour l’axe spécifié.
tick_label_spacingReprésente le nombre de catégories ou de séries entre les graduations. S’applique uniquement aux axes des catégories et des séries.
is_auto_tick_label_spacingIndique si l’espacement des étiquettes de graduation est automatique
tick_mark_spacingRenvoie ou définit le nombre de catégories ou de séries entre les graduations. S’applique uniquement aux axes des catégories et des séries.
display_unitReprésente l’étiquette de l’unité pour l’axe spécifié.
cust_unitSpécifie une valeur personnalisée pour l’unité d’affichage.
custom_unitSpécifie une valeur personnalisée pour l’unité d’affichage.
custom_display_unitSpécifie une valeur personnalisée pour l’unité d’affichage.
display_unit_labelReprésente une étiquette d’unité sur un axe dans le graphique spécifié.
Les étiquettes d’unités sont utiles pour représenter graphiquement de grandes valeurs, par exemple en millions ou en milliards.
is_display_unit_label_shownIndique si l’étiquette de l’unité d’affichage est affichée sur l’axe spécifié.
titleObtient le titre de l’axe.
category_typeReprésente le type d’axe de catégorie.
base_unit_scaleReprésente l’échelle de l’unité de base pour l’axe des catégories.
major_unit_scaleReprésente l’échelle de l’unité principale pour l’axe des catégories.
minor_unit_scaleReprésente l’échelle de l’unité principale pour l’axe des catégories.
is_visibleIndique si l’axe est visible.
major_grid_linesReprésente les principales lignes de la grille sur un axe de graphique.
minor_grid_linesReprésente les lignes de grille mineures sur un axe de graphique.
has_multi_level_labelsIndique si les étiquettes doivent être affichées sur plusieurs niveaux.
axis_labelsObtient les étiquettes de l’axe après l’appel de la méthode Chart.Calculate().
binsReprésente les bacs sur un axe de graphique (histogramme/Pareto)

Méthodes

MéthodeDescription
get_axis_texts(self)Obtient les étiquettes de l’axe après l’appel de la méthode Chart.Calculate().

Exemple

À partir des codes suivants, vous pouvez apprendre à définir l’unité, la valeur maximale et minimale de 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")

Voir également