إدارة سلاسل بيانات المخطط في العروض التقديمية على Android

نظرة عامة

يمكن للمخطط تخزين القيم المرسومة إما في خلايا دفتر عمل أو مباشرةً كقواعد عددية. يمثل IChartSeries مجموعة واحدة من القيم المرتبطة، ويُمثل كل IChartDataPoint نقطة في تلك المجموعة. توفر كائنات IChartCategory التسميات أو قيم التجميع المشتركة بين المجموعات. في المخططات التي تم إنشاؤها ببيانات افتراضية، تستخدم أسماء السلاسل والفئات وقيم النقاط كائنات IChartDataCell من دفتر عمل المخطط.

في مخطط الفئة النموذجي، يستخدم دفتر العمل الافتراضي الصف 0 لأسماء السلاسل، والعمود 0 لأسماء الفئات، وتُستخدم الخلايا المتبقية لقيم السلاسل. فهارس الورقة، الصف، والعمود التي تُمرَّر إلى IChartDataWorkbook.getCell هي فهارس تبدأ من الصفر. هذا التخطيط مفيد عندما تنشئ مخططاً ببيانات افتراضية، لكن لا تفرض أن كل مخطط موجود يستخدمه. بالنسبة إلى عرض تقديمي محمَّل، افحص الخلايا التي تشير إليها السلاسل، الفئات، والنقاط قبل تغيير قيم دفتر العمل.

إعدادات المخطط لها ثلاث نطاقات مختلفة:

  • إعدادات على مستوى السلسلة، مثل IChartSeries.getFormat، تُقدِّم المظهر الافتراضي لجميع النقاط في سلسلة واحدة.
  • إعدادات على مستوى النقطة، مثل IChartDataPoint.getFormat، تُعيد كتابة مظهر السلسلة لنقطة واحدة.
  • إعدادات المجموعة تُطبق على السلاسل المتوافقة التي تنتمي إلى نفس IChartSeriesGroup. استخدم IChartSeries.getParentSeriesGroup عندما تحتاج إلى ضبط خيارات مثل التداخل أو عرض الفجوة.

عند عدم تعيين تعبئة صريحة للنقطة أو السلسلة، يحدَّد نمط المخطط والموضوع المظهر التلقائي. عندما تكون كلٌّ من تنسيقات السلسلة والنقطة موجودة، تُعطى أولوية لتنسيق النقطة لتلك النقطة.

chart-series-powerpoint

في مخطط أسطواني مُجمَّع، راجع كيف أن changing the 3D series type or bar shape يؤثر على السلسلة الأولى.

تعيين قيم السلسلة باستخدام القواعد العددية

استخدم القواعد العددية عندما تأتي قيم السلسلة من بيانات التطبيق أو الحسابات ولا تحتاج إلى مراجع خلايا ورقة العمل. استدعِ setDataSourceTypeForValues مع DataSourceType.DoubleLiterals قبل إسناد نتيجة getValue لكل نقطة عبر setAsLiteralDouble.

يتحكم إعداد المجموعة في نوع مصدر جميع قيم النقاط في تلك السلسلة. تُعيد طريقة getDataSourceType لكل قيمة نقطة النوع المحدد؛ غيّره عبر إعداد المجموعة. مع Worksheet، استخدم getAsCell للوصول إلى الخلية المشار إليها. مع DoubleLiterals، استخدم getAsLiteralDouble أو setAsLiteralDouble لقراءة أو كتابة الرقم مباشرة.

المثال التالي ينشئ مخطط أعمدة مع سلاسل وفئات افتراضية، ثم يُسند القيم المحسوبة 10 و 20 وما إلى ذلك إلى النقاط الموجودة في السلسلة الأولى. يحفظ العرض التقديمي، يعيده للفتح، ويطبع القيم المخزنة.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 300);
    IChartSeries series = chart.getChartData().getSeries().get_Item(0);

    series.getDataPoints().setDataSourceTypeForValues(DataSourceType.DoubleLiterals);
    for (int i = 0; i < series.getDataPoints().size(); i++) {
        series.getDataPoints().get_Item(i).getValue().setAsLiteralDouble((i + 1) * 10);
    }

    presentation.save("numeric_literals.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Presentation reopenedPresentation = new Presentation("numeric_literals.pptx");
try {
    ISlide reopenedSlide = reopenedPresentation.getSlides().get_Item(0);
    IChart reopenedChart = (IChart) reopenedSlide.getShapes().get_Item(0);
    IChartSeries reopenedSeries = reopenedChart.getChartData().getSeries().get_Item(0);
    for (IChartDataPoint point : reopenedSeries.getDataPoints()) {
        System.out.println(point.getValue().getAsLiteralDouble());
    }
} finally {
    reopenedPresentation.dispose();
}

نوع مصدر قيمة النقطة منفصل عن IChartData.getDataSourceType الذي يحدِّد تكوين دفتر العمل الداخلي أو الخارجي للمخطط. لا يؤدي استخدام القواعد العددية بحد ذاته إلى إزالة دفتر العمل المضمّن. في هذا المثال، يظل دفتر العمل متاحاً لتسميات الفئات، أسماء السلاسل، والسلاسل الأخرى. راجع Chart Workbook لإدارة دفتر العمل.

بالنسبة إلى مخططات التشتت والفقاعات، استخدم setDataSourceTypeForXValues و setDataSourceTypeForYValues لاختيار المصادر لـ getXValue و getYValue. تستخدم مخططات الفقاعات أيضاً setDataSourceTypeForBubbleSizes لـ getBubbleSize. عيّن كل مصدر مناسب إلى DoubleLiterals قبل إسناد الأرقام عبر طريقة setAsLiteralDouble لتلك القيمة.

تعيين تداخل سلاسل المخطط

تقارير IChartSeries.getOverlap مقدار تداخل الأعمدة أو الأشرطة في مخطط ثنائي الأبعاد، من -100 إلى 100 ٪. هي إسقاط للقراءة فقط لإعداد المجموعة الأصلية. استخدم IChartSeriesGroup.setOverlap لتحديث كل السلاسل المتوافقة في تلك المجموعة. ينطبق هذا الخيار على أنواع المخططات التي تعرض أشرطة أو أعمدة مُجمَّعة؛ ولا يؤثر على مجموعات السلاسل غير المرتبطة في مخطط مركب.

المثال التالي يعيّن التداخل للمجموعة التي تحتوي على السلسلة الأولى:

import com.aspose.slides.*;

final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final byte overlapPercent = 30;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    // المخطط الجديد يحتوي على سلاسل وعينات وفئات وقيم.
    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    series.getParentSeriesGroup().setOverlap(overlapPercent);

    presentation.save("series_overlap.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

النتيجة:

The series overlap

تغيير لون تعبئة السلسلة

استخدم IChartSeries.getFormat لتعيين التعبئة الافتراضية لسلسلة كاملة. إذا كان للنقطة تعبئة صريحة، فإن إعداد IChartDataPoint.getFormat يتجاوز تعبئة السلسلة لتلك النقطة.

المثال التالي يطبّق تعبئة صلبة زرقاء على السلسلة الأولى:

import com.aspose.slides.*;
import android.graphics.Color;

final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    series.getFormat().getFill().setFillType(FillType.Solid);
    series.getFormat().getFill().getSolidFillColor().setColor(Color.BLUE);

    presentation.save("series_color.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

النتيجة:

The color of the series

تغيير اسم السلسلة

يُخزن اسم السلسلة في دفتر عمل بيانات المخطط وعادةً ما يُعرض في المفتاح. في دفتر العمل الافتراضي الذي يُنشأ لمخطط أعمدة مُجمَّع، تكون الخلية B1 في الصف 0، العمود 1 وتحتوي على اسم السلسلة الأولى. الثوابت المسماة في المثال التالي تجعل هذا الهيكل واضحًا:

import com.aspose.slides.*;

final int firstSlideIndex = 0;
final int worksheetIndex = 0;
final int seriesNameRowIndex = 0;
final int firstSeriesColumnIndex = 1;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
    IChartDataCell seriesNameCell = workbook.getCell(worksheetIndex, seriesNameRowIndex, firstSeriesColumnIndex);
    seriesNameCell.setValue("Revenue");

    presentation.save("series_name.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

يمكنك أيضًا تحديث الخلية التي يُشير إليها IChartSeries.getName بالفعل. يتيح هذا النهج تجنُّب الافتراض بوجود صف وعمود محددين في مخطط موجود:

import com.aspose.slides.*;

final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final int firstNameCellIndex = 0;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    IChartDataCell seriesNameCell = series.getName().getAsCells().get_Item(firstNameCellIndex);
    seriesNameCell.setValue("Revenue");

    presentation.save("series_name.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

النتيجة:

The series name

إنشاء سلسلة باسم من خلايا متعددة

يكون اسم السلسلة المركب مفيدًا عندما يُخزن اسم المنتج وفترة التقرير في خلايا دفتر عمل منفصلة. على سبيل المثال، يمكنك دمج Product A في B1 و 2026 في C1 في اسم سلسلة واحد مع إبقاء الجزأين مرتبطين بخلايا المصدر.

استخدم IChartDataWorkbook.getCellCollection لاسترجاع نطاق الاسم، ثم مرّر ذلك التجميع إلى IChartSeriesCollection.add. يتحكم معامل skipHiddenCells فيما إذا كانت الخلايا المخفية تُدرج: true تُستثنى، و false تُضمَّن. يستخدم هذا المثال false لتضمين كل خلية في نطاق الاسم.

المثال التالي ينشئ عرض تقديمي بسلسلة واحدة ونقطتي بيانات. تُزوِّد الخلايا B1:C1 فقط باسم السلسلة؛ وتُزوِّد A2:A3 تسميات الفئات، وتُزوِّد B2:B3 القيم العددية.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 620, 180);

    chart.getChartData().getSeries().clear();
    chart.getChartData().getCategories().clear();
    chart.setLegend(true);

    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
    workbook.clear(0);

    // هاتان الخليتان توفران اسم السلسلة.
    workbook.getCell(0, 0, 1, "Product A");
    workbook.getCell(0, 0, 2, "2026");
    IChartCellCollection nameCells = workbook.getCellCollection("Sheet1!$B$1:$C$1", false);
    IChartSeries series = chart.getChartData().getSeries().add(nameCells, ChartType.ClusteredColumn);

    // خلايا منفصلة توفر الفئات ونقاط البيانات الرقمية.
    IChartDataCell northCategory = workbook.getCell(0, 1, 0, "North");
    IChartDataCell southCategory = workbook.getCell(0, 2, 0, "South");
    chart.getChartData().getCategories().add(northCategory);
    chart.getChartData().getCategories().add(southCategory);
    IChartDataCell northValue = workbook.getCell(0, 1, 1, 120);
    IChartDataCell southValue = workbook.getCell(0, 2, 1, 150);
    series.getDataPoints().addDataPointForBarSeries(northValue);
    series.getDataPoints().addDataPointForBarSeries(southValue);

    presentation.save("composite_series_name.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

اسم السلسلة الناتج هو Product A 2026 مع مسافة بين القيمتين من الخليتين. يعرض المفتاح هذا كمدخل واحد لكل العمودين. توضح الصورة أدناه النتيجة:

Column chart with North and South values and the composite series name Product A 2026 in the legend

الحصول على لون تعبئة السلسلة التلقائي

تُعيد IChartSeries.getAutomaticSeriesColor اللون المحسوب من فهرس السلسلة ونمط المخطط كعدد صحيح من نوع Android ARGB. هذا هو اللون المستخدم عندما لم تُحدَّد تعبئة السلسلة صراحة. قراءة الطريقة تُعيد اللون المحسوب؛ لا تُعيّن تعبئة جديدة.

المثال التالي يطبع عدد اللون التلقائي لكل سلسلة افتراضية:

import com.aspose.slides.*;

final int firstSlideIndex = 0;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    int seriesCount = chart.getChartData().getSeries().size();
    for (int seriesIndex = 0; seriesIndex < seriesCount; seriesIndex++) {
        IChartSeries series = chart.getChartData().getSeries().get_Item(seriesIndex);
        int automaticColor = series.getAutomaticSeriesColor();
        System.out.println("Series " + seriesIndex + ": " + automaticColor);
    }
} finally {
    presentation.dispose();
}

القيم الصحيحة الدقيقة تعتمد على نمط المخطط والموضوع.

تعيين تعبئة عكسية للون لسلسلة مخطط

لسلاسل الأعمدة، الأشرطة، والفقاعات، يمكن لـ IChartSeries.setInvertIfNegative عرض القيم السالبة بتعبئة مختلفة. عيّن التعبئة العادية للسلسلة إلى صلبة، فعل العكس، وعيّن لون القيمة السالبة عبر IChartSeries.getInvertedSolidFillColor. تبقى الأرقام السالبة دون تغيير في دفتر العمل؛ يتغيّر لون العرض فقط.

المثال التالي يستبدل بيانات المخطط الافتراضية بسلسلة واحدة. يحتوي الصف 0 من الورقة على اسم السلسلة، العمود 0 على أسماء الفئات، والعمود 1 على القيم:

import com.aspose.slides.*;
import android.graphics.Color;

final int firstSlideIndex = 0;
final int worksheetIndex = 0;
final int headerRowIndex = 0;
final int categoryColumnIndex = 0;
final int firstSeriesColumnIndex = 1;
final int firstDataRowIndex = 1;

String[] categoryNames = { "Category 1", "Category 2", "Category 3" };
int[] seriesValues = { -20, 50, -30 };

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
    IChartData chartData = chart.getChartData();
    IChartDataWorkbook workbook = chartData.getChartDataWorkbook();

    chartData.getSeries().clear();
    chartData.getCategories().clear();

    IChartDataCell seriesNameCell = workbook.getCell(worksheetIndex, headerRowIndex, firstSeriesColumnIndex, "Series 1");
    int chartType = chart.getType();
    IChartSeries series = chartData.getSeries().add(seriesNameCell, chartType);

    for (int categoryIndex = 0; categoryIndex < categoryNames.length; categoryIndex++) {
        int dataRowIndex = firstDataRowIndex + categoryIndex;
        String categoryName = categoryNames[categoryIndex];
        int seriesValue = seriesValues[categoryIndex];

        IChartDataCell categoryCell = workbook.getCell(worksheetIndex, dataRowIndex, categoryColumnIndex, categoryName);
        chartData.getCategories().add(categoryCell);

        IChartDataCell valueCell = workbook.getCell(worksheetIndex, dataRowIndex, firstSeriesColumnIndex, seriesValue);
        series.getDataPoints().addDataPointForBarSeries(valueCell);
    }

    int automaticSeriesColor = series.getAutomaticSeriesColor();
    series.getFormat().getFill().setFillType(FillType.Solid);
    series.getFormat().getFill().getSolidFillColor().setColor(automaticSeriesColor);
    series.setInvertIfNegative(true);
    series.getInvertedSolidFillColor().setColor(Color.RED);

    presentation.save("inverted_solid_fill_color.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

النتيجة:

The inverted solid fill color

يمكنك تفعيل العكس لنقطة واحدة عبر IChartDataPoint.setInvertIfNegative. في المثال التالي يُعطَّل العكس للسلسلة ويُفعَّل فقط للنقطة المختارة. تُعيَّن النقطة كذلك قيمة سالبة لتظهر التأثير:

import com.aspose.slides.*;
import android.graphics.Color;

final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final int targetDataPointIndex = 2;
final int negativeValue = -30;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    int automaticSeriesColor = series.getAutomaticSeriesColor();
    series.getFormat().getFill().setFillType(FillType.Solid);
    series.getFormat().getFill().getSolidFillColor().setColor(automaticSeriesColor);
    series.getInvertedSolidFillColor().setColor(Color.RED);
    series.setInvertIfNegative(false);

    IChartDataPoint dataPoint = series.getDataPoints().get_Item(targetDataPointIndex);
    dataPoint.getValue().getAsCell().setValue(negativeValue);
    dataPoint.setInvertIfNegative(true);

    presentation.save("data_point_invert_color_if_negative.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

مسح قيمة نقطة بيانات محددة

لجعل نقطة واحدة فارغة دون إزالة النقاط الأخرى، عيّن خلية دفتر العمل الداعمة لها إلى null. بالنسبة إلى مخطط الأعمدة، تتوفر القيمة المرسومة عبر IChartDataPoint.getValue. تبقى نقطة البيانات في نفس موقع الفئة، لكن المخطط يتعامل مع قيمتها كقيمة فارغة وفق إعدادات القيم الفارغة للمخطط.

المثال التالي يمسح النقطة الثانية فقط في السلسلة الأولى:

import com.aspose.slides.*;

final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final int targetDataPointIndex = 1;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);

    IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    IChartDataPoint dataPoint = series.getDataPoints().get_Item(targetDataPointIndex);
    dataPoint.getValue().getAsCell().setValue(null);

    presentation.save("clear_data_point_value.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

تستخدم مخططات التشتت خلايا X و Y منفصلة، وتستخدم مخططات الفقاعات أيضاً خلية حجم. امسح فقط الخلية التي تمثل القيمة التي تريد إزالتها. لا تستدعِ IChartDataPointCollection.clear عندما ترغب في إبقاء باقي النقاط، إذ سيؤدي ذلك إلى إزالة كل نقاط البيانات من التجميع.

التحكم في عرض الخلايا الفارغة

الخلايا المخفية التي تحتوي على قيم هي حالة منفصلة عن الخلايا الفارغة. لتضمين أو استبعاد البيانات من صفوف وأعمدة الورقة المخفية، راجع Include Data from Hidden Rows and Columns.

تمثل خلية دفتر العمل الفارغة بيانات مفقودة؛ بينما تمثل الخلية التي تحتوي على 0 قيمة عددية معروفة. استدعِ IChartDataCell.setValue مع null لجعل الخلية فارغة. يظل الصفر العددي صفرًا بغض النظر عن إعداد الخلايا الفارغة.

استخدم IChart.setDisplayBlanksAs لاختيار طريقة عرض المخطط للخلايا الفارغة. يطبق هذا الإعداد على المخطط كاملًا. يغيّر طريقة رسم الفراغات دون ملء خلية دفتر العمل الفارغة بصفر أو قيمة مُق interpolation.

المثال التالي المستقل يُنشئ مخططًا خطيًا بسلسلة واحدة، يمسح القيمة لليوم 3، ويحفظ المخطط نفسه بثلاث وضعيات. لا يُطلَب ملف إدخال. يستخدم IChartDataWorkbook الورقة 0، العمود 0 لتسميات الفئات، والعمود 1 للقيم؛ الصف 0 يحمل اسم السلسلة. البيانات النهائية هي 10, 20, empty, 30, 40.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IChart chart = slide.getShapes().addChart(ChartType.LineWithMarkers, 40, 40, 640, 400);
    IChartData chartData = chart.getChartData();
    IChartDataWorkbook workbook = chartData.getChartDataWorkbook();

    chartData.getSeries().clear();
    chartData.getCategories().clear();

    IChartDataCell seriesNameCell = workbook.getCell(0, 0, 1, "Measurements");
    IChartSeries series = chartData.getSeries().add(seriesNameCell, chart.getType());
    int[] values = { 10, 20, 25, 30, 40 };

    for (int i = 0; i < values.length; i++) {
        IChartDataCell categoryCell = workbook.getCell(0, i + 1, 0, "Day " + (i + 1));
        chartData.getCategories().add(categoryCell);
        IChartDataCell valueCell = workbook.getCell(0, i + 1, 1, values[i]);
        series.getDataPoints().addDataPointForLineSeries(valueCell);
    }

    // اترك اليوم 3 فارغًا فعليًا، مع الاحتفاظ بفئته ونقطة البيانات الخاصة به.
    workbook.getCell(0, 3, 1).setValue(null);

    int[] modes = { DisplayBlanksAsType.Gap, DisplayBlanksAsType.Zero, DisplayBlanksAsType.Span };
    String[] modeNames = { "Gap", "Zero", "Span" };
    for (int i = 0; i < modes.length; i++) {
        chart.setDisplayBlanksAs(modes[i]);
        presentation.save("empty_cells_" + modeNames[i] + ".pptx", SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

كل ملف إخراج يخزن الوضع المُعيَّن قبل الحفظ: empty_cells_Gap.pptx، empty_cells_Zero.pptx، و empty_cells_Span.pptx. لحفظ نسخة واحدة فقط، عيّن الوضع المطلوب واحفظ العرض التقديمي مرة واحدة بدلًا من التكرار على جميع الأوضاع.

المقارنة أدناه تُظهر نفس البيانات في الملفات الثلاثة. اليوم 3 فارغ في دفتر العمل في كل حالة:

Line charts with identical data: Gap breaks the line at Day 3, Zero drops the line to zero, and Span connects Day 2 to Day 4.

يعتمد التأثير الظاهر على نوع المخطط. يجعل مخطط الخط الثلاث أوضاع سهلة المقارنة. لا تمتلك مخططات الأعمدة والشرائح خطًا لربط الفواصل، لذا لا يمكن لـ Span إنتاج قطعة ربط كما في الأعلى؛ قد تبدو عمود مفقود وعمود صفر الارتفاع متشابهان. وبالمثل، لا يُظهر مخطط التشتت مع مؤشرات فقط خطًا رابطًا. لا تتوقع ثلاث نتائج مميزة لكل نوع مخطط؛ تحقق من الإخراج للنوع الذي تستخدمه.

تعيين عرض فجوة السلسلة

عرض الفجوة هو المسافة بين عنقود الأعمدة أو الأشرطة المتجاورة، تُعبر عنها كنسبة مئوية من عرض العمود أو الشريط. مثل التداخل، ينتمي إلى مجموعة السلسلة الأصلية وليس إلى سلسلة واحدة. استدعِ IChartSeriesGroup.setGapWidth مرة واحدة للمجموعة. القيمة الأكبر تُنشئ مساحة أكبر بين العناقيد؛ والقيمة الأصغر تجعلها أكثر كثافة.

المثال التالي يغيّر عرض الفجوة ويحفظ العرض التقديمي النهائي فقط:

import com.aspose.slides.*;

final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final int gapWidthPercent = 30;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);

    IChart chart = slide.getShapes().addChart(ChartType.StackedColumn, 20, 20, 500, 200);

    IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    series.getParentSeriesGroup().setGapWidth(gapWidthPercent);

    presentation.save("gap_width_30.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

النتيجة:

The gap width

إظهار أو إخفاء خطوط السلسلة

خطوط السلسلة تربط بصريًا الأجزاء المرتبطة من المخطط. استخدم IChartSeriesGroup.setSeriesLines لإظهارها أو إخفائها في مخططات الشريط المرتبطة المدعومة ومخططات Pie of Pie. في مخططات الشريط والعمود المتراكم ثنائي الأبعاد، تربط حدود الكومة المقابلة عبر الفئات. في مخططات Pie of Pie و Bar of Pie، تربط المخطط الرئيسي بالمخطط الثانوي. هذا الإعداد ليس موصلًا عامًا لأنواع مخططات أخرى.

الوصول إلى المجموعة عبر IChartSeries.getParentSeriesGroup. يُطبق الإعداد على كل سلسلة في تلك المجموعة. تُعَدُّ IChartSeries.hasSeriesLines للقراءة فقط وتعكس إعداد المجموعة الأصلية؛ استدعِ مُعِد المجموعة لتحديثه.

المثال التالي ينشئ مخططًا واحدًا من نوع PieOfPie ببيانات افتراضية. يحفظ المخطط نفسه مع تمكين خطوط السلسلة ثم تعطيلها، مُنتجًا عرضين تقديميين للمقارنة.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IChart chart = slide.getShapes().addChart(ChartType.PieOfPie, 50, 50, 600, 400);
    IChartSeries series = chart.getChartData().getSeries().get_Item(0);
    IChartSeriesGroup seriesGroup = series.getParentSeriesGroup();

    seriesGroup.setSeriesLines(true);
    presentation.save("series_lines_enabled.pptx", SaveFormat.Pptx);

    seriesGroup.setSeriesLines(false);
    presentation.save("series_lines_disabled.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}
Series lines enabled Series lines disabled
Pie of Pie chart with series lines enabled Pie of Pie chart with series lines disabled
The two lines connect the main pie to the secondary pie. Both pies remain visible, but the connecting lines are hidden.

تختلف خطوط السلسلة عن خطوط القادة لتسميات البيانات التي تربط التسميات بنقاطها، وعن خطوط الشبكة التي تُحدِّد الفواصل على محاور المخطط، وعن خطوط المخططات الخطية التي تمثل قيم البيانات. هذا الإعداد لا يتحكم في تلك العناصر.

الأسئلة المتكررة

ما أنواع المخططات التي تدعم سلاسل البيانات؟

جميع أنواع المخططات المتضمنة في تعداد ChartType تستخدم بيانات المخطط، لكن سلاسِلها لا تتشارك دائمًا نفس هيكل القيم أو الإعدادات. على سبيل المثال، تستخدم المخططات الفئوية فئاتًا وقيمًا، وتستخدم مخططات التشتت قيم X و Y، وتضيف مخططات الفقاعات أحجام الفقاعات. استخدم طريقة إنشاء النقطة التي تتطابق مع نوع السلسلة. تنطبق خيارات مثل التداخل وعرض الفجوة فقط على مجموعات الأعمدة أو الأشرطة المتوافقة.

ما هو مجموعة سلاسل المخطط؟

يحتوي IChartSeriesGroup على سلاسل متوافقة تشترك في إعدادات تخطيط على مستوى المجموعة. يمكن أن يحتوي مخطط مركب على أكثر من مجموعة، لذلك لا يفرض تغيير المجموعة التي يُصل إليها من خلال سلسلة واحدة تعديل كل السلاسل في المخطط.

هل يحتوي المخطط الذي تم إنشاؤه حديثًا على بيانات افتراضية؟

نعم. بشكل افتراضي، يُنشئ IShapeCollection.addChart سلاسل، فئات، وقيم نموذجية. يمكنك تعديل تلك الخلايا أو مسح كل من مجموعات السلاسل والفئات قبل إضافة مجموعة بيانات مخصَّصة تمامًا. يمكن أيضًا تحميل نسخة تُنشئ مخططًا بدون بيانات افتراضية.

كيف ترتبط كائنات المخطط بخلايا دفتر العمل؟

تشير أسماء السلاسل، تسميات الفئات، وقيم نقاط البيانات إلى خلايا في IChartDataWorkbook. يؤدي تعديل خلية مُشار إليها إلى تحديث العنصر المقابل في المخطط. عند بناء بيانات مخصَّصة، حافظ على توافق صفوف الفئات وصفوف قيم السلاسل بحيث تُرسم كل نقطة تحت الفئة المقصودة.

كيف أقوم بمسح نقطة واحدة بدلًا من مسح السلسلة بأكملها؟

عيّن خلية القيمة ذات الصلة إلى null للاحتفاظ بموضع الفئة للنقطة كقيمة فارغة. استخدم IChartDataPointCollection.clear فقط عندما ترغب في إزالة جميع النقاط من تلك السلسلة.

كيف تُعرَض النقاط الفارغة؟

النتيجة تعتمد على نوع المخطط والقيمة المكوَّنة عبر IChart.setDisplayBlanksAs. يمكن للمخططات المدعومة عرض الفراغات ك فجوات، كقيم صفرية، أو بربط النقاط المجاورة. اختر الإعداد الذي يعكس معنى البيانات المفقودة في عرضك. راجع Control the Display of Empty Cells للحصول على مثال كامل ومقارنة بصرية.

كيف يتم تنسيق القيم السالبة؟

بالنسبة إلى السلاسل المدعومة من الأشرطة، الأعمدة، والفقاعات، استدعِ IChartSeries.setInvertIfNegative وعين اللون العائد من IChartSeries.getInvertedSolidFillColor. يمكنك تجاوز السلوك لنقطة فردية باستخدام IChartDataPoint.setInvertIfNegative. تؤثر هذه الأساليب على التنسيق، وليس على القيم الرقمية المخزنة.

أي تنسيق ينتصر عندما يتم تنسيق كل من السلسلة والنقطة؟

تأخذ تنسيقات النقطة الصريحة الأولوية لتلك النقطة. تستمر النقاط الأخرى في استخدام تنسيق السلسلة الصريح أو، عندما لا يُعرَّف تنسيق السلسلة، النمط والموضوع التلقائي للمخطط. تتحكم إعدادات المجموعة مثل التداخل وعرض الفجوة في التخطيط ولا تُعيد كتابة تنسيق النقطة.

هل هناك حد لعدد السلاسل التي يمكن أن يحتويها المخطط؟

لا يفرض Aspose.Slides حدًا ثابتًا منفصلًا لعدد السلاسل. في الواقع، تحدد قيود ملف العرض التقديمي، الذاكرة المتاحة، وقت العرض، وقابلية قراءة المخطط حدًا عمليًا.

ماذا يجب أن أغيّر عندما تكون الأعمدة قريبة جدًا من بعضها أو بعيدًا جدًا؟

استدعِ IChartSeriesGroup.setGapWidth على مجموعة السلاسل الأصلية المناسبة. زِد القيمة لتوسيع المسافة بين العناقيد، أو قلّلها لتقريب العناقيد من بعضها.