Axis classe

Axis classe

Encapsule l’objet qui représente un axe du 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 min est automatiquement attribuée.
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é majeure de l’axe est automatiquement affectée.
major_unitReprésente les unités principales de l’axe.
is_automatic_minor_unitIndique si l’unité mineure de l’axe est automatiquement affecté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 traverse.
cross_typeReprésente le Axis.cross_type sur l’axe spécifié où se croise l’autre axe.
log_baseReprésente la base logarithmique. La valeur par défaut est 10. S’applique uniquement à Excel2007.
is_logarithmicReprésente 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 étiquettes de graduation. S’applique uniquement aux axes de catégorie et de série.
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 de catégorie et de série.
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.
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 des valeurs importantes, par exemple en millions ou en milliards.
is_display_unit_label_shownReprésente 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 des unités de base pour l’axe des catégories.
major_unit_scaleReprésente l’échelle des unités principales pour l’axe des catégories.
minor_unit_scaleReprésente l’échelle des unités principales pour l’axe des catégories.
is_visibleReprésente si l’axe est visible.
major_grid_linesReprésente le quadrillage principal sur un axe du graphique.
minor_grid_linesReprésente un quadrillage mineur sur un axe du graphique.
has_multi_level_labelsIndique si les étiquettes doivent être affichées à plusieurs niveaux.
axis_labelsObtient les étiquettes de l’axe après avoir appelé la méthode Chart.Calculate().
binsReprésente les bacs sur un axe de graphique (histogramme/Pareto)

Méthodes

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

Exemple

À partir des codes suivants, vous pouvez apprendre comment 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