Trabajar con los gráficos
Trabajar con los gráficos
Aspose.Cells FOSS para Java conserva gráficos incorporados al cargar y ahorrar libros de trabajo XLSX. Puedes inspeccionar los gráfico existentes, consultar su tipo y posición, y agregar nuevos gráficos de tipo estándar programáticamente. Los tipos ChartEx como Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map se conservan en un recorrido redondo pero no pueden ser creados a través de la API.
Revisión
Los gráficos en una hoja de trabajo se manejan a través del ChartCollection Acceso a través de Worksheet.getCharts().Cada uno Chart El nombre de la persona, el tipo de gráfico, y su posición de anchor de dos células. se inserta un nuevo gráfico con ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), que devolve el índice del gráfico recién creado.
El ChartType Enum identifica la variante de gráfico (bar, línea, pie, etc.). Métodos de ayuda ChartCollection.parseChartType(string) y ChartCollection.chartTypeToString(ChartType) Convertir entre el enum y su representación de la línea para los casos de uso de serializacin.
Clasificaciones clave
| Class | Descripción |
|---|---|
Chart | Representa un gráfico envuelto en una hoja de trabajo. Leer el acceso a la posición del nombre, tipo y anchor celular. |
ChartCollection | Colección de todos los gráficos en una hoja de trabajo.Suporta el número, acceso al índice, añadir y los asistentes de conversión tipo gráfico. |
ChartType | Enum identificando la variante de gráfico (bar, columna, línea, pie, escatter, etc.). |
ChartModel | Modelo de serializacin interno para un gráfico. Exponer campos XML crudos utilizados durante la carga/salvación. |
Acceso a los gráficos en una hoja de trabajo
Recuperar el ChartCollection de cualquier Worksheet Objetos a través de Worksheet.getCharts().Uso de ChartCollection.getCount() Para determinar cuántos Los gráficos están presentes. los gráficos individuales se acceden por índice basado en cero a través de ChartCollection.get(index).
Una vez que te mantenga una Chart La referencia que puedes leer:
Chart.getName()- la línea de nombre interna del gráfico.Chart.getChartType()- ElChartTypeEl valor enum.Chart.getUpperLeftRow()/Chart.getUpperLeftColumn()- la célula de anchor superior izquierda.Chart.getLowerRightRow()/Chart.getLowerRightColumn()- la célula de anchor inferior derecha.Chart.getExtentCx()/Chart.getExtentCy()- El gráfico se extiende en EMU.
Añadiendo un nuevo gráfico
Uso ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) para insertar un nuevo gráfico. el método devolve el índice integral del gráficos dentro del La colección. proporciona a ChartType Valor para el type El argumento y una célula El Rango de la Figura (por ejemplo) A1:B5) Para dataRange.
Nota: Los tipos de familia ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box y Whisker, Funnel, Map) se conservan cuando cargan los archivos XLSX pero no pueden ser creados programáticamente a través de esta API.
Sumación de referencia API
Chart
| Method | Tipo de regreso | Descripción |
|---|---|---|
getName() | String | Nombre interno del mapa. |
getChartType() | ChartType | La variante de la carta es enum valor. |
getUpperLeftRow() | int | Indice de rodillo del ancho superior izquierdo. |
getUpperLeftColumn() | int | Indice de columna del ancho superior izquierdo. |
getLowerRightRow() | int | Indice de rodillo del ancho inferior derecho. |
getLowerRightColumn() | int | Indice de columna del ancho inferior derecho. |
getExtentCx() | long | La ampliación de los gráficos en EMU. |
getExtentCy() | long | El tamaño de la placa en EMU. |
ChartCollection
| Method | Tipo de regreso | Descripción |
|---|---|---|
getCount() | int | Número de gráficos en el tablero. |
get(index) | Chart | Retorna el gráfico al dato de índice basado en cero. |
add(type, dataRange, ...) | int | Addique un nuevo gráfico; devolve su índice. |
parseChartType(string) | ChartType | Convertir un nombre de la línea a una ChartType El valor enum. |
chartTypeToString(type) | String | Convertir a ChartType valor enum a su nombre de string. |
Limitaciones
- Los tipos de ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box y Whisker, Funnel, Map) son verbatim redondos pero no se pueden crear a través de la API.
- Los enlaces de la serie de datos de gráficos no se pueden modificar en esta publicación; los rendidores de los gráficas basados en el rango original de información proporcionado en la hora de creación.
