اعمال فرمول‌های کاربرگ نمودار در ارائه‌ها بر روی Android

این صفحه درباره چیست

اعمال فرمول‌های شبیه Excel در Aspose.Slides برای Android از طریق کاربرگ‌های نمودار Java، بازمحاسبه مقادیر و استفاده از نتایج در نمودارهای PowerPoint.

بررسی کلی

نمودارهای PowerPoint معمولاً داده‌های منبع خود را در یک کاربرگ توکار ذخیره می‌کنند. در Aspose.Slides برای Android از طریق Java می‌توانید از طریق کتاب‌کار داده‌های نمودار به آن کاربرگ دسترسی پیدا کنید، مقادیر ورودی را بنویسید، فرمول‌ها را به سلول‌ها اختصاص دهید، فرمول‌های پشتیبانی‌شده را محاسبه کنید و از سلول‌های محاسبه‌شده به عنوان داده‌های نمودار استفاده کنید.

این مقاله جریان کار کامل فرمول‌ها را توضیح می‌دهد: ایجاد یک نمودار، پر کردن کاربرگ آن، اختصاص فرمول‌های سبک A1 یا R1C1، بازمحاسبه آن‌ها، خواندن مقادیر محاسبه‌شده، اتصال آن سلول‌ها به یک سری نمودار و ذخیره ارائه. همچنین نحو فرمول‌های پشتیبانی‌شده، زیرمجموعه توابع داخلی، مقادیر کش‌شده، فرمول‌های غیرپشتیبانی‌شده و خطاهای خاص صفحه‌گسترده را شرح می‌دهد.

کاربرگ‌های نمودار و فرمول‌ها

یک کاربرگ نمودار شامل دسته‌بندی‌ها، نام‌های سری و مقادیری است که توسط نمودار استفاده می‌شوند. در PowerPoint می‌توانید کاربرگ را با باز کردن ویرایشگر داده‌های نمودار مشاهده کنید:

نمودار PowerPoint با کاربرگ توکار باز که داده‌های دسته‌بندی و سری را نشان می‌دهد

در Aspose.Slides، کاربرگ از طریق اینترفیس IChartDataWorkbook در دسترس است. برای فرمول‌های سبک A1 از IChartDataCell.setFormula و برای فرمول‌های سبک R1C1 از IChartDataCell.setR1C1Formula استفاده کنید. پس از تغییر سلول‌های ورودی یا فرمول‌ها، برای بازمحاسبه فرمول‌های پشتیبانی‌شده و به‌روز شدن مقادیر سلول‌های متناظر، متد IChartDataWorkbook.calculateFormulas را فراخوانی کنید.

یک سلول محاسبه‌شده همچنان نتیجه خود را از طریق IChartDataCell.getValue در دسترس می‌گذارد. این موضوع زمانی مهم است که نیاز به بررسی نتیجه یک فرمول در کد دارید یا می‌خواهید سلول را به عنوان یک نقطه داده برای نمودار استفاده کنید.

ایجاد نمودار و محاسبه فرمول‌های کاربرگ

مثال زیر یک جریان کار انتها‑به‑انتها را نشان می‌دهد. این مثال یک نمودار ستونی خوشه‌ای ایجاد می‌کند، داده‌های نمونه را پاک می‌کند، مقادیر درآمد و هزینه فصلی را می‌نویسد، سود را با فرمول‌ها محاسبه می‌کند، نتایج را می‌خواند، سلول‌های محاسبه‌شده را به عنوان مقادیر نمودار استفاده می‌کند و ارائه را ذخیره می‌نماید.

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, 600, 350);
    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
    int worksheetIndex = 0;

    chart.getChartData().getSeries().clear();
    chart.getChartData().getCategories().clear();
    workbook.clear(worksheetIndex);

    IChartDataCell category1 = workbook.getCell(worksheetIndex, "A2", "Q1");
    IChartDataCell category2 = workbook.getCell(worksheetIndex, "A3", "Q2");
    IChartDataCell category3 = workbook.getCell(worksheetIndex, "A4", "Q3");

    workbook.getCell(worksheetIndex, "B1", "Revenue");
    workbook.getCell(worksheetIndex, "C1", "Expenses");
    workbook.getCell(worksheetIndex, "D1", "Profit");

    workbook.getCell(worksheetIndex, "B2").setValue(120.0);
    workbook.getCell(worksheetIndex, "C2").setValue(80.0);
    workbook.getCell(worksheetIndex, "B3").setValue(150.0);
    workbook.getCell(worksheetIndex, "C3").setValue(95.0);
    workbook.getCell(worksheetIndex, "B4").setValue(135.0);
    workbook.getCell(worksheetIndex, "C4").setValue(110.0);

    IChartDataCell profit1 = workbook.getCell(worksheetIndex, "D2");
    IChartDataCell profit2 = workbook.getCell(worksheetIndex, "D3");
    IChartDataCell profit3 = workbook.getCell(worksheetIndex, "D4");

    profit1.setFormula("B2-C2");
    profit2.setFormula("B3-C3");
    profit3.setFormula("B4-C4");

    workbook.calculateFormulas();

    double q1Profit = ((Number) profit1.getValue()).doubleValue(); // 40
    double q2Profit = ((Number) profit2.getValue()).doubleValue(); // 55
    double q3Profit = ((Number) profit3.getValue()).doubleValue(); // 25

    System.out.println("Q1 profit: " + q1Profit);
    System.out.println("Q2 profit: " + q2Profit);
    System.out.println("Q3 profit: " + q3Profit);

    chart.getChartData().getCategories().add(category1);
    chart.getChartData().getCategories().add(category2);
    chart.getChartData().getCategories().add(category3);

    IChartSeries profitSeries = chart.getChartData().getSeries().add(workbook.getCell(worksheetIndex, "D1"), chart.getType());
    profitSeries.getDataPoints().addDataPointForBarSeries(profit1);
    profitSeries.getDataPoints().addDataPointForBarSeries(profit2);
    profitSeries.getDataPoints().addDataPointForBarSeries(profit3);
    profitSeries.getLabels().getDefaultDataLabelFormat().setShowValue(true);

    presentation.save("chart-formulas.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

نقاط داده نمودار به D2:D4 ارجاع می‌دهند، بنابراین نمودار از مقادیر سود محاسبه‌شده استفاده می‌کند. در این جریان کار هیچ فراخوانی جداگانه‌ای برای تازه‑سازی نمودار وجود ندارد: ابتدا کتاب‌کار را بازمحاسبه کنید، سپس داده‌های نمودار را که به سلول‌های محاسبه‌شده اشاره می‌کنند، استفاده یا ذخیره کنید.

استفاده از فرمول‌های سبک A1

نویسندگی A1 ستون‌ها را با حروف و سطرها را با اعداد شناسایی می‌کند. عبارات سبک A1 را از طریق IChartDataCell.setFormula اختصاص دهید.

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, 500, 300);
    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();

    workbook.getCell(0, "C3").setValue(10);
    workbook.getCell(0, "F2").setValue(2);
    workbook.getCell(0, "G2").setValue(3);
    workbook.getCell(0, "H2").setValue(4);

    IChartDataCell cell = workbook.getCell(0, "A2");
    cell.setFormula("C3+SUM(F2:H2)");

    workbook.calculateFormulas();

    Object value = cell.getValue(); // 19
} finally {
    presentation.dispose();
}

فرم‌های مرجع رایج A1 به شرح زیر هستند:

مرجع	نسبی	مطلق	مختلط
سلول	`A2`	`$A$2`	`A$2`, `$A2`
سطر	`2:2`	`$2:$2`	—
ستون	`A:A`	`$A:$A`	—
محدوده	`A2:C4`	`$A$2:$C$4`	`A$2:$C4`, `$A2:C$4`

مراجع نسبی ممکن است هنگام جابه‌جایی یا کپی فرمول توسط یک برنامه صفحه‌گسترده تغییر کنند. مراجع مطلق هر دو مختصات را ثابت نگه می‌دارند، در حالی که مراجع مختلط فقط یک سطر یا یک ستون را ثابت می‌کنند.

استفاده از فرمول‌های سبک R1C1

نویسندگی R1C1 سطرها و ستون‌ها را به‌صورت عددی شناسایی می‌کند. مراجع نسبی از جابه‌جایی در داخل کروشه استفاده می‌کنند. این نحو را از طریق IChartDataCell.setR1C1Formula اختصاص دهید.

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, 500, 300);
    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();

    workbook.getCell(0, "B2").setValue(12);
    workbook.getCell(0, "C2").setValue(5);

    IChartDataCell cell = workbook.getCell(0, "D2");
    cell.setR1C1Formula("RC[-2]-RC[-1]");

    workbook.calculateFormulas();

    Object value = cell.getValue(); // 7
} finally {
    presentation.dispose();
}

فرم‌های مرجع رایج R1C1 به شرح زیر هستند:

مرجع	نسبی	مطلق	مختلط
سلول	`R[2]C[3]`	`R2C3`	`R2C[3]`, `R[2]C3`
سطر	`R[2]`	`R2`	—
ستون	`C[3]`	`C3`	—
محدوده	`R[2]C[3]:R[5]C[7]`	`R2C3:R5C7`	`R2C3:R[5]C[7]`, `R[2]C3:R5C[7]`

به عنوان مثال، در سلول D2، RC[-2] به سلول همان سطر دو ستون به سمت چپ (B2) اشاره می‌کند.

ثابت‌ها و عملگرهای فرمول

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

ثابت‌ها و مقدارهای ثابت

نوع	مثال‌ها	توضیحات
منطقی	`TRUE`, `FALSE`	می‌توانند مستقیماً در عبارات منطقی مانند `A2=TRUE` استفاده شوند.
عددی	`1`, `0.5`, `.3`, `1E-2`	نوشتار اعشاری و علمی پشتیبانی می‌شود.
رشته	`"abc"`, `"2/3/2020 12:00"`	مقادیر متنی داخل کوتیشن‌های دوتایی در فرمول قرار می‌گیرند.
نتیجه‌ٔ خطا	`#DIV/0!`, `#N/A`, `#REF!`	یک فرمول معتبر می‌تواند به جای نتیجه عادی، مقدار خطای صفحه‌گسترده را برگرداند.

این مثال چندین نوع ثابت را به کار می‌برد:

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, 500, 300);
    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();

    workbook.getCell(0, "A2").setValue(false);
    workbook.getCell(0, "B2").setFormula("A2=TRUE");
    workbook.getCell(0, "C2").setFormula("1+0.5");
    workbook.getCell(0, "D2").setFormula(".3*1E-2");
    workbook.getCell(0, "E2").setFormula("\"abc\"");
    workbook.getCell(0, "F2").setFormula("2/0");

    workbook.calculateFormulas();

    Object logicalValue = workbook.getCell(0, "B2").getValue(); // نادرست
    Object numericValue = workbook.getCell(0, "C2").getValue(); // 1.5
    Object scientificValue = workbook.getCell(0, "D2").getValue(); // 0.003
    Object stringValue = workbook.getCell(0, "E2").getValue(); // abc
    Object errorValue = workbook.getCell(0, "F2").getValue(); // #DIV/0!
} finally {
    presentation.dispose();
}

عملگرهای حسابی

عملگر	معنای فعل	مثال
`+`	جمع یا مثبت یک‌طرفه	`2+3`
`-`	تفریق یا منفی یک‌طرفه	`2-3`, `-3`
`*`	ضرب	`2*3`
`/`	تقسیم	`2/3`
`%`	درصد	`30%`
`^`	توان	`2^3`

برای واضح کردن ترتیب ارزیابی از پرانتز استفاده کنید، مثلاً (A2+B2)*C2.

عملگرهای مقایسه‌ای

عبارات مقایسه‌ای مقادیر منطقی برمی‌گردانند.

عملگر	معنای فعل	مثال
`=`	مساوی	`A2=3`
`<>`	نامساوی	`A2<>3`
`>`	بزرگ‌تر	`A2>3`
`>=`	بزرگ‌تر یا مساوی	`A2>=3`
`<`	کوچک‌تر	`A2<3`
`<=`	کوچک‌تر یا مساوی	`A2<=3`

توابع پیش‌تعریف‌شده پشتیبانی‌شده

Aspose.Slides یک ارزیاب فرمول داخلی برای کاربرگ‌های نمودار دارد، اما یک موتور محاسبه کامل Excel نیست. مجموعهٔ توابع مستند شده به توابع زیر محدود می‌شود. فرض نکنید که هر تابع دلخواه Excel می‌تواند توسط IChartDataWorkbook.calculateFormulas بازمحاسبه شود.

تابع	هدف یا فرم پشتیبانی‌شده	مثال
`ABS`	مقدار مطلق	`ABS(A2)`
`AVERAGE`	میانگین حسابی	`AVERAGE(B2:B5)`
`CEILING`	گرد کردن عدد به سمت بالا تا مضربی	`CEILING(A2,5)`
`CHOOSE`	انتخاب مقدار بر اساس شاخص	`CHOOSE(A2,"Low","High")`
`CONCAT`	ترکیب مقادیر متنی	`CONCAT(A2,B2)`
`CONCATENATE`	ترکیب مقادیر متنی	`CONCATENATE(A2," ",B2)`
`DATE`	ساخت مقدار تاریخ با استفاده از سیستم تاریخ 1900	`DATE(2026,8,19)`
`DAYS`	برگرداندن تعداد روزهای بین تاریخ‌ها	`DAYS(B2,A2)`
`FIND`	یافتن یک متن داخل متن دیگر	`FIND("-",A2)`
`FINDB`	جستجوی بایت‑محور متن	`FINDB("a",A2)`
`IF`	نتیجهٔ شرطی	`IF(A2>0,A2,0)`
`INDEX`	فرم مرجع	`INDEX(A2:C4,2,3)`
`LOOKUP`	فرم برداری	`LOOKUP(A2,B2:B5,C2:C5)`
`MATCH`	فرم برداری	`MATCH(A2,B2:B5,0)`
`MAX`	حداکثر مقدار	`MAX(B2:B5)`
`SUM`	مجموع مقادیر	`SUM(B2:B5)`
`VLOOKUP`	جستجوی عمودی	`VLOOKUP(A2,B2:D10,3,FALSE)`

محدودیت‌های نشان داده شده در جدول مهم هستند: INDEX به صورت مرجع مستند شده، در حالی که LOOKUP و MATCH به شکل برداری مستند هستند. DATE از سیستم تاریخ 1900 استفاده می‌کند. ویژگی‌ها و توابعی که در اینجا فهرست نشده‌اند باید به‌عنوان غیرقابل پشتیبانی توسط ارزیاب فرمول Aspose.Slides در نظر گرفته شوند، مگر اینکه جداگانه مستند شده باشند.

محاسبه فرمول‌ها با فرهنگ ترجیحی

برخی توابع کتاب‌کار نمودار متن را بر پایهٔ قوانین مخصوص به فرهنگ تفسیر می‌کنند. این موضوع به‌ویژه برای توابعی که برای زبان‌های استفاده‌کننده از مجموعه کاراکترهای دو بایتی (DBCS) طراحی شده‌اند مهم است. برای محاسبه صحیح چنین فرمول‌هایی، ابتدا یک شیء LoadOptions ایجاد کنید، فرهنگ ترجیحی را با SpreadsheetOptions.setPreferredCulture تنظیم کنید، گزینه‌های صفحه‌گسترده را از طریق LoadOptions.setSpreadsheetOptions اختصاص دهید و سپس ارائه را بارگذاری کنید.

مثال زیر فرهنگ ژاپنی را انتخاب می‌کند، ارائه‌ای را با گزینه‌های بارگذاری پیکربندی‌شده باز می‌کند و برای هر کتاب‌کار نمودار متد IChartDataWorkbook.calculateFormulas را فراخوانی می‌نماید:

import com.aspose.slides.*;
import java.util.Locale;

Locale japaneseCulture = Locale.forLanguageTag("ja-JP");

ISpreadsheetOptions spreadsheetOptions = new SpreadsheetOptions();
spreadsheetOptions.setPreferredCulture(japaneseCulture);

LoadOptions loadOptions = new LoadOptions();
loadOptions.setSpreadsheetOptions(spreadsheetOptions);

Presentation presentation = new Presentation("presentation.pptx", loadOptions);
try {
    for (ISlide slide : presentation.getSlides()) {
        for (IShape shape : slide.getShapes()) {
            if (shape instanceof IChart) {
                IChart chart = (IChart) shape;
                chart.getChartData().getChartDataWorkbook().calculateFormulas();
            }
        }
    }
} finally {
    presentation.dispose();
}

فرهنگ ترجیحی جزء تنظیمات بارگذاری ارائه است، بنابراین قبل از ایجاد شیء Presentation مقداردهی شود. از فرهنگی استفاده کنید که توسط فرمول‌های کتاب‌کار مورد انتظار باشد؛ برای مثال برای فرمول‌هایی که باید با قوانین محاسبهٔ DBCS ژاپنی سازگار باشند، ja-JP را به‌کار ببرید.

بازمحاسبه و مقادیر کش‌شده

فایل‌های صفحه‌گسترده معمولاً هم فرمول و هم آخرین مقدار محاسبه‌شده را ذخیره می‌کنند. بنابراین Aspose.Slides می‌تواند مقدار کش‌شده را از IChartDataCell.getValue بخواند زمانی که ارائه بارگذاری می‌شود و دادهٔ نمودار مربوطه تغییر نکرده باشد.

پس از تغییر سلول‌های ورودی یا فرمول‌ها، به نتایج کش‌شده قدیم تکیه نکنید. پیش از خواندن مقادیر محاسبه‌شده یا ذخیره داده‌های نموداری که به آن‌ها وابسته‌اند، متد IChartDataWorkbook.calculateFormulas را فراخوانی کنید.

برای فرمول‌هایی که خارج از زیرمجموعهٔ پشتیبانی‌شده هستند، ممکن است Aspose.Slides نتواند فرمول را تجزیه یا وابستگی‌های آن را تعیین کند. اگر کتاب‌کار اصلاح شده باشد، مقدار کش‌شدهٔ قبلی دیگر معتبر نیست. در این شرایط، خواندن مقدار سلولی با دادهٔ غیرقابل پشتیبانی می‌تواند استثنای CellUnsupportedDataException را پرتاب کند.

اگر نمودار شما به توابع Excel وابسته باشد که Aspose.Slides آن‌ها را ارزیابی نمی‌کند، آن فرمول‌ها را با یک موتور صفحه‌گستردهٔ پشتیبانی‌کننده محاسبه کنید و مقادیر حاصل را به کتاب‌کار نمودار بنویسید. از جایگزینی فرمول‌های غیرقابل پشتیبانی با مقادیر حدسی خودداری کنید.

مدیریت خطاهای فرمول

دو نوع مشکل متفاوت وجود دارد.

یک فرمول می‌تواند معتبر باشد اما نتیجهٔ خطای صفحه‌گسترده‌ای مانند #DIV/0!, #N/A, #NAME?, #NULL!, #NUM!, #REF! یا #VALUE! تولید کند. در این حالت توکن خطا یک نتیجهٔ سلول است و می‌تواند از طریق IChartDataCell.getValue بازگردانده شود.

یک فرمول ممکن است در مرحلهٔ تجزیه، مرجع، وابستگی یا سطح دادهٔ پشتیبانی‌شده شکست بخورد. Aspose.Slides برای این موارد استثنای خاص صفحه‌گسترده ارائه می‌دهد: CellInvalidFormulaException, CellInvalidReferenceException, CellCircularReferenceException و CellUnsupportedDataException.

هنگامی که فرمول‌ها از قالب‌ها یا ورودی کاربر می‌آیند، این استثناها را در اطراف بازمحاسبه و دسترسی به مقدار مدیریت کنید:

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, 500, 300);
    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
    IChartDataCell cell = workbook.getCell(0, "A2");
    cell.setFormula("SUM(B2:B5)");

    try {
        workbook.calculateFormulas();
        System.out.println(cell.getValue());
    } catch (CellInvalidFormulaException ex) {
        System.err.println("Invalid formula: " + ex.getMessage());
    } catch (CellInvalidReferenceException ex) {
        System.err.println("Invalid cell reference: " + ex.getMessage());
    } catch (CellCircularReferenceException ex) {
        System.err.println("Circular reference: " + ex.getMessage());
    } catch (CellUnsupportedDataException ex) {
        System.err.println("Unsupported spreadsheet data: " + ex.getMessage());
    }
} finally {
    presentation.dispose();
}

محدودیت‌های عملی

پشتیبانی از فرمول‌ها در کاربرگ‌های نمودار برای یک زیرمجموعهٔ تعریف‌شده از محاسبات صفحه‌گسترده هدف‌گذاری شده است و نه برای سازگاری کامل با Excel. هنگام طراحی جریان کار گزارش‌گیری این محدودیت‌ها را مدنظر داشته باشید:

فقط از ثابت‌ها، عملگرها، مراجع و توابع مستند شده‌ای استفاده کنید که می‌خواهید Aspose.Slides آن‌ها را بازمحاسبه کند.
پس از تغییر سلول‌هایی که نتایج فرمول‌ها به آن‌ها وابسته‌اند، بازمحاسبه کنید.
مقادیر کش‌شدهٔ ارائه‌های بارگذاری‌شده را به‌عنوان تصویر لحظه‌ای در نظر بگیرید، نه به‌عنوان جایگزینی برای بازمحاسبه پس از ویرایش.
فرمول‌های قالب‌های موجود را قبل از اتکا به مقادیر محاسبه‌شده آن‌ها تست کنید، بویژه اگر از توابع خارج از فهرست مستند استفاده می‌شوند.
برای فرمول‌هایی که به یک موتور کامل محاسبه صفحه‌گسترده نیاز دارند، آن‌ها را به‌صورت خارجی محاسبه کنید و سپس کتاب‌کار نمودار را با مقادیر حاصل به‌روزرسانی کنید.

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

تفاوت بین IChartDataCell.setFormula و IChartDataCell.setR1C1Formula چیست؟

IChartDataCell.setFormula یک عبارت سبک A1 مانند B2-C2 را ذخیره می‌کند. IChartDataCell.setR1C1Formula یک عبارت سبک R1C1 مانند RC[-2]-RC[-1] را ذخیره می‌کند. نوشتاری را که با نحوهٔ تولید یا کپی فرمول‌های خود هم‌خوانی دارد انتخاب کنید.

آیا پس از محاسبه باید خود سلول یا مقدار آن را بخوانم؟

IChartDataWorkbook.getCell یک شیء IChartDataCell برمی‌گرداند. برای به‌دست آوردن نتیجهٔ محاسبه‌شده، پس از بازمحاسبه متد IChartDataCell.getValue را فراخوانی کنید.

چه زمانی باید IChartDataWorkbook.calculateFormulas را فراخوانی کنم؟

پس از تغییر مقادیر ورودی یا فرمول‌ها و پیش از این که به نتایج محاسبه‌شده وابسته باشید، متد IChartDataWorkbook.calculateFormulas را فراخوانی کنید. این کار مقادیر فرمول‌هایی را که ارزیاب داخلی پشتیبانی می‌کند به‌روز می‌کند.

آیا Aspose.Slides از تمام توابع Excel پشتیبانی می‌کند؟

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

اگر یک ارائهٔ بارگذاری‌شده شامل فرمولی غیرقابل پشتیبانی باشد چه می‌شود؟

اگر دادهٔ نمودار تغییر نکرده باشد، ممکن است کتاب‌کار هنوز مقدار کش‌شدهٔ قبلی را داشته باشد. پس از تغییر داده‌های مرتبط، آن مقدار کش‌شده ممکن است دیگر معتبر نباشد. دسترسی به سلولی که فرمولش قابل پردازش نیست می‌تواند استثنای CellUnsupportedDataException را پرتاب کند.

آیا مقادیر خطای فرمول همان استثناهای Java هستند؟

خیر. مقداری مانند #DIV/0! یک مقدار صفحه‌گسترده است که توسط یک محاسبهٔ معتبر تولید می‌شود. استثنائاتی مانند CellInvalidFormulaException یا CellCircularReferenceException نشان می‌دهند که فرمول نمی‌تواند به‌طور عادی پردازش شود.

آیا نمودار هنگام تغییر سلول فرمول به‌صورت خودکار به‌روزرسانی می‌شود؟

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

آیا نمودارها می‌توانند از یک کتاب‌کار Excel خارجی استفاده کنند؟

بله، دادهٔ نمودار می‌تواند از طریق API دادهٔ نمودار به یک کتاب‌کار خارجی متصل شود. با این حال، گردش کار محاسبهٔ فرمول توضیح داده‌شده در این مقاله به کتاب‌کار دادهٔ نمودار و زیرمجموعهٔ فرمول‌های ارزیابی‌شده توسط Aspose.Slides مربوط می‌شود. فرض نکنید که IChartDataWorkbook.calculateFormulas بازمحاسبهٔ کامل فرمول‌های دلخواه در یک فایل XLSX خارجی را فراهم می‌کند.

آیا می‌توانم از فرمول‌هایی استفاده کنم که به شیت یا کتاب‌کار دیگری ارجاع می‌دهند؟

مراجع شبیه به Excel ممکن است در کتاب‌کارهای نمودار وجود داشته باشد، اما ارزیابی فرمول توسط پارسر و مجموعه توابع پشتیبانی‌شده محدود است. اگر یک مرجع میان‑شیت یا خارجی ضروری است، دقیقاً همان فرمول را با نسخهٔ هدف Aspose.Slides خود اعتبارسنجی کنید. برای گردش کارهایی که نیاز به سازگاری گستردهٔ مراجع Excel دارند، کتاب‌کار را به‌صورت خارجی محاسبه کنید و مقادیر حل‌شده را به دادهٔ نمودار بنویسید.

آیا رشتهٔ فرمول باید با = شروع شود؟

نمونه‌های API Aspose.Slides عبارات مانند B2-C2 یا SUM(B2:B5) را بدون = پیشوندی اختصاص می‌دهند. استفاده از این فرم، فرمول‌های تولیدشده را با مثال‌های مستند API هم‌خوانی می‌دهد.

قالب‌بندی نمودارهای ارائه در اندروید انیمیشن نمودارهای PowerPoint در اندروید