Class ChartPointCollection

Class ChartPointCollection

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

Representa uma coleção que contém todos os pontos em uma série.

public class ChartPointCollection

Herança

objectChartPointCollection

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 da célula "A1" à "B3"
chart.NSeries.Add("A1:B3", true);

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

ChartPointCollection points = chart.NSeries[0].Points;

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

//Salvar 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 da célula "A1" à "B3"
chart.NSeries.Add("A1:B3", True)

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

Dim points As ChartPointCollection = chart.NSeries(0).Points

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

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

Propriedades

Count

Obtém a contagem dos pontos do gráfico.

public int Count { get; }

Valor da Propriedade

int

this[int]

Obtém o elemento Aspose.Cells.Charts.ChartPoint no índice especificado na série.

public ChartPoint this[int index] { get; }

Valor da Propriedade

ChartPoint

Métodos

Clear()

Remove todas as configurações dos pontos do gráfico.

public void Clear()

GetEnumerator()

Retorna um enumerador para toda a Aspose.Cells.Charts.ChartPointCollection.

public IEnumerator GetEnumerator()

Retorna

IEnumerator

RemoveAt(int)

Remove o ponto no índice da série.

public void RemoveAt(int index)

Parâmetros

index int

O índice do ponto.

 Português