Class ChartPoint

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

Representa un único punto en una serie en un gráfico.

public class ChartPoint

Herencia

object ← ChartPoint

Miembros heredados

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

Ejemplos


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

//Obteniendo la referencia de la primera hoja de trabajo
Worksheet worksheet = workbook.Worksheets[0];

//Agregando un valor de ejemplo a la celda "A1"
worksheet.Cells["A1"].PutValue(50);

//Agregando un valor de ejemplo a la celda "A2"
worksheet.Cells["A2"].PutValue(100);

//Agregando un valor de ejemplo a la celda "A3"
worksheet.Cells["A3"].PutValue(150);

//Agregando un valor de ejemplo a la celda "B1"
worksheet.Cells["B1"].PutValue(60);

//Agregando un valor de ejemplo a la celda "B2"
worksheet.Cells["B2"].PutValue(32);

//Agregando un valor de ejemplo a la celda "B3"
worksheet.Cells["B3"].PutValue(50);

//Agregando un gráfico a la hoja de trabajo
int chartIndex = worksheet.Charts.Add(ChartType.PieExploded, 5, 0, 25, 10);

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

//Mostrar etiquetas de datos 
chart.NSeries[0].DataLabels.ShowValue = true;

for (int i = 0; i  &lt; chart.NSeries[0].Points.Count; i++)
{
    //Obtener punto de datos
    ChartPoint point = chart.NSeries[0].Points[i];
    //Establecer explosión
    point.Explosion = 15;
    //Establecer color del borde
    point.Border.Color = System.Drawing.Color.Red;
}

//Guardar el archivo de Excel
workbook.Save("book1.xls");

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

'Obteniendo la referencia de la primera hoja de trabajo
Dim worksheet As Worksheet = workbook.Worksheets(0)

'Agregando un valor de ejemplo a la celda "A1"
worksheet.Cells("A1").PutValue(50)

'Agregando un valor de ejemplo a la celda "A2"
worksheet.Cells("A2").PutValue(100)

'Agregando un valor de ejemplo a la celda "A3"
worksheet.Cells("A3").PutValue(150)

'Agregando un valor de ejemplo a la celda "B1"
worksheet.Cells("B1").PutValue(60)

'Agregando un valor de ejemplo a la celda "B2"
worksheet.Cells("B2").PutValue(32)

'Agregando un valor de ejemplo a la celda "B3"
worksheet.Cells("B3").PutValue(50)

'Agregando un gráfico a la hoja de trabajo
Dim chartIndex As Integer = worksheet.Charts.Add(ChartType.PieExploded, 5, 0, 25, 10)

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

'Mostrar etiquetas de datos 
chart.NSeries(0).DataLabels.IsValueShown = True

For i As Integer = 0 To chart.NSeries(0).Points.Count - 1
    'Obtener punto de datos
    Dim point As ChartPoint = chart.NSeries(0).Points(i)
    'Establecer explosión
    point.Explosion = 15
    'Establecer color del borde
    point.Border.Color = System.Drawing.Color.Red
Next i

'Guardar el archivo de Excel
workbook.Save("book1.xls")

Propiedades

ArcEndPointXPx

Obtiene la coordenada x del punto final para la sección del pastel después de llamar al método Chart.Calculate(). Aplica a gráficos de pastel y dona.

public float ArcEndPointXPx { get; }

Valor de propiedad

float

ArcEndPointYPx

Obtiene la coordenada y del punto final para la sección del pastel después de llamar al método Chart.Calculate(). Aplica a gráficos de pastel y dona.

public float ArcEndPointYPx { get; }

Valor de propiedad

float

ArcStartPointXPx

Obtiene la coordenada x del punto de inicio para la sección del pastel después de llamar al método Chart.Calculate(). Aplica a gráficos de pastel y dona.

public float ArcStartPointXPx { get; }

Valor de propiedad

float

ArcStartPointYPx

Obtiene la coordenada y del punto de inicio para la sección del pastel después de llamar al método Chart.Calculate(). Aplica a gráficos de pastel y dona.

public float ArcStartPointYPx { get; }

Valor de propiedad

float

Area

Obtiene el Aspose.Cells.Charts.ChartPoint.Area?text=+área.

public Area Area { get; }

Valor de propiedad

Area

Border

Obtiene el Aspose.Cells.Drawing.Line?text=+borde.

public Line Border { get; }

Valor de propiedad

Line

BorderWidthPx

Obtiene el ancho del borde en unidades de píxeles después de llamar al método Chart.Calculate().

public int BorderWidthPx { get; }

Valor de propiedad

int

DataLabels

Devuelve un objeto Aspose.Cells.Charts.ChartPoint.DataLabels que representa la etiqueta de datos asociada con este punto de gráfico.

public DataLabels DataLabels { get; }

Valor de propiedad

DataLabels

DoughnutInnerRadius

Obtiene el radio interno de la porción de dona en unidades de píxeles después de llamar al método Chart.Calculate(). Aplica a gráficos de dona.

public int DoughnutInnerRadius { get; }

Valor de propiedad

int

EndAngle

Obtiene el ángulo final para la sección del pastel, medido en grados en sentido horario desde el eje x después de llamar al método Chart.Calculate(). Aplica a gráficos de pastel.

public float EndAngle { get; }

Valor de propiedad

float

Explosion

La distancia de una porción de pastel abierta desde el centro del gráfico de pastel se expresa como un porcentaje del diámetro del pastel.

public int Explosion { get; set; }

Valor de propiedad

int

InnerArcEndPointXPx

Obtiene la coordenada x del punto final para la sección del pastel después de llamar al método Chart.Calculate(). Aplica a gráficos de dona.

public float InnerArcEndPointXPx { get; }

Valor de propiedad

float

InnerArcEndPointYPx

Obtiene la coordenada y del punto final para la sección del pastel después de llamar al método Chart.Calculate(). Aplica a gráficos de dona.

public float InnerArcEndPointYPx { get; }

Valor de propiedad

float

InnerArcStartPointXPx

Obtiene la coordenada x del punto de inicio para la sección del pastel después de llamar al método Chart.Calculate(). Aplica a gráficos de dona.

public float InnerArcStartPointXPx { get; }

Valor de propiedad

float

InnerArcStartPointYPx

Obtiene la coordenada y del punto de inicio para la sección del pastel después de llamar al método Chart.Calculate(). Aplica a gráficos de dona.

public float InnerArcStartPointYPx { get; }

Valor de propiedad

float

IsInSecondaryPlot

Obtiene o establece un valor que indica si este punto de datos está en el segundo pastel o barra en un gráfico de pastel de pastel o barra de pastel.

public bool IsInSecondaryPlot { get; set; }

Valor de propiedad

bool

Marker

Obtiene el Aspose.Cells.Charts.ChartPoint.Marker?text=+marcador.

public Marker Marker { get; }

Valor de propiedad

Marker

RadiusPx

Obtiene el radio de burbuja, pastel o dona en unidades de píxeles después de llamar al método Chart.Calculate().

public int RadiusPx { get; }

Valor de propiedad

int

Shadow

Verdadero si el punto del gráfico tiene sombra.

public bool Shadow { get; set; }

Valor de propiedad

bool

ShapeHeight

Obtiene la altura en unidades de 1/4000 de la altura del gráfico después de llamar al método Chart.Calculate().

public int ShapeHeight { get; }

Valor de propiedad

int

ShapeHeightPx

Obtiene la altura en unidades de píxeles después de llamar al método Chart.Calculate().

public int ShapeHeightPx { get; }

Valor de propiedad

int

ShapeProperties

Obtiene el objeto Aspose.Cells.Drawing.ShapePropertyCollection que contiene las propiedades visuales de forma del ChartPoint.

public ShapePropertyCollection ShapeProperties { get; }

Valor de propiedad

ShapePropertyCollection

ShapeWidth

Obtiene el ancho en unidades de 1/4000 del ancho del gráfico después de llamar al método Chart.Calculate().

public int ShapeWidth { get; }

Valor de propiedad

int

ShapeWidthPx

Obtiene el ancho en unidades de píxeles después de llamar al método Chart.Calculate().

public int ShapeWidthPx { get; }

Valor de propiedad

int

ShapeX

Obtiene la coordenada x de la esquina superior izquierda en unidades de 1/4000 del ancho del gráfico después de llamar al método Chart.Calculate().

public int ShapeX { get; }

Valor de propiedad

int

ShapeXPx

Obtiene la coordenada x de la esquina superior izquierda en unidades de píxeles después de llamar al método Chart.Calculate().

public int ShapeXPx { get; }

Valor de propiedad

int

ShapeY

Obtiene la coordenada y de la esquina superior izquierda en unidades de 1/4000 de la altura del gráfico después de llamar al método Chart.Calculate().

public int ShapeY { get; }

Valor de propiedad

int

ShapeYPx

Obtiene la coordenada y de la esquina superior izquierda en unidades de píxeles después de llamar al método Chart.Calculate().

public int ShapeYPx { get; }

Valor de propiedad

int

StartAngle

Obtiene el ángulo de inicio para la sección del pastel, medido en grados en sentido horario desde el eje x después de llamar al método Chart.Calculate(). Aplica a gráficos de pastel.

public float StartAngle { get; }

Valor de propiedad

float

XValue

Obtiene o establece el valor X del punto del gráfico.

public object XValue { get; set; }

Valor de propiedad

object

XValueType

Obtiene el tipo de valor X del punto del gráfico.

public CellValueType XValueType { get; }

Valor de propiedad

CellValueType

YValue

Obtiene o establece el valor Y del punto del gráfico.

public object YValue { get; set; }

Valor de propiedad

object

YValueType

Obtiene el tipo de valor Y del punto del gráfico.

public CellValueType YValueType { get; }

Valor de propiedad

CellValueType

Métodos

GetBottomPointCount()

Obtiene el número de puntos inferiores después de llamar al método Chart.Calculate().

public int GetBottomPointCount()

Devuelve

int

GetBottomPointXPx(int)

Obtiene la coordenada x del punto inferior de la forma después de llamar al método Chart.Calculate(). Aplica gráficos 3D: Column3D, Bar3D, Cone, Cylinder, Pyramid.

public float GetBottomPointXPx(int index)

Parámetros

index int

Devuelve

float

GetBottomPointYPx(int)

Obtiene la coordenada y del punto inferior de la forma después de llamar al método Chart.Calculate(). Aplica gráficos 3D: Column3D, Bar3D, Cone, Cylinder, Pyramid.

public float GetBottomPointYPx(int index)

Parámetros

index int

Devuelve

float

GetOnCategoryAxisPointCount()

Obtiene el número de puntos en el eje de categorías después de llamar al método Chart.Calculate(). Solo se aplica a gráficos de área.

public int GetOnCategoryAxisPointCount()

Devuelve

int

Observaciones

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

GetOnCategoryAxisPointXPx(int)

Obtiene la coordenada x del punto en el eje de categorías después de llamar al método Chart.Calculate(). Solo se aplica a gráficos de área.

public float GetOnCategoryAxisPointXPx(int index)

Parámetros

index int

Devuelve

float

Observaciones

Gráfico de área 2D: el índice es 0.
Gráfico de área 3D: el índice es 0 o 1.

GetOnCategoryAxisPointYPx(int)

Obtiene la coordenada y del punto en el eje de categorías después de llamar al método Chart.Calculate(). Solo se aplica a gráficos de área.

public float GetOnCategoryAxisPointYPx(int index)

Parámetros

index int

Devuelve

float

Observaciones

Gráfico de área 2D: el índice es 0.
Gráfico de área 3D: el índice es 0 o 1.

GetTopPointCount()

Obtiene el número de puntos superiores después de llamar al método Chart.Calculate().

public int GetTopPointCount()

Devuelve

int

GetTopPointXPx(int)

Obtiene la coordenada x del punto superior de la forma después de llamar al método Chart.Calculate(). Aplica gráficos 3D: Column3D, Bar3D, Cone, Cylinder, Pyramid y Area3D.

public float GetTopPointXPx(int index)

Parámetros

index int

Devuelve

float

GetTopPointYPx(int)

Obtiene la coordenada y del punto superior de la forma después de llamar al método Chart.Calculate(). Aplica gráficos 3D: Column3D, Bar3D, Cone, Cylinder, Pyramid y Area3D.

public float GetTopPointYPx(int index)

Parámetros

index int

Devuelve

float