Chart clase

Chart clase

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

El tipo Chart expone los siguientes miembros:

Propiedades

PropiedadDescripción
styleObtiene y establece el estilo integrado.
chart_objectRepresenta la forma del gráfico;
hide_pivot_field_buttonsIndica si se ocultan los botones del campo del gráfico dinámico solo cuando el gráfico es un gráfico dinámico.
pivot_optionsEspecifica los controles dinámicos que aparecen en el gráfico.
pivot_sourceLa fuente son los datos de la tabla dinámica.
Si PivotSource no está vacío, el gráfico es PivotChart.
plot_byObtiene y establece si se traza por fila o columna.
plot_empty_cells_typeObtiene y establece cómo trazar las celdas vacías.
plot_visible_cellsIndica si solo se trazan las celdas visibles.
plot_visible_cells_onlyIndica si se trazan únicamente las celdas visibles.
display_na_as_blankIndica si se muestra #N/A como valor en blanco.
nameObtiene y establece el nombre del gráfico.
size_with_windowVerdadero 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.
worksheetObtiene la hoja de trabajo que contiene este gráfico.
shapesDevuelve todas las formas de dibujo en este gráfico.
print_sizeObtiene y establece el tamaño del gráfico impreso.
typeObtiene o establece el tipo de gráfico.
n_seriesObtiene una colección SeriesCollection que representa la serie de datos del gráfico.
filtered_n_seriesObtiene una colección SeriesCollection que representa las series de datos que se filtran en el gráfico.
titleObtiene el título del gráfico.
sub_titleObtiene el subtítulo del gráfico.
Sólo para archivos con formato ODS.
plot_areaObtiene el área de trazado del gráfico que incluye etiquetas de marcas de eje.
chart_areaObtiene el área del gráfico en la hoja de cálculo.
category_axisObtiene el eje X del gráfico.
value_axisObtiene el eje Y del gráfico.
second_value_axisObtiene el segundo eje Y del gráfico.
second_category_axisObtiene el segundo eje X del gráfico.
series_axisObtiene el eje de la serie del gráfico.
legendObtiene la leyenda del gráfico.
chart_data_tableRepresenta la tabla de datos del gráfico.
show_legendObtiene o establece un valor que indica si se mostrará la leyenda del gráfico. El valor predeterminado es verdadero.
is_rectangular_corneredObtiene o establece un valor que indica si el área del gráfico tiene esquinas rectangulares.
El valor predeterminado es verdadero.
show_data_tableObtiene o establece un valor que indica si el gráfico muestra una tabla de datos.
first_slice_angleObtiene o establece el ángulo del primer gráfico circular o de anillos, en grados (en el sentido de las agujas del reloj desde la vertical).
Se aplica solo a gráficos circulares, circulares 3D y de anillos, de 0 a 360.
gap_widthDevuelve 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.
gap_depthObtiene o establece la distancia entre las series de datos en un gráfico 3D, como porcentaje del ancho del marcador.
El valor de esta propiedad debe estar entre 0 y 500.
floorDevuelve un objeto Chart.floor que representa las paredes de un gráfico 3D.
wallsDevuelve un objeto Chart.walls que representa las paredes de un gráfico 3D.
back_wallDevuelve un objeto Chart.walls que representa la pared posterior de un gráfico 3D.
side_wallDevuelve un objeto Chart.walls que representa la pared lateral de un gráfico 3D.
walls_and_gridlines_2dVerdadero si las líneas de cuadrícula se dibujan en dos dimensiones en un gráfico 3D.
rotation_angleRepresenta la rotación de la vista del gráfico 3D (la rotación del área de trazado alrededor del eje z, en grados).
elevationRepresenta la elevación de la vista del gráfico 3D, en grados.
right_angle_axesVerdadero si los ejes del gráfico están en ángulo recto. Se aplica solo a gráficos 3D (excepto gráficos circulares 3D y columnas 3D).
auto_scalingVerdadero 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.
height_percentDevuelve o establece la altura de un gráfico 3D como porcentaje del ancho del gráfico (entre 5 y 500 por ciento).
perspectiveDevuelve o establece la perspectiva de la vista del gráfico 3D. Debe estar entre 0 y 100.
Esta propiedad se ignora si la propiedad RightAngleAxes es True.
is_3dIndica si el gráfico es un gráfico 3D.
depth_percentRepresenta la profundidad de un gráfico 3D como porcentaje del ancho del gráfico (entre 20 y 2000 por ciento).
actual_chart_sizeObtiene el tamaño real del gráfico en unidades de píxeles.
placementRepresenta la forma en que el gráfico se adjunta a las celdas debajo de él.
page_setupRepresenta la descripción de configuración de página en este gráfico.
lineObtiene la línea.

Métodos

MétodoDescripción
calculateCalcula la posición personalizada del área de trazado, ejes si la posición de ellos está asignada automáticamente.
calculateCalcula la posición personalizada del área de trazado, los ejes si la posición de ellos está asignada automáticamente, con Opciones de cálculo de gráfico.
to_imageCrea la imagen del gráfico y la guarda en un archivo.
La extensión del nombre del archivo determina el formato de la imagen.
to_imageCrea la imagen del gráfico y la guarda en un archivo del tipo de imagen especificado.
to_imageCrea la imagen del gráfico y la guarda en un archivo en formato Jpeg.
to_imageCrea la imagen del gráfico y la guarda en una secuencia en formato Jpeg.
to_imageCrea la imagen del gráfico y la guarda en una secuencia en el formato especificado.
to_imageCrea la imagen del gráfico y la guarda en un archivo.
La extensión del nombre del archivo determina el formato de la imagen.
to_imageCrea la imagen del gráfico y la guarda en una secuencia en el formato especificado.
to_pdfGuarda el gráfico en un archivo pdf.
to_pdfGuarda el gráfico en un archivo pdf.
to_pdfCrea el gráfico en formato PDF y lo guarda en una secuencia.
to_pdfCrea el gráfico en formato PDF y lo guarda en una secuencia.
is_refered_by_chartDevuelve si la celda a la que hace referencia el gráfico.
is_cell_refered_by_chartDevuelve si la celda a la que hace referencia el gráfico.
is_chart_data_changedDetecta si la fuente de datos de un gráfico ha cambiado.
refresh_pivot_dataActualiza los datos del gráfico dinámico desde su fuente de datos dinámicos.
change_templateCambie el tipo de gráfico con una plantilla preestablecida.
moveMueve el gráfico a una ubicación especificada.
get_actual_sizeObtiene el tamaño real del gráfico en unidades de píxeles.
has_axisDevuelve qué ejes existen en el gráfico.
switch_row_columnCambia de fila/columna.
get_chart_data_rangeObtiene el rango de origen de datos del gráfico.
set_chart_data_rangeEspecifica el rango de datos para un gráfico.

Ejemplo

Los siguientes códigos muestran cómo crear un gráfico con códigos .Net.

from aspose.cells import Workbook
from aspose.cells.charts import ChartType

workbook = Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells
cells.get(0, 1).put_value("Income")
cells.get(1, 0).put_value("Company A")
cells.get(2, 0).put_value("Company B")
cells.get(3, 0).put_value("Company C")
cells.get(1, 1).put_value(10000)
cells.get(2, 1).put_value(20000)
cells.get(3, 1).put_value(30000)
chartIndex = sheet.charts.add(ChartType.COLUMN, 9, 9, 21, 15)
chart = sheet.charts[chartIndex]
chart.set_chart_data_range("A1:B4", True)
chart.show_legend = True
chart.title.text = "Income Analysis"

Ver también