ChartSeries

ChartSeries class

يمثل خصائص سلسلة المخططات.

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

public class ChartSeries : IChartDataPoint

الخصائص

اسموصف
Bubble3D { get; set; }يحدد ما إذا كان يجب أن يكون للفقاعات الموجودة في المخطط الفقاعي تأثير ثلاثي الأبعاد مطبق عليها.
BubbleSizes { get; }الحصول على مجموعة من أحجام الفقاعات لسلسلة المخططات هذه.
DataLabels { get; }يحدد إعدادات تسميات البيانات للسلسلة بأكملها.
DataPoints { get; }إرجاع مجموعة من كائنات التنسيق لجميع نقاط البيانات في هذه السلسلة.
Explosion { get; set; }يحدد مقدار نقل نقطة البيانات من مركز الدائرة. يمكن أن يكون سالبًا، ويعني السالب أنه لم يتم تعيين الخاصية ولا ينبغي تطبيق أي انفجار. ينطبق فقط على المخططات الدائرية.
Format { get; }يوفر الوصول إلى التعبئة وتنسيق الخط للسلسلة.
HasDataLabels { get; set; }الحصول على أو تعيين علامة تشير إلى ما إذا كانت تسميات البيانات معروضة للسلسلة.
InvertIfNegative { get; set; }يحدد ما إذا كان العنصر الأصلي يجب أن يعكس ألوانه إذا كانت القيمة سالبة.
LegendEntry { get; }الحصول على إدخال وسيلة إيضاح لسلسلة المخططات هذه.
Marker { get; }يحدد علامة البيانات. يتم إنشاء العلامة تلقائيًا عند الطلب.
Name { get; set; }الحصول على اسم السلسلة أو تعيينه، إذا لم يتم تعيين الاسم بشكل صريح، فسيتم إنشاؤه باستخدام الفهرس. بشكل افتراضي يتم إرجاع السلسلة بالإضافة إلى فهرس واحد.
SeriesType { get; }الحصول على نوع سلسلة المخططات هذه.
Smooth { get; set; }يسمح بتحديد ما إذا كان الخط الذي يربط النقاط على الرسم البياني سيتم تنعيمه باستخدام خطوط Catmull-Rom.
XValues { get; }الحصول على مجموعة من قيم X لسلسلة المخططات هذه.
YValues { get; }الحصول على مجموعة من قيم Y لسلسلة المخططات هذه.

طُرق

اسموصف
Add(ChartXValue)إضافة قيمة X المحددة إلى سلسلة المخططات. إذا كانت السلسلة تدعم قيم Y وأحجام الفقاعات، فستكون فارغة للقيمة X.
Add(ChartXValue, ChartYValue)إضافة قيم X وY المحددة إلى سلسلة المخططات.
Add(ChartXValue, ChartYValue, double)إضافة قيمة X وقيمة Y وحجم الفقاعة المحددة إلى سلسلة المخطط.
Clear()إزالة كافة قيم البيانات من سلسلة المخططات. تم مسح تنسيق جميع نقاط البيانات الفردية وتسميات البيانات.
ClearValues()إزالة كافة قيم البيانات من سلسلة المخططات مع الحفاظ على تنسيق نقاط البيانات وتسميات البيانات.
Insert(int, ChartXValue)يقوم بإدراج قيمة X المحددة في سلسلة المخططات في الفهرس المحدد. إذا كانت السلسلة تدعم قيم Y وأحجام الفقاعات، فستكون فارغة بالنسبة لقيمة X.
Insert(int, ChartXValue, ChartYValue)يقوم بإدراج قيم X وY المحددة في سلسلة المخططات في الفهرس المحدد.
Insert(int, ChartXValue, ChartYValue, double)يقوم بإدراج قيمة X المحددة وقيمة Y وحجم الفقاعة في سلسلة المخططات في الفهرس المحدد.
Remove(int)إزالة القيمة X والقيمة Y وحجم الفقاعة، إذا كانت مدعومة، من سلسلة المخططات في الفهرس المحدد. تتم أيضًا إزالة نقطة البيانات المقابلة وتسمية البيانات.

أمثلة

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

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

أنظر أيضا

ChartNumberFormat Class ChartSeriesCollection Class