ChartDataLabel

ChartDataLabel class

يمثل تسمية البيانات على نقطة الرسم البياني أو خط الاتجاه.

لمعرفة المزيد، قم بزيارةالعمل مع الرسوم البيانية مقالة توثيقية.

public class ChartDataLabel

الخصائص

اسموصف
Font { get; }يوفر الوصول إلى تنسيق الخط لتسمية البيانات هذه.
Format { get; }يوفر الوصول إلى تعبئة وتنسيق سطر تسمية البيانات.
Index { get; }يحدد فهرس العنصر الذي يحتوي عليه. سيحدد هذا الفهرس المجموعة الفرعية للأصل التي ينطبق عليها هذا العنصر. القيمة الافتراضية هي 0.
IsHidden { get; set; }الحصول على/تعيين علامة تشير إلى ما إذا كانت هذه التسمية مخفية أم لا. القيمة الافتراضية هيخطأ شنيع .
IsVisible { get; }إرجاعحقيقي إذا كان تصنيف البيانات هذا يحتوي على شيء لعرضه.
NumberFormat { get; }إرجاع تنسيق الرقم للعنصر الأصلي.
Separator { get; set; }الحصول على أو تعيين فاصل السلسلة المستخدم لتسميات البيانات في المخطط. الإعداد الافتراضي هو فاصلة، باستثناء المخططات الدائرية التي تعرض اسم الفئة والنسبة المئوية فقط، عند استخدام فاصل الأسطر بدلاً من ذلك.
ShowBubbleSize { get; set; }يسمح بتحديد ما إذا كان سيتم عرض حجم الفقاعة لتسميات البيانات على المخطط. ينطبق فقط على المخططات الفقاعية. القيمة الافتراضية هيخطأ شنيع .
ShowCategoryName { get; set; }يسمح بتحديد ما إذا كان سيتم عرض اسم الفئة لتسميات البيانات على المخطط. القيمة الافتراضية هيخطأ شنيع .
ShowDataLabelsRange { get; set; }يسمح بتحديد ما إذا كانت القيم من تسميات البيانات سيتم عرضها في تسميات البيانات. القيمة الافتراضية هيخطأ شنيع .
ShowLeaderLines { get; set; }يسمح بتحديد ما إذا كانت هناك حاجة إلى إظهار الخطوط الرئيسية لتسمية البيانات. القيمة الافتراضية هيخطأ شنيع .
ShowLegendKey { get; set; }يسمح بتحديد ما إذا كان سيتم عرض مفتاح وسيلة الإيضاح لتسميات البيانات على المخطط. القيمة الافتراضية هيخطأ شنيع .
ShowPercentage { get; set; }يسمح بتحديد ما إذا كان سيتم عرض قيمة النسبة المئوية لتسميات البيانات على المخطط. القيمة الافتراضية هيخطأ شنيع .
ShowSeriesName { get; set; }إرجاع قيمة منطقية أو تعيينها للإشارة إلى سلوك عرض اسم السلسلة لتسميات البيانات في المخطط. حقيقي لإظهار اسم المسلسل؛خطأ شنيع لإخفاء. بشكل افتراضيخطأ شنيع .
ShowValue { get; set; }يسمح بتحديد ما إذا كان سيتم عرض القيم في تسميات البيانات. القيمة الافتراضية هيخطأ شنيع .

طُرق

اسموصف
ClearFormat()مسح تنسيق تسمية البيانات هذه. يتم تعيين الخصائص على القيم الافتراضية المحددة في مجموعة التسمية data الأصل.

ملاحظات

في مسلسلChartDataLabel الكائن هو عضو فيChartDataLabelCollection . الChartDataLabelCollection يحتوي علىChartDataLabel كائن لكل نقطة.

أمثلة

يوضح كيفية تطبيق التسميات على نقاط البيانات في مخطط خطي.

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);

    // قم بتطبيق تسميات البيانات على كل سلسلة في المخطط.
    // ستظهر هذه التسميات بجوار كل نقطة بيانات في الرسم البياني وستعرض قيمتها.
    foreach (ChartSeries series in chart.Series)
    {
        ApplyDataLabels(series, 4, "000.0", ", ");
        Assert.AreEqual(4, series.DataLabels.Count);
    }

    // قم بتغيير السلسلة الفاصلة لكل تسمية بيانات في السلسلة.
    using (IEnumerator<ChartDataLabel> enumerator = chart.Series[0].DataLabels.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.AreEqual(", ", enumerator.Current.Separator);
            enumerator.Current.Separator = " & ";
        }
    }

    // للحصول على رسم بياني أكثر وضوحًا، يمكننا إزالة تسميات البيانات بشكل فردي.
    chart.Series[1].DataLabels[2].ClearFormat();

    // يمكننا أيضًا تجريد سلسلة كاملة من تسميات البيانات الخاصة بها مرة واحدة.
    chart.Series[2].DataLabels.ClearFormat();

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

/// <summary>
/// قم بتطبيق تسميات البيانات بتنسيق أرقام مخصص وفاصل على عدة نقاط بيانات في سلسلة.
/// </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);
    }
}

أنظر أيضا