ChartDataPointCollection

ChartDataPointCollection class

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

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

public class ChartDataPointCollection : IEnumerable<ChartDataPoint>

الخصائص

اسموصف
Count { get; }إرجاع عددChartDataPoint في هذه المجموعة.
Item { get; }إرجاعChartDataPoint للمؤشر المحدد.

طُرق

اسموصف
ClearFormat()يمسح تنسيق الكلChartDataPoint في هذه المجموعة.
CopyFormat(int, int)نسخ التنسيق من نقطة البيانات المصدر إلى نقطة البيانات الوجهة.
GetEnumerator()يعيد كائن المعداد.
HasDefaultFormat(int)يحصل على علم يشير إلى ما إذا كانت نقطة البيانات في الفهرس المحدد لها تنسيق افتراضي.

أمثلة

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

public void ChartDataPoint()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    Shape shape = builder.InsertChart(ChartType.Line, 500, 350);
    Chart chart = shape.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)
        ApplyDataPoints(series, 4, MarkerSymbol.Diamond, 15);

    // قم بتنعيم الخط الذي يمثل سلسلة البيانات الأولى.
    chart.Series[0].Smooth = true;

    // تأكد من أن نقاط البيانات الخاصة بالسلسلة الأولى لن تعكس ألوانها إذا كانت القيمة سلبية.
    using (IEnumerator<ChartDataPoint> enumerator = chart.Series[0].DataPoints.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.False(enumerator.Current.InvertIfNegative);
        }
    }

    ChartDataPoint dataPoint = chart.Series[1].DataPoints[2];
    dataPoint.Format.Fill.Color = Color.Red;

    // للحصول على رسم بياني يبدو أكثر نظافة، يمكننا مسح التنسيق بشكل فردي.
    dataPoint.ClearFormat();

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

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

/// <summary>
/// تطبيق عدد من نقاط البيانات على سلسلة.
/// </summary>
private static void ApplyDataPoints(ChartSeries series, int dataPointsCount, MarkerSymbol markerSymbol, int dataPointSize)
{
    for (int i = 0; i < dataPointsCount; i++)
    {
        ChartDataPoint point = series.DataPoints[i];
        point.Marker.Symbol = markerSymbol;
        point.Marker.Size = dataPointSize;

        Assert.AreEqual(i, point.Index);
    }
}

أنظر أيضا

ChartDataPoint Class ChartDataTable Class