Travailler avec les graphiques
Travailler avec les graphiques
Aspose.Cells FOSS pour Java conserve des graphiques intégrés lors de la charge et du sauvetage de livres XLSX. Vous pouvez inspecter les graphes existants, demander leur type et leur position, et ajouter de nouveaux grafs standard par programmation. Les types ChartEx tels que Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, and Map sont conservés sur un tour rouge mais ne peuvent pas être créés à travers l’API.
Vue d’ensemble
Les graphiques dans un feuille de travail sont gérés par le « ChartCollection » accessé via « Workksheet.getCharts() ». Chaque instance de « Graphique » expose son nom, type de diagramme et sa position d’ancre à deux cellules. Un nouveau diagrame est inséré avec le " ChardColection.add (type, dataRange, upperLeftRow, UpperRightColumn, lowerRighteRoy, downRightsColum) “, qui retourne l’indice du nouveau graphique créé.
Le ‘ChartType’ enum identifie la variante du graphique (bar, ligne, pie, etc.) Les méthodes d’aide sont ChardTyp(string) et `CardStype(CharacterThype)’ convertis entre le enume et sa représentation de fil pour les cas d’utilisation de série.
Classes clés
| Class | Description |
|---|---|
Chart | Represents an embedded chart in a worksheet. Read access to name, type, and cell-anchor position. |
ChartCollection | Collection of all charts on a worksheet. Supports count, index access, add, and chart-type conversion helpers. |
ChartType | Enum identifying the chart variant (bar, column, line, pie, scatter, etc.). |
ChartModel | Internal serialization model for a chart. Exposes raw XML fields used during load/save. |
Accès aux charts sur un feuille de travail
Retirez le « ChartCollection » de n’importe quel objet du « Workheet » via le “Worksheet.getCharts() “. Utilisez le ‘Chartcollection.geCount()’ pour déterminer combien de charts sont présents. Les chars individuels sont accessibles par l’index basé sur zéro à travers le `Chardonnage.net(index)’.
Une fois que vous avez une référence « Charte », vous pouvez lire :
Chart.getName()— la barre d’appellation interne du graphique.Chart.getChardot()— la valeur enum de ‘Chards’ .Chart.getUpperLeftRow()/ ` Chart .getupperLeftColumn()’ — la cellule de l’anchor en haut à gauche.Chart.getLowerRightRow()/ ` Chart .getRowerColumn()’ — la cellule d’anchor à droite inférieure.Chart.getExtentCx()/ ` Chart .get ExtenCy()‘ — les extensions du diagramme dans les EMU.
Ajouter une nouvelle carte
Utilisez ‘ChartCollection.add(type, dataRange, upperLeftRow, topLefTool, lowerRightRoy, bottomRighTol)’ pour insérer un nouveau diagramme. La méthode retourne l’indice intégral du diagrame dans la collection. Fournir une valeur de ‘Type’ au argument ’typ’ et une ligne d’intervalle cellulaire (par exemple ‘A1:B5’) pour ‘dataRage’.
Remarque : Les types de famille ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box et Whisker, Funnel, Map) sont conservés lors du chargement des fichiers XLSX mais ne peuvent pas être créés programmatiquement via cette API.
Le résumé de référence API
Charte
| Method | Return type | Description |
|---|---|---|
getName() | String | Internal name of the chart. |
getChartType() | ChartType | The chart variant enum value. |
getUpperLeftRow() | int | Row index of the top-left anchor. |
getUpperLeftColumn() | int | Column index of the top-left anchor. |
getLowerRightRow() | int | Row index of the bottom-right anchor. |
getLowerRightColumn() | int | Column index of the bottom-right anchor. |
getExtentCx() | long | Chart width in EMUs. |
getExtentCy() | long | Chart height in EMUs. |
Charte de collection
| Method | Return type | Description |
|---|---|---|
getCount() | int | Number of charts on the worksheet. |
get(index) | Chart | Returns the chart at the given zero-based index. |
add(type, dataRange, ...) | int | Adds a new chart; returns its index. |
parseChartType(string) | ChartType | Converts a string name to a ChartType enum value. |
chartTypeToString(type) | String | Converts a ChartType enum value to its string name. |
Les limites
- Les types ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box et Whisker, Funnel, Map) sont des verbatimes en triplé rouge mais ne peuvent pas être créés via l’API.
- Les liens de la série de données du graphique ne sont pas modifiables dans cette édition; les rendus du Graphique se basent sur l’ensemble des données originels fournis au moment de sa création.
Voir aussi
- Aspose.Cells pour Java - Documentation d’entreprise
