Working with Charts

Εργασία με διαγράμματα

Aspose.Cells FOSS for Java preserves embedded charts when loading and saving XLSX workbooks. You can inspect existing charts, query their type and position, and add new standard-type charts programmatically. ChartEx types such as Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, and Map are preserved on round-trip but cannot be created through the API.

ΕΚΤΙΜΗΣΗ

Οι πίνακες σε ένα φύλλο εργασίας διαχειρίζονται μέσω της ChartCollection Διαθέσιμο μέσω Worksheet.getCharts().Κάθε ένας Chart Η περίπτωση παρουσιάζει το όνομά της, τον τύπο του χάρτη, και τη θέση του δύο κυττάρων anchor. ένα νέο διάγραμμα εισάγεται με ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), που επιστρέφει τον δείκτη του νεοκαθαρρύπτοντος χάρτη.

Η ChartType Το enum αναγνωρίζει την παραλλαγή του χάρτη (βαρό, γραμμή, πύρα κλπ.). Βοηθητικές μέθοδοι ChartCollection.parseChartType(string) και ChartCollection.chartTypeToString(ChartType) Μετατρέψτε το μεταξύ του enum και Η παρουσίαση του σιδήρου για τις περιπτώσεις χρήσης της σειριακής χρήσεως.

Κλειδιά τάξεων

Κλάση	Περιγραφή
`Chart`	Αντιπροσωπεύει ένα ενσωματωμένο διάγραμμα σε μια φύλλα εργασίας. Διαβάστε την πρόσβαση στην θέση του ονόματος, τύπου και κελί-ανχέρ.
`ChartCollection`	Συλλογή όλων των χάρτη σε ένα φύλλο εργασίας. υποστηρίζει τον αριθμό, την πρόσβαση στην ένδειξη, προσθέστε και βοηθήματα μετατροπής τύπου χαρτιά.
`ChartType`	Enum που αναγνωρίζει την παραλλαγή του χάρτη (βαρό, στήλη, γραμμή, πύρα, διαχωριστής κλπ.).
`ChartModel`	Εσωτερικό μοντέλο σειριώσεως για ένα διάγραμμα. εκθέτει τα πρώτα πεδία XML που χρησιμοποιούνται κατά τη διάρκεια φορτίου / αποθήκευσης.

Η πρόσβαση σε χάρτες σε ένα φύλλο εργασίας

Αποκτήστε το ChartCollection Από οποιαδήποτε Worksheet Ο αντικείμενο μέσω Worksheet.getCharts().Χρησιμοποιήστε ChartCollection.getCount() Για να προσδιορίσουμε πόσοι Τα ατομικά χάρτη είναι προσβάσιμα μέσω μηδενικού δείκτη. ChartCollection.get(index).

Όταν κρατάς ένα Chart Αναφορά που μπορείτε να διαβάσετε:

Chart.getName() - το εσωτερικό όνομα του χάρτη.
Chart.getChartType() - το ChartType Αξία του ΕΝΟ.
Chart.getUpperLeftRow() / Chart.getUpperLeftColumn() - το ανώτερο αριστερό κελί anchor.
Chart.getLowerRightRow() / Chart.getLowerRightColumn() - το κάτω δεξί κελί anchor.
Chart.getExtentCx() / Chart.getExtentCy() - το χάρτη εκτείνεται σε EMUs.

Προσθέστε ένα νέο χάρτη

Χρησιμοποιήστε ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) να εισάγετε ένα νέο χάρτη. η μέθοδος επιστρέφει το πλήρες δείκτη του χαρτιού μέσα στο Η συλλογή.Προστέλλονται μια ChartType Η αξία για το type Η κελιά και η κλήση Σύνδεση με το δίκτυο (για παράδειγμα) A1:B5) Για dataRange.

Σημείωση: Οι τύποι οικογένειας ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) διατηρούνται κατά την φόρτωση αρχείων XLSX αλλά δεν μπορούν να δημιουργηθούν προγραμματικά μέσω αυτής της API.

Συνοπτική αναφορά API

Χάρτης

Μέθοδος	Τύπος επιστροφής	Περιγραφή
`getName()`	`String`	Εσωτερικό όνομα του χάρτη.
`getChartType()`	`ChartType`	Η διαφορά του χάρτη είναι η τιμή.
`getUpperLeftRow()`	`int`	Ο δείκτης σιδήρου του ανδρείου της κορυφής αριστεράς.
`getUpperLeftColumn()`	`int`	Δείκτης στήλης του ανδρείου πάνω αριστερά.
`getLowerRightRow()`	`int`	Ο δείκτης σιδήρου του δεξιού κάτω άγγιγματος.
`getLowerRightColumn()`	`int`	Δείκτης στήλης του δεξιού κάτω άγγρου.
`getExtentCx()`	`long`	Χάρτης πλάτος σε EMUs.
`getExtentCy()`	`long`	Η ύψος του χάρτη στα EMUs.

ChartCollection

Μέθοδος	Τύπος επιστροφής	Περιγραφή
`getCount()`	`int`	Αριθμός χάρτη στο φύλλο εργασίας.
`get(index)`	`Chart`	Επιστρέφει το χάρτη στο δεδομένο μηδενικό δείκτη.
`add(type, dataRange, ...)`	`int`	Προσθέτει ένα νέο χάρτη, επιστρέφει τον δείκτη του.
`parseChartType(string)`	`ChartType`	Μετατρέπεται ένα όνομα στυλ σε ένα `ChartType` Αξία του ΕΝΟ.
`chartTypeToString(type)`	`String`	Μετατρέψτε το A `ChartType` Η τιμή του είναι ονομασία στίχου.

Περιορισμοί

Οι τύποι ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) είναι στρογγυλεμένοι λεκτικοί αλλά δεν μπορούν να δημιουργηθούν μέσω του API.
Οι δεσμοί της σειράς δεδομένων χάρτη δεν μπορούν να τροποποιηθούν σε αυτή την έκδοση. οι εκδόσεις χαρτών βασίζονται στην αρχική σειρά δεδομένα που παρέχεται κατά τη στιγμή της δημιουργίας.

Δείτε επίσης

Aspose.Cells for Java — Enterprise Documentation