Bekerja dengan Grafik
Bekerja dengan Diagram
Aspose.Cells FOSS untuk Java mempertahankan diagram tertanam ketika memuat dan menyimpan workbook XLSX. Anda dapat memeriksa diagram yang ada, menanyakan tipe dan posisinya, serta menambahkan diagram tipe standar baru secara programatik. Tipe ChartEx seperti Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, dan Map dipertahankan pada perjalanan bolak-balik tetapi tidak dapat dibuat melalui API.
Gambaran Umum
Diagram dalam lembar kerja dikelola melalui ChartCollection yang diakses melalui Worksheet.getCharts(). Setiap instance Chart menampilkan namanya, tipe diagram, dan posisi jangkar dua-selnya. Diagram baru disisipkan dengan ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), yang mengembalikan indeks diagram yang baru dibuat.
Enum ChartType mengidentifikasi varian diagram (bar, line, pie, dll.). Metode bantu ChartCollection.parseChartType(string) dan ChartCollection.chartTypeToString(ChartType) mengonversi antara enum dan representasi stringnya untuk keperluan serialisasi.
Kelas Kunci
| Kelas | Deskripsi |
|---|---|
Chart | Mewakili diagram tersemat dalam lembar kerja. Akses baca ke nama, tipe, dan posisi jangkar sel. |
ChartCollection | Koleksi semua diagram pada lembar kerja. Mendukung penghitung, akses indeks, penambahan, dan pembantu konversi tipe diagram. |
ChartType | Enum yang mengidentifikasi varian diagram (batang, kolom, garis, pai, sebar, dll.). |
ChartModel | Model serialisasi internal untuk sebuah diagram. Mengekspos bidang XML mentah yang digunakan selama proses memuat/menyimpan. |
Mengakses Diagram pada Lembar Kerja
Ambil ChartCollection dari objek Worksheet apa pun melalui Worksheet.getCharts(). Gunakan ChartCollection.getCount() untuk menentukan berapa banyak diagram yang ada. Diagram individu diakses dengan indeks berbasis nol melalui ChartCollection.get(index).
Setelah Anda memiliki referensi Chart, Anda dapat membaca:
Chart.getName()— string nama internal diagram.Chart.getChartType()— nilai enumChartType.Chart.getUpperLeftRow()/Chart.getUpperLeftColumn()— sel jangkar kiri-atas.Chart.getLowerRightRow()/Chart.getLowerRightColumn()— sel jangkar kanan-bawah.Chart.getExtentCx()/Chart.getExtentCy()— ukuran diagram dalam EMUs.
Menambahkan Diagram Baru
Gunakan ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) untuk menyisipkan diagram baru. Metode ini mengembalikan indeks integer diagram dalam koleksi. Berikan nilai ChartType untuk argumen type dan string rentang sel (misalnya A1:B5) untuk dataRange.
Catatan: tipe ChartEx-family (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) dipertahankan saat memuat file XLSX tetapi tidak dapat dibuat secara programatik melalui API ini.
API Reference Ringkasan
Chart
| Metode | Jenis pengembalian | Deskripsi |
|---|---|---|
getName() | String | Nama internal dari chart. |
getChartType() | ChartType | Nilai enum varian chart. |
getUpperLeftRow() | int | Indeks baris jangkar kiri-atas. |
getUpperLeftColumn() | int | Indeks kolom jangkar kiri-atas. |
getLowerRightRow() | int | Indeks baris dari anchor kanan-bawah. |
getLowerRightColumn() | int | Indeks kolom dari anchor kanan-bawah. |
getExtentCx() | long | Lebar diagram dalam EMUs. |
getExtentCy() | long | Tinggi diagram dalam EMUs. |
ChartCollection
| Metode | Jenis pengembalian | Deskripsi |
|---|---|---|
getCount() | int | Jumlah diagram pada lembar kerja. |
get(index) | Chart | Mengembalikan chart pada indeks berbasis nol yang diberikan. |
add(type, dataRange, ...) | int | Menambahkan bagan baru; mengembalikan indeksnya. |
parseChartType(string) | ChartType | Mengonversi nama string menjadi nilai enum ChartType. |
chartTypeToString(type) | String | Mengonversi nilai enum ChartType menjadi nama stringnya. |
Batasan
- Tipe ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) dipertahankan secara verbatim selama proses round-trip tetapi tidak dapat dibuat melalui API.
- Ikatan seri data diagram tidak dapat dimodifikasi dalam rilis ini; diagram dirender berdasarkan rentang data asli yang diberikan saat pembuatan.
