ChartType

ChartType enumeration

يحدد نوع الرسم البياني.

public enum ChartType

قيم

اسمقيمةوصف
Area0مخطط المساحة.
AreaStacked1مخطط المساحة المكدسة.
AreaPercentStacked2مخطط مساحة مكدسة بنسبة 100%.
Area3D3مخطط مساحة ثلاثي الأبعاد.
Area3DStacked4مخطط مساحة مكدسة ثلاثي الأبعاد.
Area3DPercentStacked5مخطط مساحة مكدسة بنسبة 100% ثلاثية الأبعاد.
Bar6مخطط شريطي.
BarStacked7مخطط شريطي مكدس.
BarPercentStacked8مخطط شريطي مكدس بنسبة 100%.
Bar3D9مخطط شريطي ثلاثي الأبعاد.
Bar3DStacked10مخطط شريطي مكدس ثلاثي الأبعاد.
Bar3DPercentStacked11مخطط شريطي ثلاثي الأبعاد مكدس بنسبة 100%.
Bubble12مخطط الفقاعات.
Bubble3D13مخطط الفقاعات ثلاثي الأبعاد.
Column14مخطط عمودي.
ColumnStacked15مخطط عمودي مكدس.
ColumnPercentStacked16مخطط عمودي مكدس بنسبة 100%.
Column3D17مخطط عمودي ثلاثي الأبعاد.
Column3DStacked18مخطط عمودي مكدس ثلاثي الأبعاد.
Column3DPercentStacked19مخطط عمودي ثلاثي الأبعاد بنسبة 100%.
Column3DClustered20مخطط عمودي مجمع ثلاثي الأبعاد.
Doughnut21مخطط دائري.
Line22مخطط خطي.
LineStacked23مخطط خطي مكدس.
LinePercentStacked24مخطط خطي مكدس بنسبة 100%.
Line3D25مخطط خطي ثلاثي الأبعاد.
Pie26مخطط دائري.
Pie3D27مخطط دائري ثلاثي الأبعاد.
PieOfBar28فطيرة الرسم البياني الشريطي.
PieOfPie29فطيرة الرسم البياني الدائري.
Radar30مخطط الرادار.
Scatter31مخطط التشتت.
Stock32مخطط الأسهم.
Surface33مخطط السطح.
Surface3D34مخطط سطح ثلاثي الأبعاد.
Treemap35مخطط خريطة الشجرة.
Sunburst36مخطط أشعة الشمس.
Histogram37مخطط الهيستوجرام.
Pareto38مخطط باريتو.
BoxAndWhisker39مخطط الصندوق والشارب.
Waterfall40مخطط الشلال.
Funnel41مخطط قمعي.

أمثلة

يوضح كيفية إنشاء نوع مناسب من سلسلة المخططات لنوع الرسم البياني.

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

    // هناك عدة طرق لملء مجموعة السلاسل في الرسم البياني.
    // تم تصميم مخططات السلسلة المختلفة لأنواع مختلفة من المخططات.
    // 1 - مخطط عمودي يحتوي على أعمدة مجمعة ومقسمة على طول المحور X حسب الفئة:
    Chart chart = AppendChart(builder, ChartType.Column, 500, 300);

    string[] categories = { "Category 1", "Category 2", "Category 3" };

    // أدخل سلسلتين من القيم العشرية تحتويان على قيمة لكل فئة على حدة.
    // سيحتوي مخطط العمود هذا على ثلاث مجموعات، كل منها تحتوي على عمودين.
    chart.Series.Add("Series 1", categories, new[] { 76.6, 82.1, 91.6 });
    chart.Series.Add("Series 2", categories, new[] { 64.2, 79.5, 94.0 });

    // يتم توزيع الفئات على طول المحور X، ويتم توزيع القيم على طول المحور Y.
    Assert.AreEqual(ChartAxisType.Category, chart.AxisX.Type);
    Assert.AreEqual(ChartAxisType.Value, chart.AxisY.Type);

    // 2 - مخطط المنطقة مع التواريخ الموزعة على طول المحور X:
    chart = AppendChart(builder, ChartType.Area, 500, 300);

    DateTime[] dates = { new DateTime(2014, 3, 31),
        new DateTime(2017, 1, 23),
        new DateTime(2017, 6, 18),
        new DateTime(2019, 11, 22),
        new DateTime(2020, 9, 7)
    };

    // أدخل سلسلة بقيمة عشرية لكل تاريخ محدد.
    // سيتم توزيع التواريخ على طول المحور X الخطي،
    // والقيم المضافة إلى هذه السلسلة ستؤدي إلى إنشاء نقاط بيانات.
    chart.Series.Add("Series 1", dates, new[] { 15.8, 21.5, 22.9, 28.7, 33.1 });

    Assert.AreEqual(ChartAxisType.Category, chart.AxisX.Type);
    Assert.AreEqual(ChartAxisType.Value, chart.AxisY.Type);

    // رسم بياني تشتت ثلاثي الأبعاد:
    chart = AppendChart(builder, ChartType.Scatter, 500, 300);

    // ستحتاج كل سلسلة إلى مصفوفتين عشريتين متساويتين في الطول.
    // تحتوي المصفوفة الأولى على قيم X، وتحتوي المصفوفة الثانية على قيم Y المقابلة
    // من نقاط البيانات على الرسم البياني.
    chart.Series.Add("Series 1",
        new[] { 3.1, 3.5, 6.3, 4.1, 2.2, 8.3, 1.2, 3.6 },
        new[] { 3.1, 6.3, 4.6, 0.9, 8.5, 4.2, 2.3, 9.9 });
    chart.Series.Add("Series 2",
        new[] { 2.6, 7.3, 4.5, 6.6, 2.1, 9.3, 0.7, 3.3 },
        new[] { 7.1, 6.6, 3.5, 7.8, 7.7, 9.5, 1.3, 4.6 });

    Assert.AreEqual(ChartAxisType.Value, chart.AxisX.Type);
    Assert.AreEqual(ChartAxisType.Value, chart.AxisY.Type);

    // 4 - مخطط الفقاعات:
    chart = AppendChart(builder, ChartType.Bubble, 500, 300);

    // ستحتاج كل سلسلة إلى ثلاث مصفوفات عشرية متساوية الطول.
    // تحتوي المصفوفة الأولى على قيم X، وتحتوي المصفوفة الثانية على قيم Y المقابلة،
    // والثالث يحتوي على أقطار لكل نقطة بيانات في الرسم البياني.
    chart.Series.Add("Series 1",
        new[] { 1.1, 5.0, 9.8 },
        new[] { 1.2, 4.9, 9.9 },
        new[] { 2.0, 4.0, 8.0 });

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

/// <summary>
/// قم بإدراج مخطط باستخدام منشئ المستندات لنوع مخطط معين وعرض وارتفاع، ثم قم بإزالة بياناته التجريبية.
/// </summary>
private static Chart AppendChart(DocumentBuilder builder, ChartType chartType, double width, double height)
{
    Shape chartShape = builder.InsertChart(chartType, width, height);
    Chart chart = chartShape.Chart;
    chart.Series.Clear();
    return chart;
}

أنظر أيضا