Bekerja dengan Grafik
Metode InsertChart baru telah ditambahkan ke kelas DocumentBuilder. Jadi, mari kita lihat cara menyisipkan bagan kolom sederhana ke dalam dokumen menggunakan metode InsertChart.
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 empat kelebihan berbeda untuk metode Seri Tambahkan, yang diekspos untuk mencakup semua kemungkinan varian sumber data untuk semua jenis bagan:
Kode menghasilkan hasil sebagai berikut:
Sisipkan Bagan Sebar
Contoh kode berikut 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 Grafik 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 Bagan:
Kode menghasilkan hasil berikut:
Cara Bekerja dengan ChartSeriesCollection of Chart
Mari kita lihat koleksi ChartSeries. Semua seri grafik tersedia melalui koleksi chart.Series, yaitu IEnumerable:
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 bagan.Seri.Hapus().
Bekerja dengan Kelas Single ChartSeries
Berikut 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 Chart Series. Properti ini mencakup ShowCategoryName, ShowBubbleSize, ShowPercentage, ShowSeriesName, ShowValue, dll:
Silakan lihat hasilnya di bawah ini:
Cara Memformat Jumlah Label Data Bagan
Dengan menggunakan NumberFormat Anda dapat menentukan format nomor 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 dapat melakukannya dengan menyetel nilai properti TickLabels.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 ForeColor, BackColor, Visible, dan Transparency di kelas Stroke.
Contoh kode berikut menunjukkan cara mengatur warna rangkaian:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Create category names array.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };
// Adding new series. Value and category arrays must be the same size.
ChartSeries series1 = seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
ChartSeries series2 = seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
ChartSeries series3 = seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
// Set series color.
series1.Format.Fill.ForeColor = Color.Red;
series2.Format.Fill.ForeColor = Color.Yellow;
series3.Format.Fill.ForeColor = Color.Blue;
doc.Save(dir + "ColumnColor.docx");
Contoh kode berikut menunjukkan cara mengatur warna dan ketebalan garis:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Adding new series.
ChartSeries series1 = seriesColl.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 },
new double[] { 2.7, 3.2, 0.8 });
ChartSeries series2 = seriesColl.Add("AW Series 2", new double[] { 0.5, 1.5, 2.5 },
new double[] { 3, 1, 2 });
// Set series color.
series1.Format.Stroke.ForeColor = Color.Red;
series1.Format.Stroke.Weight = 5;
series2.Format.Stroke.ForeColor = Color.LightGreen;
series2.Format.Stroke.Weight = 5;
doc.Save(dir + "LineColorAndWeight.docx");