Çizelgelerle Çalışmak

Yeni insertChart yöntemi sınıfın DocumentBuilder içine eklendi. Öyleyse, basit bir sütun grafiğini belgenin içine insertChart yöntemini kullanarak eklemeyi nasıl yaparız bakalım.

Aspose.Words kullanarak sıfırdan bir grafik nasıl eklenir?

Bu bölümde bir grafik bir belgedeki nasıl ekleneceğini öğreneceğiz.

Sütun Grafik Ekle

Aşağıdaki kod örneği sütun grafiği nasıl ekleneceğini göstermektedir:

Kod aşağıdaki sonucu üretir:

Bu tüm grafik türleri için veri kaynaklarının her olası varyantını kapsayacak şekilde ortaya çıkarılan seri Add yönteminin dört farklı aşırı yüklemesi vardı:

Kodun aşağıdaki sonucu ürettiği:

Yayılımli Grafik Ekle

Aşağıdaki kod örneği bir dağılıma nasıl eklemenin yolunu gösterir:

Koda aşağıdaki sonuç üretilir:

Area Çizelgesi Ekle

Aşağıdaki kod örneği bir alan grafiğinin nasıl ekleneceğini göstermektedir:

Kodu aşağıdaki sonucu üretiyor:

İçe Kayan Kabarcık Grafiği

Aşağıdaki kod örneği bir balon grafiği ekleme gösteriyor:

Kod aşağıdaki sonucu üretir:

Çizelgelerle Çalışmak Shape.Chart Nesnesi aracılığıyla

Çizim tablosu veri ile doldurulduktan sonra görünümünü değiştirebilirsiniz. Shape.Chart özelliği, API aracılığıyla mevcut olan tüm grafikle ilgili seçenekleri içerir.

Örneğin, “Chart başlığını veya efsanesi davranışını değiştirin”:

Kod aşağıdaki sonuçları üretir:

Çizim Serileri Koleksiyonu ile Çalışmak Nasıl Yapılır?

Şimdi baktığımız ChartSeries koleksiyonuna bakalım. Tüm grafik serileri chart.getSeries() koleksiyonu aracılığıyla mevcuttur ve Iterable:

Bir bir serileri kaldırabilir veya onları hepsini de temizleyebilir ve gerekirse yeni bir tane ekleyebilirsin. Yeni girilen grafik bu koleksiyona bazı varsayılan serileri ekler. Bunları kaldırmak için chart.getSeries().clear() yöntemini çağırman gerekir.

Tek Bir ChartSeries Sınıfıyla Çalışma

İşte bir seri ile nasıl çalışılacağı.

Lütfen aşağıdaki sonucu gör:

Tüm tek ChartSeries‘lerin varsayılan ChartDataPoint seçenekleri var, onları değiştirmek için aşağıdaki kodu deneyin lütfen:

ChartSeries ‘da Tek Bir ChartDataPoint ile Nasıl Çalışılır?

ChartDataPoint kullanarak, grafik serisindeki tek bir veri noktasının biçimlendirmesini özelleştirebilirsiniz:

Aşağıdaki sonucu lütfen inceleyin:

Tek Bir Çizgi Grafik Serisindeki Veri Etiketleriyle Nasıl Çalışılır

ChartDataLabel kullanarak grafik serisinde tek bir veri etiketinin biçimlendirmesini belirtme yeteneğiniz var, örneğin show/hide LegendKey, CategoryName, SeriesName, Value vb.:

Lütfen aşağıdaki sonucu gör.:

ChartSeries için Varsayılan Seçenekleri Nasıl Tanımlayın?

ChartDataLabelCollection sınıfı varsayılan seçenekleri belirlemek için ChartDataLabels için Chart Series‘i ayarlamak için kullanılabilecek özellikleri tanımlar. Bu özellikler setShowCategoryName, setShowBubbleSize, setShowPercentage, setShowSeriesName, setShowValue vb

Lütfen aşağıdaki sonucu görünüz:

Şema Veri Etiketi Sayı Biçimlendirme Nasıl Yapılır

Kullanarak NumberFormat özelliğini, çizelgedeki tek bir veri etiketi için sayı biçimlendirmesini belirtebilirsiniz.

Aşağıdaki kod örneği, veri etiketi numarasının nasıl biçimlendirileceğini gösterir:

Çizelge Eksen Özelliklerini Nasıl Ayarlarsınız?

Değer ekseni için ölçekleme ve görüntüleme birimleriyle çalışmak istiyorsanız lütfen ChartAxis, AxisDisplayUnit ve AxisScaling sınıflarını kullanın.

Aşağıdaki kod örneği X ve Y ekseni özelliklerinin nasıl tanımlanacağını göstermektedir:

Nasıl Date eksen zaman değeri ayarlayın

Aşağıdaki kod örneğinde tarih/saat değerlerini eksen özelliklerine ayarlamaya nasıl gösterilmektedir:

Axis’in Sayı Değerini Biçimlendirme Nasıl Yapılır?

Aşağıdaki kod örneği değer ekseni üzerindeki sayıların biçimini nasıl değiştireceğinizi gösterir:’’

eksen için sınır nasıl ayarlanır

Sınıfı temsil AxisBound bir eksen değerleri için bir en az veya maksimum sınırdır. Sınır sayısal olarak, tarih saat veya özel “otomatik” değeri olarak belirtilebilir.

Aşağıdaki kod örneği bir eksen için sınırların nasıl ayarlanacağını göstermektedir:

Etiket Arası Aralık Birimini Nasıl Ayarlayın

Aşağıdaki kod örneği bir eksen üzerindeki etiketlerin arasındaki aralık birimini nasıl ayarlayacağını göstermektedir:

Grafik Eksenini Nasıl Gizleyeceğiniz

Eğer bir grafiğin eksenini göstermek veya gizlemek istiyorsanız, bunu basitçe ChartAxis.Hidden özelliğinin değerini ayarlayarak başarabilirsiniz.

Aşağıdaki kod örneğinde grafiğin y eksenini gizlemek nasıl yapılır gösterilmektedir:

Nasıl Çizgi Grafiği Etiketini Hizalar?

Eğer birden fazla satır etiketleri için bir metin hizalaması ayarlamak istiyorsanız, bunu setTickLabelAlignment() özelliğinin değerini ayarlayarak basitçe elde edebilirsiniz.

Aşağıdaki kod örneği etiket hizalaması nasıl yapılır gösterdiğini gösterir:

Microsoft Word varsayılan olarak Grafik Etiketini ortalayacak şekilde hizalar.

Doldurma ve Çizgi Biçimlendirme Nasıl Ayarlanır

Eşya ve vuruş formatlaması bir grafik serisi, veri noktaları ve işaretçiler için ayarlanabilir. Bunu yapmak için ChartSeries, ChartDataPoint ve ChartMarker sınıflarında ChartFormat türünün özelliklerini ve bazı özellikler için takma adlar, örneğin ForeColor, BackColor, Visible ve Transparency Stroke sınıfında kullanılmalıdır.

Aşağıdaki kod örneği serilerin rengini nasıl ayarlayacağını gösterir:

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("ColumnColor.docx");

Aşağıdaki kod örneğinde satır rengini ve ağırlığını nasıl ayarlayacağını gösteriyor:

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("LineColorAndWeight.docx");