Class ChartPoint

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

Representa um único ponto em uma série em um gráfico.

public class ChartPoint

Herança

object ← ChartPoint

Membros Herdados

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

Exemplos

//Instanciando um objeto Workbook
Workbook workbook = new Workbook();

//Obtendo a referência da primeira planilha
Worksheet worksheet = workbook.Worksheets[0];

//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(60);

//Adicionando um valor de exemplo à célula "B2"
worksheet.Cells["B2"].PutValue(32);

//Adicionando um valor de exemplo à célula "B3"
worksheet.Cells["B3"].PutValue(50);

//Adicionando um gráfico à planilha
int chartIndex = worksheet.Charts.Add(ChartType.PieExploded, 5, 0, 25, 10);

//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);

//Mostrar rótulos de dados 
chart.NSeries[0].DataLabels.ShowValue = true;

for (int i = 0; i < chart.NSeries[0].Points.Count; i++)
{
    //Obter ponto de dados
    ChartPoint point = chart.NSeries[0].Points[i];
    //Definir explosão do gráfico
    point.Explosion = 15;
    //Definir cor da borda
    point.Border.Color = System.Drawing.Color.Red;
}

//Salvando o arquivo Excel
workbook.Save("book1.xls");

'Instanciando um objeto Workbook
Dim workbook As Workbook = New Workbook()

'Obtendo a referência da primeira planilha
Dim worksheet As Worksheet = workbook.Worksheets(0)

'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(60)

'Adicionando um valor de exemplo à célula "B2"
worksheet.Cells("B2").PutValue(32)

'Adicionando um valor de exemplo à célula "B3"
worksheet.Cells("B3").PutValue(50)

'Adicionando um gráfico à planilha
Dim chartIndex As Integer = worksheet.Charts.Add(ChartType.PieExploded, 5, 0, 25, 10)

'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)

'Mostrar rótulos de dados 
chart.NSeries(0).DataLabels.IsValueShown = True

For i As Integer = 0 To chart.NSeries(0).Points.Count - 1
    'Obter ponto de dados
    Dim point As ChartPoint = chart.NSeries(0).Points(i)
    'Definir explosão do gráfico
    point.Explosion = 15
    'Definir cor da borda
    point.Border.Color = System.Drawing.Color.Red
Next i

'Savando o arquivo Excel
workbook.Save("book1.xls")

Propriedades

ArcEndPointXPx

Obtém a coordenada x do ponto final para a seção de pizza após a chamada do método Chart.Calculate(). Aplica-se a gráficos de Pizza e Rosca.

public float ArcEndPointXPx { get; }

Valor da Propriedade

float

ArcEndPointYPx

Obtém a coordenada y do ponto final para a seção de pizza após a chamada do método Chart.Calculate(). Aplica-se a gráficos de Pizza e Rosca.

public float ArcEndPointYPx { get; }

Valor da Propriedade

float

ArcStartPointXPx

Obtém a coordenada x do ponto inicial para a seção de pizza após a chamada do método Chart.Calculate(). Aplica-se a gráficos de Pizza e Rosca.

public float ArcStartPointXPx { get; }

Valor da Propriedade

float

ArcStartPointYPx

Obtém a coordenada y do ponto inicial para a seção de pizza após a chamada do método Chart.Calculate(). Aplica-se a gráficos de Pizza e Rosca.

public float ArcStartPointYPx { get; }

Valor da Propriedade

float

Area

Obtém o Aspose.Cells.Charts.ChartPoint.Area?text=+área.

public Area Area { get; }

Valor da Propriedade

Area

Border

Obtém o Aspose.Cells.Drawing.Line?text=+borda.

public Line Border { get; }

Valor da Propriedade

Line

BorderWidthPx

Obtém a largura da borda em unidades de pixels após a chamada do método Chart.Calculate().

public int BorderWidthPx { get; }

Valor da Propriedade

int

DataLabels

Retorna um objeto Aspose.Cells.Charts.ChartPoint.DataLabels que representa o rótulo de dados associado a este ponto do gráfico.

public DataLabels DataLabels { get; }

Valor da Propriedade

DataLabels

DoughnutInnerRadius

Obtém o raio interno da fatia de rosca em unidades de pixels após a chamada do método Chart.Calculate(). Aplica-se a gráfico de Rosca.

public int DoughnutInnerRadius { get; }

Valor da Propriedade

int

EndAngle

Obtém o ângulo final para a seção de pizza, medido em graus no sentido horário a partir do eixo x após a chamada do método Chart.Calculate(). Aplica-se a gráfico de Pizza.

public float EndAngle { get; }

Valor da Propriedade

float

Explosion

A distância de uma fatia de pizza aberta em relação ao centro do gráfico de pizza é expressa como uma porcentagem do diâmetro da pizza.

public int Explosion { get; set; }

Valor da Propriedade

int

InnerArcEndPointXPx

Obtém a coordenada x do ponto final para a seção de pizza após a chamada do método Chart.Calculate(). Aplica-se a gráfico de Rosca.

public float InnerArcEndPointXPx { get; }

Valor da Propriedade

float

InnerArcEndPointYPx

Obtém a coordenada y do ponto final para a seção de pizza após a chamada do método Chart.Calculate(). Aplica-se a gráfico de Rosca.

public float InnerArcEndPointYPx { get; }

Valor da Propriedade

float

InnerArcStartPointXPx

Obtém a coordenada x do ponto inicial para a seção de pizza após a chamada do método Chart.Calculate(). Aplica-se a gráfico de Rosca.

public float InnerArcStartPointXPx { get; }

Valor da Propriedade

float

InnerArcStartPointYPx

Obtém a coordenada y do ponto inicial para a seção de pizza após a chamada do método Chart.Calculate(). Aplica-se a gráfico de Rosca.

public float InnerArcStartPointYPx { get; }

Valor da Propriedade

float

IsInSecondaryPlot

Obtém ou define um valor que indica se este ponto de dados está no segundo gráfico de pizza ou barra em um gráfico de pizza de pizza ou barra de pizza.

public bool IsInSecondaryPlot { get; set; }

Valor da Propriedade

bool

Marker

Obtém o Aspose.Cells.Charts.ChartPoint.Marker?text=+marcador.

public Marker Marker { get; }

Valor da Propriedade

Marker

RadiusPx

Obtém o raio da bolha, pizza ou rosca em unidades de pixels após a chamada do método Chart.Calculate().

public int RadiusPx { get; }

Valor da Propriedade

int

Shadow

Verdadeiro se o ponto do gráfico tiver uma sombra.

public bool Shadow { get; set; }

Valor da Propriedade

bool

ShapeHeight

Obtém a altura em unidades de 1/4000 da altura do gráfico após a chamada do método Chart.Calculate().

public int ShapeHeight { get; }

Valor da Propriedade

int

ShapeHeightPx

Obtém a altura em unidades de pixels após a chamada do método Chart.Calculate().

public int ShapeHeightPx { get; }

Valor da Propriedade

int

ShapeProperties

Obtém o objeto Aspose.Cells.Drawing.ShapePropertyCollection que contém as propriedades visuais da forma do ChartPoint.

public ShapePropertyCollection ShapeProperties { get; }

Valor da Propriedade

ShapePropertyCollection

ShapeWidth

Obtém a largura em unidades de 1/4000 da largura do gráfico após a chamada do método Chart.Calculate().

public int ShapeWidth { get; }

Valor da Propriedade

int

ShapeWidthPx

Obtém a largura em unidades de pixels após a chamada do método Chart.Calculate().

public int ShapeWidthPx { get; }

Valor da Propriedade

int

ShapeX

Obtém a coordenada x do canto superior esquerdo em unidades de 1/4000 da largura do gráfico após a chamada do método Chart.Calculate().

public int ShapeX { get; }

Valor da Propriedade

int

ShapeXPx

Obtém a coordenada x do canto superior esquerdo em unidades de pixels após a chamada do método Chart.Calculate().

public int ShapeXPx { get; }

Valor da Propriedade

int

ShapeY

Obtém a coordenada y do canto superior esquerdo em unidades de 1/4000 da altura do gráfico após a chamada do método Chart.Calculate().

public int ShapeY { get; }

Valor da Propriedade

int

ShapeYPx

Obtém a coordenada y do canto superior esquerdo em unidades de pixels após a chamada do método Chart.Calculate().

public int ShapeYPx { get; }

Valor da Propriedade

int

StartAngle

Obtém o ângulo inicial para a seção de pizza, medido em graus no sentido horário a partir do eixo x após a chamada do método Chart.Calculate(). Aplica-se a gráfico de Pizza.

public float StartAngle { get; }

Valor da Propriedade

float

XValue

Obtém ou define o valor X do ponto do gráfico.

public object XValue { get; set; }

Valor da Propriedade

object

XValueType

Obtém o tipo de valor X do ponto do gráfico.

public CellValueType XValueType { get; }

Valor da Propriedade

CellValueType

YValue

Obtém ou define o valor Y do ponto do gráfico.

public object YValue { get; set; }

Valor da Propriedade

object

YValueType

Obtém o tipo de valor Y do ponto do gráfico.

public CellValueType YValueType { get; }

Valor da Propriedade

CellValueType

Métodos

GetBottomPointCount()

Obtém o número de pontos inferiores após a chamada do método Chart.Calculate().

public int GetBottomPointCount()

Retorna

int

GetBottomPointXPx(int)

Obtém a coordenada x do ponto inferior da forma após a chamada do método Chart.Calculate(). Aplica-se a gráficos 3D: Column3D, Bar3D, Cone, Cylinder, Pyramid.

public float GetBottomPointXPx(int index)

Parâmetros

index int

Retorna

float

GetBottomPointYPx(int)

Obtém a coordenada y do ponto inferior da forma após a chamada do método Chart.Calculate(). Aplica-se a gráficos 3D: Column3D, Bar3D, Cone, Cylinder, Pyramid.

public float GetBottomPointYPx(int index)

Parâmetros

index int

Retorna

float

GetOnCategoryAxisPointCount()

Obtém o número de pontos no eixo de categorias após a chamada do método Chart.Calculate(). Aplica-se apenas a gráficos de área.

public int GetOnCategoryAxisPointCount()

Retorna

int

Observações

Gráfico de área 2D retorna 1
Gráfico de área 3D retorna 2.

GetOnCategoryAxisPointXPx(int)

Obtém a coordenada x do ponto no eixo de categorias após a chamada do método Chart.Calculate(). Aplica-se apenas a gráficos de área.

public float GetOnCategoryAxisPointXPx(int index)

Parâmetros

index int

Retorna

float

Observações

Gráfico de área 2D: índice é 0.
Gráfico de área 3D: índice é 0 ou 1.

GetOnCategoryAxisPointYPx(int)

Obtém a coordenada y do ponto no eixo de categorias após a chamada do método Chart.Calculate(). Aplica-se apenas a gráficos de área.

public float GetOnCategoryAxisPointYPx(int index)

Parâmetros

index int

Retorna

float

Observações

Gráfico de área 2D: índice é 0.
Gráfico de área 3D: índice é 0 ou 1.

GetTopPointCount()

Obtém o número de pontos superiores após a chamada do método Chart.Calculate().

public int GetTopPointCount()

Retorna

int

GetTopPointXPx(int)

Obtém a coordenada x do ponto superior da forma após a chamada do método Chart.Calculate(). Aplica-se a gráficos 3D: Column3D, Bar3D, Cone, Cylinder, Pyramid e Area3D.

public float GetTopPointXPx(int index)

Parâmetros

index int

Retorna

float

GetTopPointYPx(int)

Obtém a coordenada y do ponto superior da forma após a chamada do método Chart.Calculate(). Aplica-se a gráficos 3D: Column3D, Bar3D, Cone, Cylinder, Pyramid e Area3D.

public float GetTopPointYPx(int index)

Parâmetros

index int

Retorna

float