Bekerja dengan Grafik
Metode insert_chart baru telah ditambahkan ke kelas DocumentBuilder. Jadi, mari kita lihat cara menyisipkan bagan kolom sederhana ke dalam dokumen menggunakan metode DocumentBuilder.insert_chart:
Cara Menyisipkan Bagan
Di bagian ini kita akan mempelajari cara menyisipkan bagan ke dalam dokumen.
Sisipkan Bagan Kolom
Contoh kode berikut menunjukkan cara menyisipkan bagan kolom:
Kode menghasilkan hasil sebagai berikut:
Ada metode add, add_double dan add_date, yang dipaparkan untuk mencakup semua kemungkinan varian sumber data untuk semua jenis bagan:
Kode menghasilkan hasil sebagai berikut:
Sisipkan Bagan Sebar
Contoh di bawah ini menunjukkan cara menyisipkan diagram sebar.
Kode menghasilkan hasil sebagai berikut:
Sisipkan Bagan Area
Contoh kode berikut menunjukkan cara menyisipkan diagram area:
Kode menghasilkan hasil sebagai berikut:
Sisipkan Bagan Gelembung
Contoh kode berikut menunjukkan cara menyisipkan diagram gelembung:
Kode menghasilkan hasil sebagai berikut:
Bekerja dengan Bagan melalui Objek Shape.chart
Setelah bagan disisipkan dan diisi dengan data, Anda dapat mengubah tampilannya. Properti Shape.chart berisi semua opsi terkait bagan yang tersedia melalui API publik.
Misalnya, mari kita ubah perilaku judul atau legenda Chart:
Kode menghasilkan hasil berikut:
Cara Bekerja dengan ChartSeriesCollection of Chart
Mari kita lihat koleksi ChartSeries. Semua seri grafik tersedia melalui koleksi Chart.series:
Anda dapat menghapus rangkaian satu per satu atau menghapus semuanya serta menambahkan yang baru jika diperlukan. Bagan yang baru disisipkan memiliki beberapa rangkaian default yang ditambahkan ke koleksi ini. Untuk menghapusnya, Anda perlu memanggil metode chart.series.clear().
Bekerja dengan Kelas Single ChartSeries
Inilah cara bekerja dengan seri tertentu.
Silakan lihat hasilnya di bawah ini:
Semua ChartSeries tunggal memiliki opsi ChartDataPoint default, coba gunakan kode berikut untuk mengubahnya:
Silakan lihat hasilnya di bawah ini:
Cara Bekerja dengan ChartDataPoint Tunggal dari ChartSeries
Dengan menggunakan ChartDataPoint Anda dapat menyesuaikan format satu titik data dari rangkaian bagan:
Silakan lihat hasilnya di bawah ini:
Cara Bekerja dengan ChartDataLabel dari Single ChartSeries
Dengan menggunakan ChartDataLabel Anda dapat menentukan format label data tunggal dari rangkaian bagan, seperti tampilkan/sembunyikan LegendKey, Nama Kategori, Nama Seri, Nilai, dll.
Silakan lihat hasilnya di bawah ini:
Cara Menentukan Opsi Default untuk ChartDataLabels dari ChartSeries
Kelas ChartDataLabelCollection mendefinisikan properti yang dapat digunakan untuk mengatur opsi default untuk ChartDataLabels untuk Seri Bagan. Properti ini termasuk show_category_name, show_bubble_size, show_percentage, show_series_name, show_value dll.
Silakan lihat hasilnya di bawah ini:
Cara Memformat Jumlah Label Data Bagan
Dengan menggunakan ChartDataLabel.number_format Anda dapat menentukan format angka dari satu label data pada bagan.
Contoh kode berikut menunjukkan cara memformat sejumlah label data:
Cara Mengatur Properti Sumbu Bagan
Jika Anda ingin bekerja dengan sumbu bagan, penskalaan, dan unit tampilan untuk sumbu nilai, silakan gunakan kelas ChartAxis, AxisDisplayUnit, dan AxisScaling.
Contoh kode berikut menunjukkan cara mendefinisikan properti sumbu X dan Y:
Cara Menetapkan Nilai Waktu Date dari Sumbu
Contoh kode berikut menunjukkan cara mengatur nilai tanggal/waktu ke properti sumbu:
Cara Memformat Nilai Angka Sumbu
Contoh kode berikut menunjukkan cara mengubah format angka pada sumbu nilai:
Cara Menetapkan Batas Sumbu
Kelas AxisBound mewakili batas nilai sumbu minimum atau maksimum. Terikat dapat ditentukan sebagai nilai numerik, tanggal-waktu, atau nilai “otomatis” khusus.
Contoh kode berikut menunjukkan cara menetapkan batas sumbu:
Cara Mengatur Satuan Interval Antar Label
Contoh kode berikut menunjukkan cara mengatur satuan interval antar label pada sumbu:
Cara Menyembunyikan Sumbu Grafik
Jika Anda ingin menampilkan atau menyembunyikan sumbu grafik, Anda dapat melakukannya dengan mengatur nilai properti ChartAxis.hidden.
Contoh kode berikut menunjukkan cara menyembunyikan sumbu Y pada bagan:
Cara Menyelaraskan Label Bagan
Jika Anda ingin menyetel perataan teks untuk label multi-baris, Anda cukup melakukannya dengan menyetel nilai properti ChartAxis.tick_label_alignment.
Contoh kode berikut menunjukkan cara mencentang perataan label:
Cara Mengatur Format Isian dan Goresan
Format isian dan guratan dapat diatur untuk rangkaian bagan, titik data, dan penanda. Untuk melakukannya, Anda perlu menggunakan properti tipe ChartFormat di kelas ChartSeries, ChartDataPoint, dan ChartMarker, serta alias untuk beberapa properti, seperti fore_color, back_color, visible, dan transparency di kelas Stroke.
Contoh kode berikut menunjukkan cara mengatur warna rangkaian:
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
shape = builder.insert_chart(aw.drawing.charts.ChartType.COLUMN, 432, 252)
chart = shape.chart
seriesColl = chart.series
# Delete default generated series.
seriesColl.clear()
# Create category names array.
categories = [ "AW Category 1", "AW Category 2" ]
# Adding new series. Value and category arrays must be the same size.
series1 = seriesColl.add("AW Series 1", categories, [ 1, 2 ])
series2 = seriesColl.add("AW Series 2", categories, [ 3, 4 ])
series3 = seriesColl.add("AW Series 3", categories, [ 5, 6 ])
# Set series color.
series1.format.fill.fore_color = drawing.Color.red
series2.format.fill.fore_color = drawing.Color.yellow
series3.format.fill.fore_color = drawing.Color.blue
doc.save(docs_base.artifacts_dir + "WorkingWithCharts.set_series_color.docx")Contoh kode berikut menunjukkan cara mengatur warna dan ketebalan garis:
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
shape = builder.insert_chart(aw.drawing.charts.ChartType.LINE, 432, 252)
chart = shape.chart
seriesColl = chart.series
# Delete default generated series.
seriesColl.clear()
# Adding new series.
series1 = seriesColl.add_double("AW Series 1", [ 0.7, 1.8, 2.6 ], [ 2.7, 3.2, 0.8 ])
series2 = seriesColl.add_double("AW Series 2", [ 0.5, 1.5, 2.5 ], [ 3, 1, 2 ])
# Set series color.
series1.format.stroke.fore_color = drawing.Color.red
series1.format.stroke.weight = 5
series2.format.stroke.fore_color = drawing.Color.light_green
series2.format.stroke.weight = 5
doc.save(docs_base.artifacts_dir + "WorkingWithCharts.line_color_and_weight.docx")