Chart

Chart class

Encapsula el objeto que representa un único gráfico de Excel.

public class Chart

Propiedades

NombreDescripción
AutoScaling { get; set; }Verdadero si Microsoft Excel escala un gráfico 3D para que tenga un tamaño más cercano al gráfico 2D equivalente. La propiedad RightAngleAxes debe ser True.
BackWall { get; }Devuelve unWalls objeto que representa la pared trasera de un gráfico 3-D.
CategoryAxis { get; }Obtiene el eje X del gráfico.
ChartArea { get; }Obtiene el área del gráfico en la hoja de cálculo.
ChartDataTable { get; }Representa la tabla de datos del gráfico.
ChartObject { get; }Representa la forma del gráfico;
DepthPercent { get; set; }Representa la profundidad de un gráfico 3D como un porcentaje del ancho del gráfico (entre 20 y 2000 por ciento).
DisplayNaAsBlank { get; set; }Indica si se muestra #N/A como valor en blanco.
Elevation { get; set; }Representa la elevación de la vista de carta 3D, en grados.
FirstSliceAngle { get; set; }Obtiene o establece el ángulo del primer sector del gráfico circular o del gráfico de anillos, en grados (en el sentido de las agujas del reloj desde la vertical). Solo se aplica a gráficos circulares, circulares 3D y de anillos, de 0 a 360.
Floor { get; }Devuelve unFloor objeto que representa las paredes de un gráfico 3-D.
GapDepth { get; set; }Obtiene o establece la distancia entre las series de datos en un gráfico 3D, como un porcentaje del ancho del marcador. El valor de esta propiedad debe estar entre 0 y 500.
GapWidth { get; set; }Devuelve o establece el espacio entre grupos de barras o columnas, como porcentaje del ancho de la barra o columna. El valor de esta propiedad debe estar entre 0 y 500.
HeightPercent { get; set; }Devuelve o establece la altura de un gráfico 3D como un porcentaje del ancho del gráfico (entre 5 y 500 por ciento).
HidePivotFieldButtons { get; set; }Indica si ocultar los botones de campo del gráfico dinámico solo cuando el gráfico es PivotChart.
Is3D { get; }Indica si el gráfico es un gráfico 3D.
IsRectangularCornered { get; set; }Obtiene o establece un valor que indica si el área del gráfico tiene esquinas rectangulares. El valor predeterminado es verdadero.
Legend { get; }Obtiene la leyenda del gráfico.
Line { get; }Obtiene la línea.
Name { get; set; }Obtiene y establece el nombre del gráfico.
NSeries { get; }Obtiene unSeriesCollection colección que representa la serie de datos en el gráfico.
PageSetup { get; }Representa la descripción de configuración de página en este gráfico.
Perspective { get; set; }Devuelve o establece la perspectiva de la vista de gráfico 3D. Debe estar entre 0 y 100. Esta propiedad se ignora si la propiedad RightAngleAxes es True.
PivotOptions { get; }Especifica los controles de pivote que aparecen en el gráfico
PivotSource { get; set; }El origen son los datos de la tabla dinámica. Si PivotSource no está vacío, el gráfico es PivotChart.
Placement { get; set; }Representa la forma en que el gráfico se adjunta a las celdas debajo de él.
PlotArea { get; }Obtiene el área de trazado del gráfico que incluye etiquetas de marca de eje.
PlotBy { get; }Obtiene y establece si se traza por fila o columna.
PlotEmptyCellsType { get; set; }Obtiene y establece cómo trazar las celdas vacías.
PlotVisibleCells { get; set; }Indica si solo se trazan celdas visibles.
PrintSize { get; set; }Obtiene y establece el tamaño del gráfico impreso.
RightAngleAxes { get; set; }Verdadero si los ejes del gráfico están en ángulo recto. Solo se aplica a gráficos 3D (excepto Column3D y gráficos circulares 3D).
RotationAngle { get; set; }Representa la rotación de la vista de gráfico 3D (la rotación del área de trazado alrededor del eje z, en grados).
SecondCategoryAxis { get; }Obtiene el segundo eje X del gráfico.
SecondValueAxis { get; }Obtiene el segundo eje Y del gráfico.
SeriesAxis { get; }Obtiene el eje de serie del gráfico.
Shapes { get; }Devuelve todas las formas de dibujo en este gráfico.
ShowDataTable { get; set; }Obtiene o establece un valor que indica si el gráfico muestra una tabla de datos.
ShowLegend { get; set; }Obtiene o establece un valor que indica si se mostrará la leyenda del gráfico. El valor predeterminado es verdadero.
SideWall { get; }Devuelve unWallsobjeto que representa la pared lateral de un gráfico 3-D.
SizeWithWindow { get; set; }Verdadero si Microsoft Excel cambia el tamaño del gráfico para que coincida con el tamaño de la ventana de la hoja del gráfico.
Style { get; set; }Obtiene y establece el estilo integrado.
SubTitle { get; }Obtiene el subtítulo del gráfico. Solo para archivos con formato ODS.
Title { get; }Obtiene el título del gráfico.
Type { get; set; }Obtiene o establece el tipo de gráfico.
ValueAxis { get; }Obtiene el eje Y del gráfico.
Walls { get; }Devuelve unWalls objeto que representa las paredes de un gráfico 3-D.
WallsAndGridlines2D { get; set; }Verdadero si las líneas de cuadrícula se dibujan bidimensionalmente en un gráfico tridimensional.
Worksheet { get; }Obtiene la hoja de cálculo que contiene este gráfico.

Métodos

NombreDescripción
Calculate()Calcula la posición personalizada del área de trazado, ejes si la posición de ellos se asigna automáticamente.
GetActualSize()Obtiene el tamaño real del gráfico en unidades de píxeles.
GetChartDataRange()Obtiene el rango de origen de datos del gráfico.
HasAxis(AxisType, bool)Devuelve qué ejes existen en el gráfico.
IsChartDataChanged()Detecta si la fuente de datos de un gráfico ha cambiado.
Move(int, int, int, int)Mueve el gráfico a una ubicación específica.
RefreshPivotData()Actualiza los datos del gráfico dinámico desde su origen de datos dinámicos.
SetChartDataRange(string, bool)Especifica el rango de datos para un gráfico.
SwitchRowColumn()Cambia fila/columna.
ToImage()Obtiene una de 32 bitsmapa de bits objeto del gráfico.
ToImage(ImageOrPrintOptions)Obtiene una de 32 bitsmapa de bits objeto del gráfico. ImageOrPrintOptions.ImageFormat , los atributos ImageOrPrintOptions.TiffCompression e ImageOrPrintOptions.Quality se ignoran.
ToImage(string)Crea la imagen del gráfico y la guarda en un archivo. La extensión del nombre del archivo determina el formato de la imagen.
ToImage(Stream, ImageOrPrintOptions)Crea la imagen del gráfico y la guarda en una secuencia en el formato especificado.
ToImage(Stream, ImageType)Crea la imagen del gráfico y la guarda en una secuencia en el formato especificado.
ToImage(Stream, long)Crea la imagen del gráfico y la guarda en una secuencia en formato Jpeg.
ToImage(string, ImageOrPrintOptions)Crea la imagen del gráfico y la guarda en un archivo. La extensión del nombre del archivo determina el formato de la imagen.
ToImage(string, ImageType)Crea la imagen del gráfico y la guarda en un archivo con el tipo de imagen especificado.
ToImage(string, long)Crea la imagen del gráfico y la guarda en un archivo en formato Jpeg.
ToPdf(Stream)Crea el pdf del gráfico y lo guarda en una secuencia.
ToPdf(string)Guarda el gráfico en un archivo pdf.
ToPdf(Stream, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)Crea el pdf del gráfico y lo guarda en una secuencia.
ToPdf(string, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)Guarda el gráfico en un archivo pdf.

Ejemplos

[C#]

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

Cells cells = sheet.Cells;
cells[0,1].PutValue("Income");
cells[1,0].PutValue("Company A");
cells[2,0].PutValue("Company B");
cells[3,0].PutValue("Company C");
cells[1,1].PutValue(10000);
cells[2,1].PutValue(20000);
cells[3,1].PutValue(30000);
		
int chartIndex = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15);

Chart chart = sheet.Charts[chartIndex];
chart.SetChartDataRange("A1:B4", true);
chart.ShowLegend = true;
chart.Title.Text = "Income Analysis";

[Visual Basic]

Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)

Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("Income")
cells(1,0).PutValue("Company A")
cells(2,0).PutValue("Company B")
cells(3,0).PutValue("Company C")
cells(1,1).PutValue(10000)
cells(2,1).PutValue(20000)
cells(3,1).PutValue(30000)
		
Dim chartIndex as Integer = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15)

Dim chart as Chart = sheet.Charts(chartIndex) 
chart.SetChartDataRange("A1:B4", True);
chart.ShowLegend = True
chart.Title.Text = "Income Analysis"

Ver también