Class Axis

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

objectAxis

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

Area

EixoEntreCategorias

Representa se o eixo de valor cruza o eixo de categoria entre categorias.

public bool AxisBetweenCategories { get; set; }

Valor da Propriedade

bool

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

Line

EscalaDaUnidadeBase

Representa a escala da unidade base para o eixo de categoria.

public TimeUnit BaseUnitScale { get; set; }

Valor da Propriedade

TimeUnit

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

AxisBins

TipoDeCategoria

Representa o tipo de eixo de categoria.

public CategoryType CategoryType { get; set; }

Valor da Propriedade

CategoryType

CruzarEm

Representa o ponto no eixo de valor onde o eixo de categoria o cruza.

public double CrossAt { get; set; }

Valor da Propriedade

double

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

CrossType

UnidadeDeExibiçãoPersonalizada

Especifica um valor personalizado para a unidade de exibição.

public double CustomDisplayUnit { get; set; }

Valor da Propriedade

double

UnidadeDeExibição

Representa o rótulo da unidade para o eixo especificado.

public DisplayUnitType DisplayUnit { get; set; }

Valor da Propriedade

DisplayUnitType

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

DisplayUnitLabel

TemRótulosMultinível

Indica se os rótulos devem ser exibidos como multinível.

public bool HasMultiLevelLabels { get; set; }

Valor da Propriedade

bool

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

bool

ÉUnidadeMaiorAutomática

Indica se a unidade maior do eixo é atribuída automaticamente.

public bool IsAutomaticMajorUnit { get; set; }

Valor da Propriedade

bool

ÉValorMáximoAutomático

Indica se o valor máximo é atribuído automaticamente.

public bool IsAutomaticMaxValue { get; set; }

Valor da Propriedade

bool

ÉValorMínimoAutomático

Indica se o valor mínimo é atribuído automaticamente.

public bool IsAutomaticMinValue { get; set; }

Valor da Propriedade

bool

ÉUnidadeMenorAutomática

Indica se a unidade menor do eixo é atribuída automaticamente.

public bool IsAutomaticMinorUnit { get; set; }

Valor da Propriedade

bool

É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

bool

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

bool

ÉOrdemDePlotagemInvertida

Representa se o Microsoft Excel plota os pontos de dados do último para o primeiro.

public bool IsPlotOrderReversed { get; set; }

Valor da Propriedade

bool

ÉVisível

Representa se o eixo é visível.

public bool IsVisible { get; set; }

Valor da Propriedade

bool

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

double

LinhasDeGradePrincipais

Representa linhas de grade principais em um eixo de gráfico.

public Line MajorGridLines { get; }

Valor da Propriedade

Line

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

TickMarkType

UnidadeMaior

Representa as unidades maiores para o eixo.

public double MajorUnit { get; set; }

Valor da Propriedade

double

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

TimeUnit

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

object

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

object

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

Line

MarcaDeTickMenor

Representa o tipo de marca de tick menor para o eixo especificado.

public TickMarkType MinorTickMark { get; set; }

Valor da Propriedade

TickMarkType

UnidadeMenor

Representa as unidades menores para o eixo.

public double MinorUnit { get; set; }

Valor da Propriedade

double

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

TimeUnit

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

TickLabelPositionType

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

int

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

TickLabels

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

int

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

Title

Métodos

GetAxisTexts()

Obtém os rótulos do eixo após chamar o método Chart.Calculate().

public string[] GetAxisTexts()

Retorna

string[]

 Português