Axis clase

Axis clase

Encapsula el objeto que representa un eje del gráfico.

El tipo Axis expone los siguientes miembros:

Propiedades

PropiedadDescripción
areaObtiene el Axis.area.
is_automatic_min_valueIndica si el valor mínimo se asigna automáticamente.
min_valueRepresenta el valor mínimo en el eje de valores.
is_automatic_max_valueIndica si el valor máximo se asigna automáticamente.
max_valueRepresenta el valor máximo en el eje de valores.
is_automatic_major_unitIndica si la unidad mayor del eje se asigna automáticamente.
major_unitRepresenta las unidades principales del eje.
is_automatic_minor_unitIndica si la unidad menor del eje se asigna automáticamente.
minor_unitRepresenta las unidades menores del eje.
axis_lineObtiene la apariencia de un Eje.
major_tick_markRepresenta el tipo de marca de graduación principal para el eje especificado.
minor_tick_markRepresenta el tipo de marca menor para el eje especificado.
tick_label_positionRepresenta la posición de las etiquetas de marca en el eje especificado.
cross_atRepresenta el punto en el eje de valores donde lo cruza el eje de categorías.
cross_typeRepresenta el Axis.cross_type en el eje especificado donde se cruza el otro eje.
log_baseRepresenta la base logarítmica. El valor predeterminado es 10. Sólo se aplica a Excel2007.
is_logarithmicRepresenta si el tipo de escala del eje de valores es logarítmico o no.
is_plot_order_reversedRepresenta si Microsoft Excel traza puntos de datos del último al primero.
axis_between_categoriesRepresenta si el eje de valores cruza el eje de categorías entre categorías.
tick_labelsDevuelve un objeto Axis.tick_labels que representa las etiquetas de marca para el eje especificado.
tick_label_spacingRepresenta el número de categorías o series entre etiquetas de marcas. Se aplica sólo a ejes de categoría y serie.
is_auto_tick_label_spacingIndica si el espaciado de la etiqueta de marca es automático
tick_mark_spacingDevuelve o establece el número de categorías o series entre marcas de graduación. Se aplica sólo a ejes de categoría y serie.
display_unitRepresenta la etiqueta de unidad para el eje especificado.
cust_unitEspecifica un valor personalizado para la unidad de visualización.
custom_unitEspecifica un valor personalizado para la unidad de visualización.
display_unit_labelRepresenta una etiqueta de unidad en un eje del gráfico especificado.
Las etiquetas de unidades son útiles para representar gráficamente valores grandes, por ejemplo, en millones o miles de millones.
is_display_unit_label_shownRepresenta si la etiqueta de la unidad de visualización se muestra en el eje especificado.
titleObtiene el título del eje.
category_typeRepresenta el tipo de eje de categorías.
base_unit_scaleRepresenta la escala de unidades base para el eje de categorías.
major_unit_scaleRepresenta la escala de unidades principales para el eje de categorías.
minor_unit_scaleRepresenta la escala de unidades principales para el eje de categorías.
is_visibleRepresenta si el eje es visible.
major_grid_linesRepresenta las líneas de cuadrícula principales en el eje de un gráfico.
minor_grid_linesRepresenta líneas de cuadrícula menores en el eje de un gráfico.
has_multi_level_labelsIndica si las etiquetas se mostrarán como de varios niveles.
axis_labelsObtiene las etiquetas del eje después de llamar al método Chart.Calculate().
binsRepresenta contenedores en el eje de un gráfico (histograma/Pareto)

Métodos

MétodoDescripción
get_axis_textsObtiene las etiquetas del eje después de llamar al método Chart.Calculate().

Ejemplo

A partir de los siguientes códigos, puede aprender cómo configurar la unidad, el valor máximo y mínimo 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")

Ver también