Class Axis
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Encapsula o objeto que representa um eixo de gráfico.
public class Axis
Herança
Membros Herdados
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Exemplos
A partir dos códigos a seguir, você pode aprender como definir a unidade, o valor máximo e o valor mínimo do Eixo.
//Instanciando um objeto Workbook
Workbook workbook = new Workbook();
//Adicionando uma nova planilha ao objeto Excel
int sheetIndex = workbook.Worksheets.Add();
//Obtendo a referência da nova planilha adicionada passando seu índice de planilha
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Adicionando um valor de exemplo à célula "A1"
worksheet.Cells["A1"].PutValue(50);
//Adicionando um valor de exemplo à célula "A2"
worksheet.Cells["A2"].PutValue(100);
//Adicionando um valor de exemplo à célula "A3"
worksheet.Cells["A3"].PutValue(150);
//Adicionando um valor de exemplo à célula "B1"
worksheet.Cells["B1"].PutValue(4);
//Adicionando um valor de exemplo à célula "B2"
worksheet.Cells["B2"].PutValue(20);
//Adicionando um valor de exemplo à célula "B3"
worksheet.Cells["B3"].PutValue(50);
//Adicionando um gráfico à planilha
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5);
//Acessando a instância do gráfico recém-adicionado
Chart chart = worksheet.Charts[chartIndex];
//Adicionando NSeries (fonte de dados do gráfico) ao gráfico variando de "A1" a "B3"
chart.NSeries.Add("A1:B3", true);
//Definindo o valor máximo do eixo de valores
chart.ValueAxis.MaxValue = 200;
//Definindo o valor mínimo do eixo de valores
chart.ValueAxis.MinValue = 0;
//Definindo a unidade maior
chart.ValueAxis.MajorUnit = 25;
//O eixo de Categoria(X) cruza no valor máximo.
chart.ValueAxis.CrossType = CrossType.Maximum;
//Definindo o número de categorias ou séries entre os rótulos de marcas.
chart.CategoryAxis.TickLabelSpacing = 2;
//faça seu negócio
//Salvando o arquivo Excel
workbook.Save("book1.xlsx");
'Instanciando um objeto Workbook
Dim workbook As Workbook = New Workbook()
'Adicionando uma nova planilha ao objeto Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Obtendo a referência da nova planilha adicionada passando seu índice de planilha
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Adicionando um valor de exemplo à célula "A1"
worksheet.Cells("A1").PutValue(50)
'Adicionando um valor de exemplo à célula "A2"
worksheet.Cells("A2").PutValue(100)
'Adicionando um valor de exemplo à célula "A3"
worksheet.Cells("A3").PutValue(150)
'Adicionando um valor de exemplo à célula "B1"
worksheet.Cells("B1").PutValue(4)
'Adicionando um valor de exemplo à célula "B2"
worksheet.Cells("B2").PutValue(20)
'Adicionando um valor de exemplo à célula "B3"
worksheet.Cells("B3").PutValue(50)
'Adicionando um gráfico à planilha
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5)
'Acessando a instância do gráfico recém-adicionado
Dim chart As Chart = worksheet.Charts(chartIndex)
'Adicionando NSeries (fonte de dados do gráfico) ao gráfico variando de "A1" a "B3"
chart.NSeries.Add("A1:B3", True)
'Definindo o valor máximo do eixo de valores
chart.ValueAxis.MaxValue = 200
'Definindo o valor mínimo do eixo de valores
chart.ValueAxis.MinValue = 0
'Definindo a unidade maior
chart.ValueAxis.MajorUnit = 25
'O eixo de Categoria(X) cruza no valor máximo.
chart.ValueAxis.CrossType = CrossType.Maximum
'Definindo o número de categorias ou séries entre os rótulos de marcas.
chart.CategoryAxis.TickLabelSpacing = 2
'Savando o arquivo Excel
workbook.Save("book1.xlsx")
Propriedades
Área
Obtém a Aspose.Cells.Charts.Axis.Area.
public Area Area { get; }
Valor da Propriedade
EixoEntreCategorias
Representa se o eixo de valor cruza o eixo de categoria entre categorias.
public bool AxisBetweenCategories { get; set; }
Valor da Propriedade
Observações
Esta propriedade se aplica apenas a eixos de categoria e não se aplica a gráficos 3-D.
LinhaDoEixo
Obtém a aparência de um Eixo.
public Line AxisLine { get; }
Valor da Propriedade
EscalaDaUnidadeBase
Representa a escala da unidade base para o eixo de categoria.
public TimeUnit BaseUnitScale { get; set; }
Valor da Propriedade
Observações
Definir esta propriedade só tem efeito quando a propriedade CategoryType está definida como TimeScale.
Grupos
Representa grupos em um eixo de gráfico (Histograma/Pareto)
public AxisBins Bins { get; }
Valor da Propriedade
TipoDeCategoria
Representa o tipo de eixo de categoria.
public CategoryType CategoryType { get; set; }
Valor da Propriedade
CruzarEm
Representa o ponto no eixo de valor onde o eixo de categoria o cruza.
public double CrossAt { get; set; }
Valor da Propriedade
Observações
O número deve ser um inteiro quando se aplica ao eixo de categoria. E o valor deve estar entre 1 e 31999.
TipoDeCruzamento
Representa o Aspose.Cells.Charts.Axis.CrossType no eixo especificado onde o outro eixo cruza.
public CrossType CrossType { get; set; }
Valor da Propriedade
UnidadeDeExibiçãoPersonalizada
Especifica um valor personalizado para a unidade de exibição.
public double CustomDisplayUnit { get; set; }
Valor da Propriedade
UnidadeDeExibição
Representa o rótulo da unidade para o eixo especificado.
public DisplayUnitType DisplayUnit { get; set; }
Valor da Propriedade
RótuloDaUnidadeDeExibição
Representa um rótulo de unidade em um eixo no gráfico especificado. Os rótulos de unidade são úteis para gráficos de grandes valores— por exemplo, em milhões ou bilhões.
public DisplayUnitLabel DisplayUnitLabel { get; }
Valor da Propriedade
TemRótulosMultinível
Indica se os rótulos devem ser exibidos como multinível.
public bool HasMultiLevelLabels { get; set; }
Valor da Propriedade
Observações
Válido apenas para eixo de categoria.
ÉEspaçamentoDeRótuloDeMarcaçãoAutomático
Indica se o espaçamento do rótulo de marcação é automático
public bool IsAutoTickLabelSpacing { get; set; }
Valor da Propriedade
ÉUnidadeMaiorAutomática
Indica se a unidade maior do eixo é atribuída automaticamente.
public bool IsAutomaticMajorUnit { get; set; }
Valor da Propriedade
ÉValorMáximoAutomático
Indica se o valor máximo é atribuído automaticamente.
public bool IsAutomaticMaxValue { get; set; }
Valor da Propriedade
ÉValorMínimoAutomático
Indica se o valor mínimo é atribuído automaticamente.
public bool IsAutomaticMinValue { get; set; }
Valor da Propriedade
ÉUnidadeMenorAutomática
Indica se a unidade menor do eixo é atribuída automaticamente.
public bool IsAutomaticMinorUnit { get; set; }
Valor da Propriedade
ÉRótuloDaUnidadeDeExibiçãoMostrado
Representa se o rótulo da unidade de exibição é mostrado no eixo especificado.
public bool IsDisplayUnitLabelShown { get; set; }
Valor da Propriedade
Observações
O valor padrão é Verdadeiro.
ÉLogarítmico
Representa se o tipo de escala do eixo de valor é logarítmico ou não.
public bool IsLogarithmic { get; set; }
Valor da Propriedade
ÉOrdemDePlotagemInvertida
Representa se o Microsoft Excel plota os pontos de dados do último para o primeiro.
public bool IsPlotOrderReversed { get; set; }
Valor da Propriedade
ÉVisível
Representa se o eixo é visível.
public bool IsVisible { get; set; }
Valor da Propriedade
BaseLogarítmica
Representa a base logarítmica. O valor padrão é 10. Aplica-se apenas ao Excel2007.
public double LogBase { get; set; }
Valor da Propriedade
LinhasDeGradePrincipais
Representa linhas de grade principais em um eixo de gráfico.
public Line MajorGridLines { get; }
Valor da Propriedade
Exemplos
chart.ValueAxis.MajorGridLines.IsVisible = false;
chart.CategoryAxis.MajorGridLines.IsVisible = true;
chart.ValueAxis.MajorGridLines.IsVisible = false
chart.CategoryAxis.MajorGridLines.IsVisible = true
MarcaDeTickMaior
Representa o tipo de marca de tick maior para o eixo especificado.
public TickMarkType MajorTickMark { get; set; }
Valor da Propriedade
UnidadeMaior
Representa as unidades maiores para o eixo.
public double MajorUnit { get; set; }
Valor da Propriedade
Observações
As unidades maiores devem ser maiores que zero.
EscalaDaUnidadeMaior
Representa a escala da unidade maior para o eixo de categoria.
public TimeUnit MajorUnitScale { get; set; }
Valor da Propriedade
Exemplos
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 o valor máximo no eixo de valores.
public object MaxValue { get; set; }
Valor da Propriedade
Observações
O tipo maxValue pode ser apenas double ou DateTime
ValorMínimo
Representa o valor mínimo no eixo de valores.
public object MinValue { get; set; }
Valor da Propriedade
Observações
O tipo minValue pode ser apenas double ou DateTime
LinhasDeGradeMenores
Representa linhas de grade menores em um eixo de gráfico.
public Line MinorGridLines { get; }
Valor da Propriedade
MarcaDeTickMenor
Representa o tipo de marca de tick menor para o eixo especificado.
public TickMarkType MinorTickMark { get; set; }
Valor da Propriedade
UnidadeMenor
Representa as unidades menores para o eixo.
public double MinorUnit { get; set; }
Valor da Propriedade
Observações
As unidades menores devem ser maiores que zero.
EscalaDaUnidadeMenor
Representa a escala da unidade menor para o eixo de categoria.
public TimeUnit MinorUnitScale { get; set; }
Valor da Propriedade
Exemplos
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
PosiçãoDoRótuloDeTick
Representa a posição dos rótulos de marcas no eixo especificado.
public TickLabelPositionType TickLabelPosition { get; set; }
Valor da Propriedade
EspaçamentoDoRótuloDeTick
Representa o número de categorias ou séries entre os rótulos de marcas. Aplica-se apenas a eixos de categoria e séries.
public int TickLabelSpacing { get; set; }
Valor da Propriedade
Observações
O número deve estar entre 1 e 31999.
RótulosDeTick
Retorna um objeto Aspose.Cells.Charts.Axis.TickLabels que representa os rótulos de marcas para o eixo especificado.
public TickLabels TickLabels { get; }
Valor da Propriedade
EspaçamentoDaMarcaDeTick
Retorna ou define o número de categorias ou séries entre as marcas de tick. Aplica-se apenas a eixos de categoria e séries.
public int TickMarkSpacing { get; set; }
Valor da Propriedade
Observações
O número deve estar entre 1 e 31999.
Título
Obtém o título do eixo.
public Title Title { get; }
Valor da Propriedade
Métodos
GetAxisTexts()
Obtém os rótulos do eixo após chamar o método Chart.Calculate().
public string[] GetAxisTexts()
Retorna
string[]