ChartDataLabel

ChartDataLabel class

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

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

public class ChartDataLabel

الخصائص

اسموصف
Font { get; }يوفر الوصول إلى تنسيق الخط لملصق البيانات هذا.
Format { get; }يوفر إمكانية الوصول إلى تنسيق التعبئة والخطوط لملصق البيانات.
Index { get; }يحدد مؤشر العنصر المحتوي. يحدد هذا المؤشر أي من مجموعات الأطفال الأصلية ينطبق عليها هذا العنصر. القيمة الافتراضية هي 0.
IsHidden { get; set; }يحصل على/يضبط علامة تشير إلى ما إذا كانت هذه العلامة مخفية أم لا. القيمة الافتراضية هيخطأ شنيع .
IsVisible { get; }إرجاعحقيقي إذا كان ملصق البيانات هذا يحتوي على شيء لعرضه.
Left { get; set; }يحصل على أو يعين مسافة تسمية البيانات بالنقاط من الحافة اليسرى للرسم البياني أو من الموضع المحدد بواسطةPosition الممتلكات، اعتمادا على قيمةLeftMode الخاصية.
LeftMode { get; set; }يحصل على وضع التفسير أو يعينهLeft قيمة الخاصية: ما إذا كانت تحدد موقع لتسمية البيانات من الحافة اليسرى للرسم البياني أو من الموضع المحدد بواسطةPosition الخاصية.
NumberFormat { get; }يعيد تنسيق الأرقام للعنصر الرئيسي.
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; }يسمح بتحديد ما إذا كان سيتم عرض القيم في تسميات البيانات. القيمة الافتراضية هيخطأ شنيع .
Top { get; set; }يحصل على أو يعين مسافة تسمية البيانات بالنقاط من الحافة العلوية للرسم البياني أو من الموضع المحدد بواسطةPosition الممتلكات، اعتمادا على قيمةTopMode الخاصية.
TopMode { get; set; }يحصل على وضع التفسير أو يعينهTop قيمة الخاصية: ما إذا كانت تحدد موقع لتسمية البيانات من الحافة العلوية للرسم البياني أو من الموضع المحدد بواسطةPosition الخاصية.

طُرق

اسموصف
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 = " & ";
        }
    }

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

أنظر أيضا

ChartAxisType Enum ChartDataLabelCollection Class