ChartSeries

ChartSeries class

Grafik serisi özelliklerini temsil eder.

Daha fazlasını öğrenmek için şu adresi ziyaret edin:Grafiklerle Çalışmak dokümantasyon makalesi.

public class ChartSeries : IChartDataPoint

Özellikleri

İsimTanım
Bubble3D { get; set; }Kabarcık grafiğindeki baloncuklara 3 boyutlu efektin uygulanması gerekip gerekmediğini belirtir.
BubbleSizes { get; }Bu grafik serisi için kabarcık boyutlarının bir koleksiyonunu alır.
DataLabels { get; }Tüm seriye ilişkin veri etiketlerinin ayarlarını belirtir.
DataPoints { get; }Bu serideki tüm veri noktaları için biçimlendirme nesnelerinin bir koleksiyonunu döndürür.
Explosion { get; set; }Veri noktasının pastanın merkezinden ne kadar uzağa taşınacağını belirtir. Negatif olabilir, negatif, özelliğin ayarlanmadığı ve hiçbir patlamanın uygulanmaması gerektiği anlamına gelir. Yalnızca Pasta grafikleri için geçerlidir.
Format { get; }Serinin dolgu ve çizgi formatlamasına erişim sağlar.
HasDataLabels { get; set; }Seri için veri etiketlerinin görüntülenip görüntülenmeyeceğini belirten bir bayrağı alır veya ayarlar.
InvertIfNegative { get; set; }Değer negatifse ana öğenin renklerini ters çevirip çevirmeyeceğini belirtir.
LegendEntry { get; }Bu grafik serisi için bir gösterge girişi alır.
Marker { get; }Bir veri işaretçisini belirtir. İşaretleyici istendiğinde otomatik olarak oluşturulur.
Name { get; set; }Serinin adını alır veya ayarlar; eğer isim açıkça ayarlanmadıysa index. kullanılarak oluşturulur. Varsayılan olarak Seri artı bir tabanlı indeks döndürür.
SeriesType { get; }Bu grafik serisinin türünü alır.
Smooth { get; set; }Grafikteki noktaları birleştiren çizginin Catmull-Rom spline’ları kullanılarak yumuşatılıp yumuşatılmayacağını belirlemeye izin verir.
XValues { get; }Bu grafik serisi için X değerlerinden oluşan bir koleksiyon alır.
YValues { get; }Bu grafik serisi için Y değerlerinin bir koleksiyonunu alır.

yöntemler

İsimTanım
Add(ChartXValue)Belirtilen X değerini grafik serisine ekler. Seri, Y değerlerini ve kabarcık boyutlarını destekliyorsa, bunlar X değeri için boş olacaktır.
Add(ChartXValueChartYValue)Belirtilen X ve Y değerlerini grafik serisine ekler.
Add(ChartXValueChartYValue, double)Belirtilen X değerini, Y değerini ve kabarcık boyutunu grafik serisine ekler.
Clear()Tüm veri değerlerini grafik serisinden kaldırır. Tüm bireysel veri noktalarının ve veri etiketlerinin formatı temizlendi.
ClearValues()Veri noktalarının ve veri etiketlerinin formatını koruyarak tüm veri değerlerini grafik serisinden kaldırır.
Insert(int, ChartXValue)Belirtilen X değerini belirtilen dizindeki grafik serisine ekler. Seri, Y değerlerini ve kabarcık boyutlarını destekliyorsa, X değeri için boş olacaktır.
Insert(int, ChartXValueChartYValue)Belirtilen X ve Y değerlerini belirtilen dizindeki grafik serisine ekler.
Insert(int, ChartXValueChartYValue, double)Belirtilen X değerini, Y değerini ve kabarcık boyutunu belirtilen dizindeki grafik serisine ekler.
Remove(int)Belirtilen dizindeki grafik serisinden X değerini, Y değerini ve kabarcık boyutunu (destekleniyorsa) kaldırır. İlgili veri noktası ve veri etiketi de kaldırılır.

Örnekler

Çizgi grafikteki veri noktalarına etiketlerin nasıl uygulanacağını gösterir.

public void DataLabels()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    Shape chartShape = builder.InsertChart(ChartType.Line, 400, 300);
    Chart chart = chartShape.Chart;

    Assert.AreEqual(3, chart.Series.Count);
    Assert.AreEqual("Series 1", chart.Series[0].Name);
    Assert.AreEqual("Series 2", chart.Series[1].Name);
    Assert.AreEqual("Series 3", chart.Series[2].Name);

    // Grafikteki her seriye veri etiketleri uygulayın.
    // Bu etiketler grafikteki her veri noktasının yanında görünecek ve değerini gösterecektir.
    foreach (ChartSeries series in chart.Series)
    {
        ApplyDataLabels(series, 4, "000.0", ", ");
        Assert.AreEqual(4, series.DataLabels.Count);
    }

    // Bir serideki her veri etiketi için ayırıcı dizeyi değiştirin.
    using (IEnumerator<ChartDataLabel> enumerator = chart.Series[0].DataLabels.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.AreEqual(", ", enumerator.Current.Separator);
            enumerator.Current.Separator = " & ";
        }
    }

    // Daha temiz görünen bir grafik için veri etiketlerini tek tek kaldırabiliriz.
    chart.Series[1].DataLabels[2].ClearFormat();

    // Ayrıca bir dizi veri etiketinin tamamını aynı anda kaldırabiliriz.
    chart.Series[2].DataLabels.ClearFormat();

    doc.Save(ArtifactsDir + "Charts.DataLabels.docx");
}

/// <summary>
/// Özel sayı formatına ve ayırıcıya sahip veri etiketlerini bir serideki çeşitli veri noktalarına uygulayın.
/// </summary>
private static void ApplyDataLabels(ChartSeries series, int labelsCount, string numberFormat, string separator)
{
    for (int i = 0; i < labelsCount; i++)
    {
        series.HasDataLabels = true;

        Assert.False(series.DataLabels[i].IsVisible);

        series.DataLabels[i].ShowCategoryName = true;
        series.DataLabels[i].ShowSeriesName = true;
        series.DataLabels[i].ShowValue = true;
        series.DataLabels[i].ShowLeaderLines = true;
        series.DataLabels[i].ShowLegendKey = true;
        series.DataLabels[i].ShowPercentage = false;
        series.DataLabels[i].IsHidden = false;
        Assert.False(series.DataLabels[i].ShowDataLabelsRange);

        series.DataLabels[i].NumberFormat.FormatCode = numberFormat;
        series.DataLabels[i].Separator = separator;

        Assert.False(series.DataLabels[i].ShowDataLabelsRange);
        Assert.True(series.DataLabels[i].IsVisible);
        Assert.False(series.DataLabels[i].IsHidden);
    }
}

Ayrıca bakınız