ChartDataLabel

ChartDataLabel class

Bir grafik noktasındaki veya trend çizgisindeki veri etiketini temsil eder.

Daha fazla bilgi edinmek için şu adresi ziyaret edin:Grafiklerle Çalışma belgeleme makalesi.

public class ChartDataLabel

Özellikleri

İsimTanım
Font { get; }Bu veri etiketinin yazı tipi biçimlendirmesine erişim sağlar.
Format { get; }Veri etiketinin dolgu ve satır biçimlendirmesine erişim sağlar.
Index { get; }İçeren öğenin dizinini belirtir. Bu dizin, bu öğenin hangi ebeveynin çocuk koleksiyonuna uygulanacağını belirler. Varsayılan değer 0’dır.
IsHidden { get; set; }Bu etiketin gizli olup olmadığını belirten bir bayrak alır/ayarlar. Varsayılan değerYANLIŞ .
IsVisible { get; }Geri Döndürürdoğru eğer bu veri etiketinin göstereceği bir şey varsa.
Left { get; set; }Veri etiketinin grafiğin sol kenarından veya onun tarafından belirtilen konumdan uzaklığını noktalar halinde alır veya ayarlar.Position mülk, değerine bağlı olarakLeftMode özelliği.
LeftMode { get; set; }Yorumlama modunu alır veya ayarlarLeft özellik değeri: grafikteki sol kenardan veri etiketinin location değerini belirtilen konumdan ayarlayıp ayarlamadığıPosition özelliği.
NumberFormat { get; }Üst öğenin sayı biçimini döndürür.
Orientation { get; set; }Etiket metninin yönünü alır veya ayarlar.
Position { get; set; }Veri etiketinin konumunu alır veya ayarlar.
Rotation { get; set; }Etiketin dönüşünü derece cinsinden alır veya ayarlar.
Separator { get; set; }Bir grafikteki veri etiketleri için kullanılan dize ayırıcısını alır veya ayarlar. Yalnızca kategori adını ve yüzdeyi gösteren pasta grafikleri dışında, varsayılan değer virgüldür; bunun yerine satır sonu kullanılmalıdır.
ShowBubbleSize { get; set; }Bir grafikteki veri etiketleri için kabarcık boyutunun görüntülenip görüntülenmeyeceğini belirtmeye olanak tanır. Yalnızca Kabarcık grafikleri için geçerlidir. Varsayılan değerYANLIŞ .
ShowCategoryName { get; set; }Bir grafikteki veri etiketleri için kategori adının görüntülenip görüntülenmeyeceğini belirtmeye olanak tanır. Varsayılan değerYANLIŞ .
ShowDataLabelsRange { get; set; }Veri etiketlerinde görüntülenecek veri etiketi aralığındaki değerlerin belirtilmesine olanak tanır. Varsayılan değerYANLIŞ .
ShowLeaderLines { get; set; }Veri etiketi lider çizgilerinin gösterilmesi gerekip gerekmediğini belirtmeye olanak tanır. Varsayılan değerYANLIŞ .
ShowLegendKey { get; set; }Bir grafikteki veri etiketleri için efsane anahtarının görüntülenip görüntülenmeyeceğini belirtmeye olanak tanır. Varsayılan değerYANLIŞ .
ShowPercentage { get; set; }Bir grafikteki veri etiketleri için yüzde değerinin görüntülenip görüntülenmeyeceğini belirtmeye olanak tanır. Varsayılan değerYANLIŞ .
ShowSeriesName { get; set; }Bir grafikteki veri etiketleri için seri adı görüntüleme davranışını belirtmek üzere bir Boole değeri döndürür veya ayarlar. doğru dizi adını göstermek için;YANLIŞ gizlemek için. Varsayılan olarakYANLIŞ .
ShowValue { get; set; }Veri etiketlerinde değerlerin görüntülenip görüntülenmeyeceğini belirtmeye olanak tanır. Varsayılan değerYANLIŞ .
Top { get; set; }Veri etiketinin grafiğin üst kenarından veya onun tarafından belirtilen konumdan uzaklığını noktalar halinde alır veya ayarlar.Position mülk, değerine bağlı olarakTopMode özelliği.
TopMode { get; set; }Yorumlama modunu alır veya ayarlarTop özellik değeri: veri etiketinin location değerini grafiğin üst kenarından belirtilen konumdan ayarlayıp ayarlamadığıPosition özelliği.

yöntemler

İsimTanım
ClearFormat()Bu veri etiketinin biçimini temizler. Özellikler, üst data etiket koleksiyonunda tanımlanan varsayılan değerlere ayarlanır.

Notlar

Bir dizide,ChartDataLabel nesne bir üyedirChartDataLabelCollection . ChartDataLabelCollection bir içerirChartDataLabel her nokta için nesne.

Örnekler

Bir çizgi grafiğindeki 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 = " & ";
        }
    }

    ChartDataLabel dataLabel = chart.Series[1].DataLabels[2];
    dataLabel.Format.Fill.Color = Color.Red;

    // Daha temiz görünümlü bir grafik için veri etiketlerini tek tek kaldırabiliriz.
    dataLabel.ClearFormat();

    // Ayrıca bir dizi verinin tüm etiketlerini bir kerede kaldırabiliriz.
    chart.Series[2].DataLabels.ClearFormat();

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

/// <summary>
/// Bir serideki birden fazla veri noktasına özel sayı biçimi ve ayırıcı ile veri etiketleri uygulayın.
/// </summary>
private static void ApplyDataLabels(ChartSeries series, int labelsCount, string numberFormat, string separator)
{
    series.HasDataLabels = true;
    series.Explosion = 40;

    for (int i = 0; i < labelsCount; i++)
    {
        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;
        Assert.False(series.DataLabels[i].IsHidden);
        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

ChartAxisType Enum ChartDataLabelCollection Class