Class Axis

Class Axis

Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)

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

public class Axis

Herencia

objectAxis

Miembros Heredados

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Ejemplos

A partir de los siguientes códigos, puedes aprender cómo establecer la unidad, el valor máximo y el valor mínimo del Eje.

//Instanciando un objeto Workbook
Workbook workbook = new Workbook();
//Agregando una nueva hoja de cálculo al objeto Excel
int sheetIndex = workbook.Worksheets.Add();
//Obteniendo la referencia de la hoja de cálculo recién agregada pasando su índice de hoja
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Agregando un valor de muestra a la celda "A1"
worksheet.Cells["A1"].PutValue(50);
//Agregando un valor de muestra a la celda "A2"
worksheet.Cells["A2"].PutValue(100);
//Agregando un valor de muestra a la celda "A3"
worksheet.Cells["A3"].PutValue(150);
//Agregando un valor de muestra a la celda "B1"
worksheet.Cells["B1"].PutValue(4);
//Agregando un valor de muestra a la celda "B2"
worksheet.Cells["B2"].PutValue(20);
//Agregando un valor de muestra a la celda "B3"
worksheet.Cells["B3"].PutValue(50);
//Agregando un gráfico a la hoja de cálculo
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5);
//Accediendo a la instancia del gráfico recién agregado
Chart chart = worksheet.Charts[chartIndex];
//Agregando NSeries (fuente de datos del gráfico) al gráfico desde la celda "A1" hasta "B3"
chart.NSeries.Add("A1:B3", true);
//Establecer el valor máximo del eje de valores
chart.ValueAxis.MaxValue = 200;
//Establecer el valor mínimo del eje de valores
chart.ValueAxis.MinValue = 0;
//Establecer la unidad mayor
chart.ValueAxis.MajorUnit = 25;
//El eje de categoría (X) cruza en el valor máximo.
chart.ValueAxis.CrossType = CrossType.Maximum;
//Establecer el número de categorías o series entre las etiquetas de marcas.
chart.CategoryAxis.TickLabelSpacing = 2;

//realiza tu negocio

//Guardando el archivo de Excel
workbook.Save("book1.xlsx");
'Instanciando un objeto Workbook
Dim workbook As Workbook = New Workbook()
'Agregando una nueva hoja de cálculo al objeto Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Obteniendo la referencia de la hoja de cálculo recién agregada pasando su índice de hoja
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Agregando un valor de muestra a la celda "A1"
worksheet.Cells("A1").PutValue(50)
'Agregando un valor de muestra a la celda "A2"
worksheet.Cells("A2").PutValue(100)
'Agregando un valor de muestra a la celda "A3"
worksheet.Cells("A3").PutValue(150)
'Agregando un valor de muestra a la celda "B1"
worksheet.Cells("B1").PutValue(4)
'Agregando un valor de muestra a la celda "B2"
worksheet.Cells("B2").PutValue(20)
'Agregando un valor de muestra a la celda "B3"
worksheet.Cells("B3").PutValue(50)
'Agregando un gráfico a la hoja de cálculo
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5)
'Accediendo a la instancia del gráfico recién agregado
Dim chart As Chart = worksheet.Charts(chartIndex)
'Agregando NSeries (fuente de datos del gráfico) al gráfico desde la celda "A1" hasta "B3"
chart.NSeries.Add("A1:B3", True)
'Establecer el valor máximo del eje de valores
chart.ValueAxis.MaxValue = 200
'Establecer el valor mínimo del eje de valores
chart.ValueAxis.MinValue = 0
'Establecer la unidad mayor
chart.ValueAxis.MajorUnit = 25
'El eje de categoría (X) cruza en el valor máximo.
chart.ValueAxis.CrossType = CrossType.Maximum
'Establecer el número de categorías o series entre las etiquetas de marcas.
chart.CategoryAxis.TickLabelSpacing = 2
'Guardando el archivo de Excel
workbook.Save("book1.xlsx")

Propiedades

Área

Obtiene el Aspose.Cells.Charts.Axis.Area.

public Area Area { get; }

Valor de la Propiedad

Area

EjeEntreCategorías

Representa si el eje de valores cruza el eje de categorías entre categorías.

public bool AxisBetweenCategories { get; set; }

Valor de la Propiedad

bool

Observaciones

Esta propiedad se aplica solo a ejes de categoría, y no se aplica a gráficos en 3D.

LíneaDelEje

Obtiene la apariencia de un Eje.

public Line AxisLine { get; }

Valor de la Propiedad

Line

EscalaDeUnidadBase

Representa la escala de unidad base para el eje de categoría.

public TimeUnit BaseUnitScale { get; set; }

Valor de la Propiedad

TimeUnit

Observaciones

Establecer esta propiedad solo tiene efecto cuando la propiedad CategoryType se establece en TimeScale.

Contenedores

Representa contenedores en un eje de gráfico (Histograma/Pareto)

public AxisBins Bins { get; }

Valor de la Propiedad

AxisBins

TipoDeCategoría

Representa el tipo de eje de categoría.

public CategoryType CategoryType { get; set; }

Valor de la Propiedad

CategoryType

CruzarEn

Representa el punto en el eje de valores donde el eje de categoría lo cruza.

public double CrossAt { get; set; }

Valor de la Propiedad

double

Observaciones

El número debe ser un entero cuando se aplica al eje de categoría. Y el valor debe estar entre 1 y 31999.

TipoDeCruzamiento

Representa el Aspose.Cells.Charts.Axis.CrossType en el eje especificado donde el otro eje cruza.

public CrossType CrossType { get; set; }

Valor de la Propiedad

CrossType

UnidadDeVisualizaciónPersonalizada

Especifica un valor personalizado para la unidad de visualización.

public double CustomDisplayUnit { get; set; }

Valor de la Propiedad

double

UnidadDeVisualización

Representa la etiqueta de unidad para el eje especificado.

public DisplayUnitType DisplayUnit { get; set; }

Valor de la Propiedad

DisplayUnitType

EtiquetaDeUnidadDeVisualización

Representa una etiqueta de unidad en un eje en el gráfico especificado. Las etiquetas de unidad son útiles para graficar valores grandes— por ejemplo, en millones o miles de millones.

public DisplayUnitLabel DisplayUnitLabel { get; }

Valor de la Propiedad

DisplayUnitLabel

TieneEtiquetasMultiNivel

Indica si las etiquetas se mostrarán como multi nivel.

public bool HasMultiLevelLabels { get; set; }

Valor de la Propiedad

bool

Observaciones

Solo válido para el eje de categoría.

EsEspaciadoDeEtiquetaDeMarcaAutomatico

Indica si el espaciado de la etiqueta de marca es automático.

public bool IsAutoTickLabelSpacing { get; set; }

Valor de la Propiedad

bool

EsUnidadMayorAutomática

Indica si la unidad mayor del eje se asigna automáticamente.

public bool IsAutomaticMajorUnit { get; set; }

Valor de la Propiedad

bool

EsValorMáximoAutomático

Indica si el valor máximo se asigna automáticamente.

public bool IsAutomaticMaxValue { get; set; }

Valor de la Propiedad

bool

EsValorMínimoAutomático

Indica si el valor mínimo se asigna automáticamente.

public bool IsAutomaticMinValue { get; set; }

Valor de la Propiedad

bool

EsUnidadMenorAutomática

Indica si la unidad menor del eje se asigna automáticamente.

public bool IsAutomaticMinorUnit { get; set; }

Valor de la Propiedad

bool

EsEtiquetaDeUnidadDeVisualizaciónMostrada

Representa si la etiqueta de unidad de visualización se muestra en el eje especificado.

public bool IsDisplayUnitLabelShown { get; set; }

Valor de la Propiedad

bool

Observaciones

El valor predeterminado es True.

EsLogarítmico

Representa si el tipo de escala del eje de valores es logarítmico o no.

public bool IsLogarithmic { get; set; }

Valor de la Propiedad

bool

EsOrdenDeGráficoRevertido

Representa si Microsoft Excel grafica los puntos de datos de último a primero.

public bool IsPlotOrderReversed { get; set; }

Valor de la Propiedad

bool

EsVisible

Representa si el eje es visible.

public bool IsVisible { get; set; }

Valor de la Propiedad

bool

BaseLogarítmica

Representa la base logarítmica. El valor predeterminado es 10. Solo se aplica para Excel2007.

public double LogBase { get; set; }

Valor de la Propiedad

double

LíneasDeCuadrículaMayores

Representa líneas de cuadrícula mayores en un eje de gráfico.

public Line MajorGridLines { get; }

Valor de la Propiedad

Line

Ejemplos

chart.ValueAxis.MajorGridLines.IsVisible = false;
chart.CategoryAxis.MajorGridLines.IsVisible = true;
chart.ValueAxis.MajorGridLines.IsVisible = false
chart.CategoryAxis.MajorGridLines.IsVisible = true

MarcaDeTickMayor

Representa el tipo de marca de tick mayor para el eje especificado.

public TickMarkType MajorTickMark { get; set; }

Valor de la Propiedad

TickMarkType

UnidadMayor

Representa las unidades mayores para el eje.

public double MajorUnit { get; set; }

Valor de la Propiedad

double

Observaciones

Las unidades mayores deben ser mayores que cero.

EscalaDeUnidadMayor

Representa la escala de unidad mayor para el eje de categoría.

public TimeUnit MajorUnitScale { get; set; }

Valor de la Propiedad

TimeUnit

Ejemplos

chart.CategoryAxis.CategoryType = CategoryType.TimeScale;
chart.CategoryAxis.MajorUnitScale = TimeUnit.Months;
chart.CategoryAxis.MajorUnit = 2;
chart.CategoryAxis.CategoryType = CategoryType.TimeScale
chart.CategoryAxis.MajorUnitScale = TimeUnit.Months
chart.CategoryAxis.MajorUnit = 2

ValorMáximo

Representa el valor máximo en el eje de valores.

public object MaxValue { get; set; }

Valor de la Propiedad

object

Observaciones

El tipo de maxValue solo puede ser double o DateTime.

ValorMínimo

Representa el valor mínimo en el eje de valores.

public object MinValue { get; set; }

Valor de la Propiedad

object

Observaciones

El tipo de minValue solo puede ser double o DateTime.

LíneasDeCuadrículaMenores

Representa líneas de cuadrícula menores en un eje de gráfico.

public Line MinorGridLines { get; }

Valor de la Propiedad

Line

MarcaDeTickMenor

Representa el tipo de marca de tick menor para el eje especificado.

public TickMarkType MinorTickMark { get; set; }

Valor de la Propiedad

TickMarkType

UnidadMenor

Representa las unidades menores para el eje.

public double MinorUnit { get; set; }

Valor de la Propiedad

double

Observaciones

Las unidades menores deben ser mayores que cero.

EscalaDeUnidadMenor

Representa la escala de unidad menor para el eje de categoría.

public TimeUnit MinorUnitScale { get; set; }

Valor de la Propiedad

TimeUnit

Ejemplos

chart.CategoryAxis.CategoryType = CategoryType.TimeScale;
chart.CategoryAxis.MinorUnitScale = TimeUnit.Months;
chart.CategoryAxis.MinorUnit = 2;
chart.CategoryAxis.CategoryType = CategoryType.TimeScale
chart.CategoryAxis.MinorUnitScale = TimeUnit.Months
chart.CategoryAxis.MinorUnit = 2

PosiciónDeEtiquetaDeMarca

Representa la posición de las etiquetas de marcas en el eje especificado.

public TickLabelPositionType TickLabelPosition { get; set; }

Valor de la Propiedad

TickLabelPositionType

EspaciadoDeEtiquetaDeMarca

Representa el número de categorías o series entre las etiquetas de marcas. Se aplica solo a ejes de categoría y serie.

public int TickLabelSpacing { get; set; }

Valor de la Propiedad

int

Observaciones

El número debe estar entre 1 y 31999.

EtiquetasDeMarca

Devuelve un objeto Aspose.Cells.Charts.Axis.TickLabels que representa las etiquetas de marcas para el eje especificado.

public TickLabels TickLabels { get; }

Valor de la Propiedad

TickLabels

EspaciadoDeMarcaDeTick

Devuelve o establece el número de categorías o series entre las marcas de ticks. Se aplica solo a ejes de categoría y serie.

public int TickMarkSpacing { get; set; }

Valor de la Propiedad

int

Observaciones

El número debe estar entre 1 y 31999.

Título

Obtiene el título del eje.

public Title Title { get; }

Valor de la Propiedad

Title

Métodos

GetAxisTexts()

Obtiene las etiquetas del eje después de llamar al método Chart.Calculate().

public string[] GetAxisTexts()

Devuelve

string[]

 Español