مدیریت مجموعه داده‌های نمودار در ارائه‌ها با استفاده از JavaScript

نمای کلی

یک نمودار می‌تواند مقادیر ترسیم‌شده خود را در سلول‌های کتاب‌کار یا به‌صورت عددی مستقیم ذخیره کند. یک ChartSeries نمایانگر یک مجموعه از مقادیر مرتبط است و هر ChartDataPoint نمایانگر یک نقطه در آن مجموعه است. اشیاء ChartCategory برچسب‌ها یا مقادیر گروهی را که توسط مجموعه‌ها مشترک هستند فراهم می‌کنند. در نمودارهای ایجاد شده با داده‌های پیش‌فرض، نام‌های مجموعه، دسته‌ها و مقادیر نقاط از اشیاء ChartDataCell در کتاب‌کار نمودار استفاده می‌شود.

برای یک نمودار دسته‌ای معمولی، کتاب‌کار پیش‌فرض از ردیف 0 برای نام‌های مجموعه، ستون 0 برای نام‌های دسته و بقیهٔ سلول‌ها برای مقادیر مجموعه استفاده می‌کند. شاخص‌های برگه، ردیف و ستون که به ‎ChartDataWorkbook.getCell‎ ارسال می‌شوند صفر‑مبنا هستند. این چیدمان هنگام ایجاد نمودار با داده‌های پیش‌فرض مفید است، اما فرض نکنید که هر نمودار موجود از آن استفاده می‌کند. برای یک ارائهٔ بارگذاری‌شده، قبل از تغییر مقادیر کتاب‌کار سلول‌های مرجع شده توسط مجموعه‌ها، دسته‌ها و نقاط داده را بررسی کنید.

تنظیمات نمودار دارای سه محدودهٔ متفاوت هستند:

  • تنظیمات در سطح مجموعه، مانند ‎ChartSeries.getFormat‎، ظاهر پیش‌فرض همهٔ نقاط یک مجموعه را فراهم می‌کند.
  • تنظیمات نقطه‑داده، مانند ‎ChartDataPoint.getFormat‎، ظاهر مجموعه را برای یک نقطهٔ خاص بازنویسی می‌کند.
  • تنظیمات گروهی بر روی مجموعه‌های سازگاری که به همان ‎ChartSeriesGroup‎ تعلق دارند اعمال می‌شود. برای تنظیم گزینه‌هایی نظیر پوشش‌پذیری یا عرض فاصله، از ‎ChartSeries.getParentSeriesGroup‎ استفاده کنید.

زمانی که پر کردن صریح برای نقطه یا مجموعه‌ای تعیین نشده باشد، سبک و تم نمودار ظاهر خودکار را تعیین می‌کند. وقتی هم تنظیمات مجموعه و هم تنظیمات نقطه موجود باشد، تنظیمات نقطه برای آن نقطه اولویت دارد.

نمودار‑سری‑پاورپوینت

در یک نمودار استوانه‌ای خوشه‌ای، ببینید چگونه ‎changing the 3D series type or bar shape‎ بر اولین مجموعه تأثیر می‌گذارد.

تنظیم مقادیر مجموعه با عددهای صریح

از عددهای صریح زمانی استفاده کنید که مقادیر مجموعه از داده‌های برنامه یا محاسبات می‌آیند و نیازی به ارجاع به سلول‌های برگه کار نیست. قبل از اختصاص نتیجهٔ ‎getValue‎ هر نقطه، ‎setDataSourceTypeForValues‎ را با ‎DataSourceType.DoubleLiterals‎ فراخوانی کنید و سپس ‎setAsLiteralDouble‎ را اعمال کنید.

تنظیم مجموعهٔ کنترل‌کنندهٔ نوع منبع تمام مقادیر نقطه‌ها در آن مجموعه را تعیین می‌کند. هر مقدار نقطه با ‎getDataSourceType‎ نوع انتخاب‌شده را گزارش می‌دهد؛ آن را از طریق تنظیم مجموعه تغییر دهید. با ‎Worksheet‎، از ‎getAsCell‎ برای دسترسی به سلول مرجع استفاده کنید. با ‎DoubleLiterals‎، از ‎getAsLiteralDouble‎ یا ‎setAsLiteralDouble‎ برای خواندن یا نوشتن مستقیم عدد استفاده کنید.

مثال زیر یک نمودار ستونی با مجموعه‌ها و دسته‌های پیش‌فرض ایجاد می‌کند، سپس مقادیر محاسبه‌شدهٔ 10، 20 و … را به نقاط موجود مجموعهٔ اول اختصاص می‌دهد. سپس ارائه را ذخیره، باز می‌کند و مقادیر ذخیره‌شده را چاپ می‌کند.

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

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

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

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

const reopenedPresentation = new aspose.slides.Presentation("numeric_literals.pptx");
try {
    const reopenedSlide = reopenedPresentation.getSlides().get_Item(0);
    const reopenedChart = reopenedSlide.getShapes().get_Item(0);
    const reopenedSeries = reopenedChart.getChartData().getSeries().get_Item(0);
    for (let i = 0; i < reopenedSeries.getDataPoints().size(); i++) {
        const point = reopenedSeries.getDataPoints().get_Item(i);
        console.log(point.getValue().getAsLiteralDouble());
    }
} finally {
    reopenedPresentation.dispose();
}

نوع منبع مقدار نقطه جدا از ‎ChartData.getDataSourceType‎ است که پیکربندی کتاب‌کار داخلی یا خارجی نمودار را مشخص می‌کند. استفاده از عددهای صریح به تنهایی کتاب‌کار توکار را حذف نمی‌کند. در این مثال، کتاب‌کار برای برچسب‌های دسته، نام‌های مجموعه و سایر مجموعه‌ها در دسترس باقی می‌ماند. برای مدیریت کتاب‌کار، بخش ‎Chart Workbook‎ را ببینید.

برای نمودارهای پراکندگی و حبابی، از ‎setDataSourceTypeForXValues‎ و ‎setDataSourceTypeForYValues‎ برای انتخاب منابع ‎getXValue‎ و ‎getYValue‎ استفاده کنید. نمودارهای حبابی همچنین از ‎setDataSourceTypeForBubbleSizes‎ برای ‎getBubbleSize‎ بهره می‌‏برند. هر منبع مربوطه را قبل از اختصاص عدد با DoubleLiterals تنظیم کنید و سپس از روش ‎setAsLiteralDouble‎ استفاده کنید.

تنظیم تداخل مجموعهٔ نمودار

‎ChartSeries.getOverlap‎ گزارش می‌دهد که میله‌ها یا ستون‌ها در یک نمودار دو‑بعدی تا چه حد هم‑پوشانی دارند، مقادیر بین ‎-100‎ تا ‎100‎ درصد. این یک تصویر‌نگاری فقط‑خواندنی از تنظیمات گروه مجموعه والد است. برای به‑روزرسانی تمام مجموعه‌های سازگار در آن گروه، از ‎ChartSeriesGroup.setOverlap‎ استفاده کنید. این گزینه برای انواع نمودارهایی که میله‌ها یا ستون‌های گروهی نمایش می‌دهند اعمال می‌شود؛ برای گروه‌های مجموعهٔ نامرتبط در یک نمودار ترکیبی اثر ندارد.

مثال زیر تداخل را برای گروهی که شامل اولین مجموعه است تنظیم می‌کند:

const aspose = {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const firstSlideIndex = 0;
const firstSeriesIndex = 0;
const overlapPercent = java.newByte(30);

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    // چارت جدید شامل مجموعه‌های نمونه، دسته‌ها و مقادیر است.
    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

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

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

نتیجه:

تداخل مجموعه‌ها

تغییر رنگ پر کردن مجموعه

از ‎ChartSeries.getFormat‎ برای تنظیم پر کردن پیش‌فرض تمام مجموعه استفاده کنید. اگر یک نقطه قبلاً پر کردن صریح داشته باشد، تنظیم ‎ChartDataPoint.getFormat‎ آن، پر کردن مجموعه را برای همان نقطه بازنویسی می‌کند.

مثال زیر پر کردن آبی ثابت را به اولین مجموعه اعمال می‌کند:

const aspose = {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const firstSlideIndex = 0;
const firstSeriesIndex = 0;
const solidFillType = java.newByte(aspose.slides.FillType.Solid);
const blueColor = java.getStaticFieldValue("java.awt.Color", "BLUE");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

    const series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    series.getFormat().getFill().setFillType(solidFillType);
    series.getFormat().getFill().getSolidFillColor().setColor(blueColor);

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

نتیجه:

رنگ مجموعه

تغییر نام مجموعه

نام یک مجموعه در کتاب‌کار داده‌های نمودار ذخیره می‌شود و به‌طور معمول در افسانه (legend) نمایش داده می‌شود. در کتاب‌کار پیش‌فرض ایجاد شده برای یک نمودار ستون خوشه‌ای، سلول ‎B1‎ (ردیف 0، ستون 1) شامل نام اولین مجموعه است. ثابت‌های نام‌گذاری در مثال زیر این ساختار را واضح می‌کند:

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const firstSlideIndex = 0;
const worksheetIndex = 0;
const seriesNameRowIndex = 0;
const firstSeriesColumnIndex = 1;

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

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

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

همچنین می‌توانید سلولی را که توسط ‎ChartSeries.getName‎ ارجاع داده می‌شود، به‌روزرسانی کنید. این روش از فرض ردیف و ستون خاصی در یک نمودار موجود جلوگیری می‌کند:

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const firstSlideIndex = 0;
const firstSeriesIndex = 0;
const firstNameCellIndex = 0;

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

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

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

نتیجه:

نام مجموعه

ایجاد مجموعه‌ای با نام از چند سلول

یک نام مجموعه ترکیبی زمانی مفید است که نام محصول و بازهٔ گزارش‌گیری در سلول‌های جداگانهٔ کتاب‌کار ذخیره شوند. به‌عنوان مثال، می‌توانید Product A در ‎B1‎ و 2026 در ‎C1‎ را به یک نام مجموعه ترکیب کنید در حالی که هر دو بخش به سلول‌های منبع خود متصل می‌مانند.

از ‎ChartDataWorkbook.getCellCollection‎ برای دریافت محدودهٔ نام استفاده کنید، سپس آن مجموعه را به ‎ChartSeriesCollection.add‎ بدهید. آرگومان ‎skipHiddenCells‎ تعیین می‌کند که آیا سلول‌های مخفی شامل شوند یا نه: true آنها را مستثنی می‌کند، false شامل می‌کند. این مثال از false برای شامل شدن تمام سلول‌های محدودهٔ نام استفاده می‌کند.

مثال زیر یک ارائه با یک مجموعه و دو نقطه داده ایجاد می‌کند. سلول‌های ‎B1:C1‎ فقط نام مجموعه را فراهم می‌کنند؛ ‎A2:A3‎ برچسب‌های دسته و ‎B2:B3‎ مقادیر عددی را فراهم می‌کنند.

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 50, 50, 620, 180);

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

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

    // این دو سلول نام مجموعه را تامین می‌کنند.
    workbook.getCell(0, 0, 1, "Product A");
    workbook.getCell(0, 0, 2, "2026");
    const nameCells = workbook.getCellCollection("Sheet1!$B$1:$C$1", false);
    const series = chart.getChartData().getSeries().add(nameCells, aspose.slides.ChartType.ClusteredColumn);

    // سلول‌های جداگانه، دسته‌ها و نقاط داده عددی را تامین می‌کنند.
    const northCategory = workbook.getCell(0, 1, 0, "North");
    const southCategory = workbook.getCell(0, 2, 0, "South");
    chart.getChartData().getCategories().add(northCategory);
    chart.getChartData().getCategories().add(southCategory);
    const northValue = workbook.getCell(0, 1, 1, 120);
    const southValue = workbook.getCell(0, 2, 1, 150);
    series.getDataPoints().addDataPointForBarSeries(northValue);
    series.getDataPoints().addDataPointForBarSeries(southValue);

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

نام مجموعهٔ حاصل Product A 2026 است، با یک فاصله بین دو مقدار سلول. افسانه این را به‌عنوان یک ورودی برای هر دو ستون نمایش می‌دهد. تصویر زیر نتیجه را نشان می‌دهد:

نمودار ستونی با مقادیر North و South و نام مجموعه ترکیبی Product A 2026 در افسانه

دریافت رنگ پر کردن خودکار مجموعه

‎ChartSeries.getAutomaticSeriesColor‎ رنگی را برمی‌گرداند که از شاخص مجموعه و سبک نمودار محاسبه می‌شود. این رنگ هنگامیکه پر کردن مجموعه صریح تعریف نشده باشد، به‌کار می‌رود. فراخوانی این متد رنگ محاسبه‌شده را می‌خواند؛ پر کردن جدیدی ایجاد نمی‌کند.

مثال زیر رنگ خودکار هر مجموعه پیش‌فرض را چاپ می‌کند:

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const firstSlideIndex = 0;

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

    const seriesCount = chart.getChartData().getSeries().size();
    for (let seriesIndex = 0; seriesIndex < seriesCount; seriesIndex++) {
        const series = chart.getChartData().getSeries().get_Item(seriesIndex);
        const automaticColor = series.getAutomaticSeriesColor();
        const automaticColorText = automaticColor.toString();
        console.log("Series " + seriesIndex + ": " + automaticColorText);
    }
} finally {
    presentation.dispose();
}

خروجی نمونه برای سبک پیش‌فرض نمودار:

Series 0: java.awt.Color[r=79,g=129,b=189]
Series 1: java.awt.Color[r=192,g=80,b=77]
Series 2: java.awt.Color[r=155,g=187,b=89]

رنگ‌های دقیق بسته به سبک و تم نمودار متفاوت هستند.

تنظیم رنگ پر کردن وارون برای مجموعهٔ نمودار

برای مجموعه‌های میله‌ای، ستونی و حبابی، ‎ChartSeries.setInvertIfNegative‎ می‌تواند مقادیر منفی را با پر کردن متفاوتی نمایش دهد. پر کردن معمولی مجموعه را به حالت ثابت تنظیم کنید، وارونگی را فعال کنید و رنگ منفی را از طریق ‎ChartSeries.getInvertedSolidFillColor‎ اختصاص دهید. اعداد منفی در کتاب‌کار تغییری نمی‌کنند؛ تنها رنگ نمایش آن‌ها تغییر می‌یابد.

مثال زیر داده‌های پیش‌فرض نمودار را با یک مجموعه جایگزین می‌کند. ردیف 0 برگه کار شامل نام مجموعه، ستون 0 شامل نام‌های دسته و ستون 1 شامل مقادیر است:

const aspose = {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const firstSlideIndex = 0;
const worksheetIndex = 0;
const headerRowIndex = 0;
const categoryColumnIndex = 0;
const firstSeriesColumnIndex = 1;
const firstDataRowIndex = 1;
const solidFillType = java.newByte(aspose.slides.FillType.Solid);
const redColor = java.getStaticFieldValue("java.awt.Color", "RED");

const categoryNames = ["Category 1", "Category 2", "Category 3"];
const seriesValues = [-20, 50, -30];

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);
    const chartData = chart.getChartData();
    const workbook = chartData.getChartDataWorkbook();

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

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

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

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

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

    const automaticSeriesColor = series.getAutomaticSeriesColor();
    series.getFormat().getFill().setFillType(solidFillType);
    series.getFormat().getFill().getSolidFillColor().setColor(automaticSeriesColor);
    series.setInvertIfNegative(true);
    series.getInvertedSolidFillColor().setColor(redColor);

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

نتیجه:

رنگ پر کردن ثابت وارون

می‌توانید وارونگی را برای یک نقطه توسط ‎ChartDataPoint.setInvertIfNegative‎ فعال کنید. در مثال زیر وارونگی برای مجموعه غیرفعال و فقط برای نقطهٔ انتخاب‌شده فعال است. این نقطه همچنین مقدار منفی دریافت می‌کند تا اثر قابل‌مشاهده باشد:

const aspose = {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const firstSlideIndex = 0;
const firstSeriesIndex = 0;
const targetDataPointIndex = 2;
const negativeValue = -30;
const solidFillType = java.newByte(aspose.slides.FillType.Solid);
const redColor = java.getStaticFieldValue("java.awt.Color", "RED");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

    const series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    const automaticSeriesColor = series.getAutomaticSeriesColor();
    series.getFormat().getFill().setFillType(solidFillType);
    series.getFormat().getFill().getSolidFillColor().setColor(automaticSeriesColor);
    series.getInvertedSolidFillColor().setColor(redColor);
    series.setInvertIfNegative(false);

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

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

پاک‌کردن مقدار نقطهٔ دادهٔ خاص

برای خالی کردن یک نقطه بدون حذف سایر نقاط، سلول کتاب‌کار آن را به null تنظیم کنید. در یک نمودار ستونی، مقدار ترسیم‌شده از طریق ‎ChartDataPoint.getValue‎ در دسترس است. نقطه داده در همان موقعیت دسته باقی می‌ماند، اما نمودار مقدار آن را به‌عنوان خالی براساس تنظیمات خالی‌بودن نمودار در نظر می‌گیرد.

مثال زیر تنها نقطه دوم مجموعهٔ اول را پاک می‌کند:

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const firstSlideIndex = 0;
const firstSeriesIndex = 0;
const targetDataPointIndex = 1;

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

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

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

نمودارهای پراکندگی از سلول‌های جداگانهٔ X و Y استفاده می‌کنند و نمودارهای حبابی نیز از یک سلول اندازه استفاده می‌کنند. فقط سلولی که نمایانگر مقداری است که می‌خواهید حذف کنید را پاک کنید. هنگام نیاز به حفظ سایر نقاط، ‎ChartDataPointCollection.clear‎ را صدا نزنید، زیرا این متد تمام نقاط دادهٔ مجموعه را حذف می‌کند.

کنترل نمایش سلول‌های خالی

سلول‌های مخفی که دارای مقادیر هستند موردی متفاوت نسبت به سلول‌های خالی هستند. برای شامل یا مستثنی کردن داده‌ها از ردیف‌ها و ستون‌های مخفی، به ‎Include Data from Hidden Rows and Columns‎ مراجعه کنید.

یک سلول کتاب‌کار خالی نشان‌دهندهٔ دادهٔ گمشده است؛ سلولی که ‎0‎ داشته باشد نشان‌دهندهٔ یک مقدار عددی شناخته‌شده است. برای خالی کردن یک سلول، ‎ChartDataCell.setValue‎ را با null فراخوانی کنید. عدد صفر عددی صفر می‌ماند بدون در نظر گرفتن تنظیم خالی‑سلول.

از ‎Chart.setDisplayBlanksAs‎ برای انتخاب نحوهٔ نمایش سلول‌های خالی استفاده کنید. این تنظیم برای کل نمودار اعمال می‌شود و نحوهٔ ترسیم خالی‌ها را بدون پر کردن سلول خالی با صفر یا مقدار درونیافته تغییر می‌دهد.

مثال زیر یک نمودار خطی با یک مجموعه ایجاد می‌کند، مقدار روز 3 را پاک می‌کند و همان نمودار را با هر حالت ذخیره می‌کند. نیازی به پروندهٔ ورودی نیست. ‎ChartDataWorkbook‎ از برگه 0، ستون 0 برای برچسب‌های دسته و ستون 1 برای مقادیر استفاده می‌کند؛ ردیف 0 نام مجموعه را نگه می‌دارد. دادهٔ نهایی 10, 20, empty, 30, 40 است.

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.LineWithMarkers, 40, 40, 640, 400);
    const chartData = chart.getChartData();
    const workbook = chartData.getChartDataWorkbook();

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

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

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

    // روز ۳ را واقعاً خالی بگذارید، در حالی که دسته‌بندی و نقطهٔ دادهٔ آن را حفظ می‌کنید.
    workbook.getCell(0, 3, 1).setValue(null);

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

هر پروندهٔ خروجی حالت انتخاب‌شده پیش از ذخیره‌سازی را ذخیره می‌کند: empty_cells_Gap.pptx، empty_cells_Zero.pptx و empty_cells_Span.pptx. برای ذخیرهٔ تنها یک نسخه، حالت دلخواه را تنظیم کنید و یک‌بار ارائه را ذخیره کنید.

مقایسهٔ زیر همان داده‌ها را در هر سه پرونده نشان می‌دهد. روز 3 در هر حالت در کتاب‌کار خالی است:

نمودارهای خطی با داده‌های یکسان: Gap خط را در روز 3 قطع می‌کند، Zero خط را به صفر می‌کشد، و Span روز 2 را به روز 4 وصل می‌کند.

اثر قابل مشاهده بسته به نوع نمودار متفاوت است. یک نمودار خطی سه حالت را به‌راحتی مقایسه می‌کند. نمودارهای میله‌ای و ستونی خطی برای اتصال بین دسته‌های گمشده ندارند، بنابراین Span نمی‌تواند بخشی که در بالا نشان داده شده است ایجاد کند؛ یک ستون گمشده و یک ستون صفر‑ارتفاع می‌توانند مشابه به‌نظر برسند. به‌طور مشابه، یک نمودار پراکندگی فقط با نشانگرها خطی برای اتصال ندارد. انتظار نتایج متمایز برای هر نوع نمودار را نداشته باشید؛ خروجی را برای نوعی که استفاده می‌کنید بررسی کنید.

تنظیم عرض فاصلهٔ مجموعه

عرض فاصلهٔ بین خوشه‌های میله‌ای یا ستونی، به‌صورت درصدی از عرض میله یا ستون محاسبه می‌شود. همانند تداخل، این تنظیم به گروه مجموعهٔ والد تعلق دارد نه به یک مجموعهٔ منفرد. یک بار برای گروه ‎ChartSeriesGroup.setGapWidth‎ فراخوانی کنید. مقدار بزرگ‌تر فضای بین خوشه‌ها را بیشتر می‌کند؛ مقدار کوچکتر آن‌ها را فشرده‌تر می‌سازد.

مثال زیر عرض فاصله را تغییر می‌دهد و تنها ارائهٔ نهایی را ذخیره می‌کند:

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const firstSlideIndex = 0;
const firstSeriesIndex = 0;
const gapWidthPercent = 30;

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.StackedColumn, 20, 20, 500, 200);

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

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

نتیجه:

عرض فاصله

نمایش یا مخفی‌کردن خطوط مجموعه

خطوط مجموعه به‌صورت بصری بخش‌های مربوط به یک نمودار را به‌هم می‌پیوندد. برای نمایش یا مخفی‌کردن آن‌ها در نمودارهای میله‌ای پشته‌ای و OfPie پشتیبانی‌شده، از ‎ChartSeriesGroup.setSeriesLines‎ استفاده کنید. در نمودارهای میله‌ای و ستونی پشته‌ای دو‑بعدی، این خطوط مرزهای پشتهٔ مربوطه را بین دسته‌ها متصل می‌کند. در نمودارهای Pie of Pie و Bar of Pie، این خطوط نمودار اصلی را به نمودار ثانویه متصل می‌کند. این تنظیم برای دیگر انواع نمودار عمومی نیست.

دست به گروه از طریق ‎ChartSeries.getParentSeriesGroup‎ بگیرید. تنظیم برای تمام مجموعه‌های آن گروه اعمال می‌شود. ‎ChartSeries.hasSeriesLines‎ فقط‑خواندنی است و تنظیم والد را نشان می‌دهد؛ برای به‌روزرسانی، setter گروه را فراخوانی کنید.

مثال زیر یک نمودار ‎PieOfPie‎ با داده‌های پیش‌فرض ایجاد می‌کند. همان نمودار را ابتدا با خطوط مجموعه فعال و سپس غیرفعال ذخیره می‌کند تا دو ارائه برای مقایسه تولید شود.

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.PieOfPie, 50, 50, 600, 400);
    const series = chart.getChartData().getSeries().get_Item(0);
    const seriesGroup = series.getParentSeriesGroup();

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

    seriesGroup.setSeriesLines(false);
    presentation.save("series_lines_disabled.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}
خطوط مجموعه فعال خطوط مجموعه غیرفعال
نمودار Pie of Pie با خطوط مجموعه فعال نمودار Pie of Pie با خطوط مجموعه غیرفعال
دو خط اصلی پیک را به پیک ثانویه وصل می‌کنند. هر دو پیک قابل مشاهده‌اند، اما خطوط اتصال مخفی‌اند.

خطوط مجموعه متفاوت از خطوط رهبری برچسب داده هستند که برچسب‌ها را به نقاط داده متصل می‌کنند؛ خطوط شبکه که فواصل را بر روی محورهای نمودار نشان می‌دهند؛ و خطوط در نمودار خطی که مقادیر داده‌ها را نشان می‌دهند. این تنظیم آن‌ها را کنترل نمی‌کند.

سوالات متداول

کدام انواع نمودار از مجموعه‌های داده پشتیبانی می‌کنند؟

تمام انواع نمودارهای نشان‌داده‌شده توسط شمارش ‎ChartType‎ از داده‌های نمودار استفاده می‌کنند، اما مجموعه‌های آن‌ها ساختار یا تنظیمات مقدار یکسانی ندارند. برای مثال، نمودارهای دسته‌ای از دسته‌ها و مقادیر استفاده می‌کنند، نمودارهای پراکندگی از مقادیر X و Y، و نمودارهای حبابی به اندازهٔ حباب افزوده می‌شود. از روش ایجاد نقطه‑داده‌ای که با نوع مجموعه سازگار است استفاده کنید. گزینه‌هایی نظیر تداخل و عرض فاصله فقط برای گروه‌های میله‌ای یا ستونی سازگار اعمال می‌شوند.

یک گروه مجموعهٔ نمودار چیست؟

یک ‎ChartSeriesGroup‎ شامل مجموعه‌های سازگاری است که تنظیمات ترسیم سطح‑گروه را به‌اشتراک می‌گذارند. یک نمودار ترکیبی می‌تواند بیش از یک گروه داشته باشد، بنابراین تغییر گروهی که از طریق یک مجموعه دسترسی پیدا می‌کنید لزوماً همهٔ مجموعه‌های نمودار را تغییر نمی‌دهد.

آیا یک نمودار تازه ایجاد‌شده داده‌های پیش‌فرض دارد؟

بله. به‌طور پیش‌فرض، ‎ShapeCollection.addChart‎ مجموعه‌ها، دسته‌ها و مقادیر نمونه ایجاد می‌کند. می‌توانید آن سلول‌ها را ویرایش کنید یا قبل از افزودن مجموعه دادهٔ کاملاً سفارشی، هر دو مجموعه و دسته‌ها را پاک کنید. یک overload نیز می‌تواند نمودار را بدون داده‌های پیش‌فرض ایجاد کند.

شیوهٔ اتصال اشیای نمودار به سلول‌های کتاب‌کار چگونه است؟

نام‌های مجموعه، برچسب‌های دسته و مقادیر نقطه‑داده به سلول‌های یک ‎ChartDataWorkbook‎ ارجاع می‌دهند. تغییر یک سلول مرجع‌دار، عنصر مربوط به نمودار را به‌روز می‌کند. هنگام ساخت داده‌های سفارشی، ردیف‌های دسته و ردیف‌های مقادیر مجموعه را هم‌راستا نگه‌دارید تا هر نقطه زیر دستهٔ موردنظر ترسیم شود.

چگونه یک نقطه را به‌جای کل مجموعه پاک کنم؟

سلول مقدار مربوطه را به null تنظیم کنید تا موقعیت دستهٔ نقطه به‌عنوان یک نقطهٔ خالی حفظ شود. ‎ChartDataPointCollection.clear‎ را فقط زمانی به‌کار ببرید که می‌خواهید تمام نقاط آن مجموعه حذف شوند، زیرا این متد تمام نقاط دادهٔ مجموعه را حذف می‌کند.

نقاط خالی چگونه نمایش داده می‌شوند؟

نتیجه بستگی به نوع نمودار و مقداری که از طریق ‎Chart.setDisplayBlanksAs‎ پیکربندی شده دارد. نمودارهای پشتیبانی‌شده می‌توانند خالی‌ها را به‌عنوان فاصله، مقدار صفر یا با اتصال نقاط همسایه نمایش دهند. تنظیمی را انتخاب کنید که معنای دادهٔ گمشده در ارائهٔ شما را بازتاب دهد. برای مثال کامل و مقایسهٔ بصری، بخش ‎Control the Display of Empty Cells‎ را ببینید.

مقادیر منفی چگونه قالب‌بندی می‌شوند؟

برای مجموعه‌های میله‌ای، ستونی و حبابی پشتیبانی‌شده، ‎ChartSeries.setInvertIfNegative‎ را فراخوانی کنید و رنگی که توسط ‎ChartSeries.getInvertedSolidFillColor‎ برگردانده می‌شود، تنظیم کنید. می‌توانید این رفتار را برای یک نقطهٔ جداگانه با ‎ChartDataPoint.setInvertIfNegative‎ بازنویسی کنید. این متدها تنها قالب‌بندی را تحت‌اثر قرار می‌دهند، نه مقادیر عددی ذخیره‌شده.

در صورتی که هم مجموعه و هم نقطه قالب‌بندی شوند، کدام‌یک برتر است؟

قالب‌بندی صریح نقطه‑داده برای آن نقطه اولویت دارد. سایر نقاط همچنان از قالب‌بندی صریح مجموعه یا، در صورت عدم تعریف قالب‌بندی مجموعه، از سبک و تم خودکار نمودار استفاده می‌کنند. تنظیمات گروهی مانند تداخل و عرض فاصله طرح‌بندی را کنترل می‌کنند و بازنویسی قالب‌بندی سطح نقطه نیستند.

آیا محدودیتی برای تعداد مجموعه‌هایی که یک نمودار می‌تواند داشته باشد وجود دارد؟

Aspose.Slides محدودیتی ثابت برای تعداد مجموعه‌ها تعیین نمی‌کند. در عمل، محدودیت‌های فایل ارائه، حافظهٔ موجود، زمان رندر و قابلیت خواندن نمودار تعیین‌کنندهٔ حد وجنی هستند.

چه کاری باید انجام داد وقتی ستون‌ها بیش از حد نزدیک یا دور از هم هستند؟

بر روی گروه مجموعهٔ والد مناسب، ‎ChartSeriesGroup.setGapWidth‎ را فراخوانی کنید. مقدار را افزایش دهید تا فضای بین خوشه‌ها بیشتر شود یا کاهش دهید تا خوشه‌ها نزدیک‌تر شوند.