ChartDataLabelCollection

ChartDataLabelCollection class

يمثل مجموعة منChartDataLabel .

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

public class ChartDataLabelCollection : IEnumerable<ChartDataLabel>

الخصائص

اسموصف
Count { get; }إرجاع عددChartDataLabel في هذه المجموعة.
Font { get; }يوفر الوصول إلى تنسيق الخط الخاص بعلامات البيانات الخاصة بالسلسلة بأكملها.
Format { get; }يوفر إمكانية الوصول إلى تنسيق التعبئة والخطوط لملصقات البيانات.
Item { get; }إرجاعChartDataLabel للمؤشر المحدد.
NumberFormat { get; }يحصل علىChartNumberFormat مثال يسمح بتعيين تنسيق الأرقام لملصقات البيانات الخاصة بالسلسلة بأكملها.
Orientation { get; set; }يحصل على اتجاه النص لملصقات البيانات الخاصة بالسلسلة بأكملها أو يعينه.
Position { get; set; }يحصل على موضع تسميات البيانات أو يعينه.
Rotation { get; set; }يحصل على أو يعين دوران تسميات البيانات للسلسلة بأكملها بالدرجات.
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()يمسح تنسيق الكلChartDataLabel في هذه المجموعة.
GetEnumerator()يعيد كائن المعداد.

أمثلة

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

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 = " & ";
        }
    }

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

    // للحصول على رسم بياني يبدو أكثر نظافة، يمكننا إزالة تسميات البيانات بشكل فردي.
    dataLabel.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)
{
    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);
    }
}

أنظر أيضا

ChartDataLabel Class ChartDataLabelLocationMode Enum