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
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
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
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
EscalaDeUnidadBase
Representa la escala de unidad base para el eje de categoría.
public TimeUnit BaseUnitScale { get; set; }
Valor de la Propiedad
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
TipoDeCategoría
Representa el tipo de eje de categoría.
public CategoryType CategoryType { get; set; }
Valor de la Propiedad
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
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
UnidadDeVisualizaciónPersonalizada
Especifica un valor personalizado para la unidad de visualización.
public double CustomDisplayUnit { get; set; }
Valor de la Propiedad
UnidadDeVisualización
Representa la etiqueta de unidad para el eje especificado.
public DisplayUnitType DisplayUnit { get; set; }
Valor de la Propiedad
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
TieneEtiquetasMultiNivel
Indica si las etiquetas se mostrarán como multi nivel.
public bool HasMultiLevelLabels { get; set; }
Valor de la Propiedad
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
EsUnidadMayorAutomática
Indica si la unidad mayor del eje se asigna automáticamente.
public bool IsAutomaticMajorUnit { get; set; }
Valor de la Propiedad
EsValorMáximoAutomático
Indica si el valor máximo se asigna automáticamente.
public bool IsAutomaticMaxValue { get; set; }
Valor de la Propiedad
EsValorMínimoAutomático
Indica si el valor mínimo se asigna automáticamente.
public bool IsAutomaticMinValue { get; set; }
Valor de la Propiedad
EsUnidadMenorAutomática
Indica si la unidad menor del eje se asigna automáticamente.
public bool IsAutomaticMinorUnit { get; set; }
Valor de la Propiedad
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
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
EsOrdenDeGráficoRevertido
Representa si Microsoft Excel grafica los puntos de datos de último a primero.
public bool IsPlotOrderReversed { get; set; }
Valor de la Propiedad
EsVisible
Representa si el eje es visible.
public bool IsVisible { get; set; }
Valor de la Propiedad
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
LíneasDeCuadrículaMayores
Representa líneas de cuadrícula mayores en un eje de gráfico.
public Line MajorGridLines { get; }
Valor de la Propiedad
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
UnidadMayor
Representa las unidades mayores para el eje.
public double MajorUnit { get; set; }
Valor de la Propiedad
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
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
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
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
MarcaDeTickMenor
Representa el tipo de marca de tick menor para el eje especificado.
public TickMarkType MinorTickMark { get; set; }
Valor de la Propiedad
UnidadMenor
Representa las unidades menores para el eje.
public double MinorUnit { get; set; }
Valor de la Propiedad
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
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
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
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
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
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
Métodos
GetAxisTexts()
Obtiene las etiquetas del eje después de llamar al método Chart.Calculate().
public string[] GetAxisTexts()
Devuelve
string[]