Chart clase
Chart clase
Encapsula el objeto que representa un solo gráfico de Excel.
El tipo Chart expone los siguientes miembros:
Propiedades
| Propiedad | Descripción |
|---|---|
| style | Obtiene y establece el estilo incorporado. |
| chart_object | Representa la forma del gráfico; |
| hide_pivot_field_buttons | Indica si se ocultan los botones del campo del gráfico dinámico solo cuando el gráfico es un gráfico dinámico. |
| pivot_options | Especifica los controles de pivote que aparecen en el gráfico |
| pivot_source | La fuente son los datos de la tabla dinámica. Si PivotSource no está vacío, el gráfico es PivotChart. |
| plot_by | Obtiene y establece si se grafica por fila o columna. |
| plot_empty_cells_type | Obtiene y establece cómo trazar las celdas vacías. |
| plot_visible_cells | Indica si solo se deben graficar las celdas visibles. |
| plot_visible_cells_only | Indica si se trazan sólo las celdas visibles. |
| display_na_as_blank | Indica si se muestra #N/A como valor en blanco. |
| name | Obtiene y establece el nombre del gráfico. |
| size_with_window | Verdadero si Microsoft Excel redimensiona el gráfico para que coincida con el tamaño de la ventana de la hoja del gráfico. |
| worksheet | Obtiene la hoja de trabajo que contiene este gráfico. |
| shapes | Devuelve todas las formas de dibujo en este gráfico. |
| print_size | Obtiene y establece el tamaño del gráfico impreso. |
| type | Obtiene o establece el tipo de un gráfico. |
| n_series | Obtiene una colección SeriesCollection que representa la serie de datos en el gráfico. |
| filtered_n_series | Obtiene una colección SeriesCollection que representa las series de datos que se filtran en el gráfico. |
| title | Obtiene el título del gráfico. |
| sub_title | Obtiene el subtítulo del gráfico. Sólo para archivos de formato ODS. |
| plot_area | Obtiene el área de trazado del gráfico que incluye las etiquetas de marcación de los ejes. |
| chart_area | Obtiene el área del gráfico en la hoja de trabajo. |
| category_axis | Obtiene el eje X del gráfico. |
| value_axis | Obtiene el eje Y del gráfico. |
| second_value_axis | Obtiene el segundo eje Y del gráfico. |
| second_category_axis | Obtiene el segundo eje X del gráfico. |
| series_axis | Obtiene el eje de series del gráfico. |
| legend | Obtiene la leyenda del gráfico. |
| chart_data_table | Representa la tabla de datos del gráfico. |
| show_legend | Obtiene o establece un valor que indica si se mostrará la leyenda del gráfico. El valor predeterminado es “true”. |
| is_rectangular_cornered | Obtiene o establece un valor que indica si el área del gráfico tiene esquinas rectangulares. El valor predeterminado es verdadero. |
| show_data_table | Obtiene o establece un valor que indica si el gráfico muestra una tabla de datos. |
| first_slice_angle | Obtiene o establece el ángulo de la primera porción del gráfico circular o del gráfico de anillos, en grados (en el sentido de las agujas del reloj desde la vertical). Se aplica únicamente a gráficos circulares, circulares 3D y de anillos, de 0 a 360. |
| gap_width | Devuelve o establece el espacio entre grupos de barras o columnas, como un porcentaje del ancho de la barra o columna. El valor de esta propiedad debe estar entre 0 y 500. |
| gap_depth | 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. |
| floor | Devuelve un objeto Chart.floor que representa las paredes de un gráfico 3D. |
| walls | Devuelve un objeto Chart.walls que representa las paredes de un gráfico 3D. |
| back_wall | Devuelve un objeto Chart.walls que representa la pared posterior de un gráfico 3D. |
| side_wall | Devuelve un objeto Chart.walls que representa la pared lateral de un gráfico 3D. |
| walls_and_gridlines_2d | Verdadero si las líneas de cuadrícula se dibujan en dos dimensiones en un gráfico 3D. |
| rotation_angle | Representa la rotación de la vista del gráfico 3D (la rotación del área del gráfico alrededor del eje z, en grados). |
| elevation | Representa la elevación de la vista del gráfico 3D, en grados. |
| right_angle_axes | Verdadero si los ejes del gráfico son rectos. Aplica solo a gráficos 3D (excepto gráficos de columnas 3D y gráficos circulares 3D). |
| auto_scaling | Verdadero si Microsoft Excel escala un gráfico 3D para que su tamaño sea más cercano al del gráfico 2D equivalente. La propiedad RightAngleAxes debe ser Verdadera. |
| height_percent | Devuelve o establece la altura de un gráfico 3D como un porcentaje del ancho del gráfico (entre 5 y 500 por ciento). |
| perspective | Devuelve 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 Verdadera. |
| is_3d | Indica si el gráfico es un gráfico 3D. |
| depth_percent | Representa la profundidad de un gráfico 3D como un porcentaje del ancho del gráfico (entre 20 y 2000 por ciento). |
| actual_chart_size | Obtiene el tamaño real del gráfico en unidades de píxeles. |
| placement | Representa la forma en que el gráfico se adjunta a las celdas debajo de él. |
| page_setup | Representa la descripción de la configuración de la página en este gráfico. |
| line | Obtiene la línea. |
Métodos
| Método | Descripción |
|---|---|
calculate(self) | Calcula la posición personalizada del área de trazado y de los ejes si su posición se asigna automáticamente. |
calculate(self, calculate_options) | Calcula la posición personalizada del área del gráfico y de los ejes si su posición se asigna automáticamente, con las opciones de cálculo de gráficos. |
to_image(self, image_file) | 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. |
to_image(self, image_file, image_type) | Crea la imagen del gráfico y la guarda en un archivo en el tipo de imagen especificado. |
to_image(self, image_file, jpeg_quality) | Crea la imagen del gráfico y la guarda en un archivo en formato Jpeg. |
to_image(self, stream, jpeg_quality) | Crea la imagen del gráfico y la guarda en una secuencia en formato Jpeg. |
to_image(self, stream, image_type) | Crea la imagen del gráfico y la guarda en una secuencia en el formato especificado. |
to_image(self, image_file, options) | 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. |
to_image(self, stream, options) | Crea la imagen del gráfico y la guarda en una secuencia en el formato especificado. |
to_pdf(self, file_name) | Guarda el gráfico en un archivo pdf. |
to_pdf(self, file_name, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type) | Guarda el gráfico en un archivo pdf. |
to_pdf(self, stream) | Crea el gráfico en PDF y lo guarda en una secuencia. |
to_pdf(self, stream, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type) | Crea el gráfico en PDF y lo guarda en una secuencia. |
is_refered_by_chart(self, row_index, column_index) | Devuelve si la celda a la que hace referencia el gráfico. |
is_cell_refered_by_chart(self, sheet_index, row_index, column_index) | Devuelve si la celda a la que hace referencia el gráfico. |
is_chart_data_changed(self) | Detecta si la fuente de datos de un gráfico ha cambiado. |
refresh_pivot_data(self) | Actualiza los datos del gráfico desde la tabla dinámica. |
change_template(self, data) | Cambiar el tipo de gráfico con la plantilla preestablecida. |
move(self, upper_left_row, upper_left_column, lower_right_row, lower_right_column) | Mueve el gráfico a una ubicación específica. |
get_actual_size(self) | Obtiene el tamaño real del gráfico en unidades de píxeles. |
has_axis(self, aixs_type, is_primary) | Devuelve qué ejes existen en el gráfico. |
switch_row_column(self) | Cambia fila/columna. |
get_chart_data_range(self) | Obtiene el rango de fuente de datos del gráfico. |
set_chart_data_range(self, area, is_vertical) | Especifica 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
- módulo
aspose.cells.charts - clase
SeriesCollection
