Aspose.Slides FOSS
Java
چگونه با جداول در جاوا کار کنیم

چگونه با جداول در جاوا کار کنیم

Aspose.Slides FOSS for Java از ایجاد جداول در اسلایدها با عرض ستون‌ها و ارتفاع ردیف‌های قابل تنظیم پشتیبانی می‌کند. این راهنما نشان می‌دهد چگونه یک جدول اضافه کنید، آن را با داده‌ها پر کنید و قالب‌بندی متن پایه را بر روی سلول‌ها اعمال کنید.

راهنمای گام به گام

مرحله 1: افزودن وابستگی Maven 

<dependency>
  <groupId>org.aspose.slides.foss</groupId>
  <artifactId>aspose-slides-foss</artifactId>
  <version>1.0.0</version>
</dependency>

مرحله ۲: ایجاد یا باز کردن یک ارائه 

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.ICell;
import org.aspose.slides.foss.IParagraphCollection;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);
    // ... add table ...
    prs.save("table.pptx", SaveFormat.PPTX);
}

مرحله 3: تعریف عرض ستون‌ها و ارتفاع ردیف‌ها

جداول به عرض ستون‌ها و ارتفاع ردیف‌ها به صورت صریح بر حسب نقطه نیاز دارند (1 نقطه = 1/72 اینچ). یک اسلاید استاندارد عرض 720 نقطه و ارتفاع 540 نقطه دارد.

double[] colWidths = {200.0, 150.0, 150.0};   // 3 columns
double[] rowHeights = {45.0, 40.0, 40.0};     // 3 rows

مرحله ۴: افزودن جدول

slide.getShapes().addTable(x, y, colWidths, rowHeights) جدول را در موقعیت (x, y) ایجاد می‌کند:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.ICell;
import org.aspose.slides.foss.IParagraphCollection;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);

    double[] colWidths = {200.0, 150.0, 150.0};
    double[] rowHeights = {45.0, 40.0, 40.0};
    ITable table = slide.getShapes().addTable(50, 100, colWidths, rowHeights);

    prs.save("table.pptx", SaveFormat.PPTX);
}

مرحله 5: تنظیم متن سلول

دسترسی به سلول‌ها از طریق table.getRows().get(rowIndex).get(colIndex) و اختصاص متن از طریق .getTextFrame().setText():

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.ICell;
import org.aspose.slides.foss.IParagraphCollection;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);

    double[] colWidths = {200.0, 150.0, 150.0};
    double[] rowHeights = {45.0, 40.0, 40.0};
    ITable table = slide.getShapes().addTable(50, 100, colWidths, rowHeights);

    // Header row (row 0)
    String[] headers = {"Product", "Units Sold", "Revenue"};
    for (int col = 0; col < headers.length; col++) {
        table.getRows().get(0).get(col).getTextFrame().setText(headers[col]);
    }

    // Data rows
    String[][] data = {
        {"Widget A", "1,200", "$24,000"},
        {"Widget B", "850", "$17,000"},
    };
    for (int row = 0; row < data.length; row++) {
        for (int col = 0; col < data[row].length; col++) {
            table.getRows().get(row + 1).get(col)
                .getTextFrame().setText(data[row][col]);
        }
    }

    prs.save("sales-table.pptx", SaveFormat.PPTX);
}

مرحله 6: قالب‌بندی متن سلول سرصفحه

قالب‌بندی بولد را برای سلول‌های سرصفحه با استفاده از PortionFormat اعمال کنید:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.ICell;
import org.aspose.slides.foss.IParagraphCollection;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

for (int col = 0; col < headers.length; col++) {
    ICell cell = table.getRows().get(0).get(col);
    IParagraphCollection paragraphs = cell.getTextFrame().getParagraphs();
    if (paragraphs.size() > 0 && paragraphs.get(0).getPortions().size() > 0) {
        IPortionFormat fmt = paragraphs.get(0).getPortions().get(0)
            .getPortionFormat();
        fmt.setFontBold(NullableBool.TRUE);
        fmt.getFillFormat().setFillType(FillType.SOLID);
        fmt.getFillFormat().getSolidFillColor().setColor(
            Color.fromArgb(255, 255, 255, 255)
        );
    }
}

مثال کامل عملی 

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.ITable;
import org.aspose.slides.foss.ICell;
import org.aspose.slides.foss.IParagraphCollection;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

public class CreateTable {
    public static void main(String[] args) {
        String[][] dataRows = {
            {"North", "$1.2M", "+8%"},
            {"South", "$0.9M", "+4%"},
            {"East",  "$1.5M", "+12%"},
            {"West",  "$0.7M", "+2%"},
        };
        String[] headers = {"Region", "Revenue", "Growth"};

        try (Presentation prs = new Presentation()) {
            ISlide slide = prs.getSlides().get(0);

            double[] colWidths = {180.0, 140.0, 120.0};
            double[] rowHeights = new double[dataRows.length + 1];
            rowHeights[0] = 45.0;
            for (int i = 1; i < rowHeights.length; i++) {
                rowHeights[i] = 38.0;
            }

            ITable table = slide.getShapes().addTable(
                60, 80, colWidths, rowHeights
            );

            // Header row
            for (int col = 0; col < headers.length; col++) {
                ICell cell = table.getRows().get(0).get(col);
                cell.getTextFrame().setText(headers[col]);
                if (cell.getTextFrame().getParagraphs().size() > 0
                    && cell.getTextFrame().getParagraphs().get(0)
                        .getPortions().size() > 0) {
                    cell.getTextFrame().getParagraphs().get(0)
                        .getPortions().get(0).getPortionFormat()
                        .setFontBold(NullableBool.TRUE);
                }
            }

            // Data rows
            for (int row = 0; row < dataRows.length; row++) {
                for (int col = 0; col < dataRows[row].length; col++) {
                    table.getRows().get(row + 1).get(col)
                        .getTextFrame().setText(dataRows[row][col]);
                }
            }

            prs.save("regional-revenue.pptx", SaveFormat.PPTX);
        }
        System.out.println("Saved regional-revenue.pptx");
    }
}

مشکلات رایج و راه‌حل‌ها

IndexOutOfBoundsException هنگام دسترسی table.getRows().get(row).get(col)

شاخص‌های سطر و ستون از صفر شروع می‌شوند. اگر rowHeights را با 3 عنصر تعریف کرده باشید، شاخص‌های سطر معتبر 0، 1، 2 هستند.

متن سلول در فایل ذخیره‌شده ظاهر نمی‌شود

همیشه از طریق .getTextFrame().setText(value) اختصاص دهید. سلول‌ها را به عنوان table.getRows().get(rowIndex).get(colIndex).getTextFrame().setText("value") دسترسی داشته باشید.

موقعیت جدول خارج از اسلاید

بررسی کنید که x + sum(colWidths) <= 720 و y + sum(rowHeights) <= 540 برای یک اسلاید استاندارد.

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

آیا می‌توانم سلول‌های جدول را ادغام کنم؟

ادغام سلول (mergeCells) در API اعلام شده است اما در این نسخه UnsupportedOperationException را ایجاد می‌کند.

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

قالب‌گذاری پر کردن را برای هر سلول به‌صورت جداگانه اعمال کنید:

for (int row = 0; row < table.getRows().size(); row++) {
    for (int col = 0; col < table.getColumns().size(); col++) {
        ICell cell = table.getRows().get(row).get(col);
        cell.getFillFormat().setFillType(FillType.SOLID);
        cell.getFillFormat().getSolidFillColor().setColor(
            Color.fromArgb(255, 240, 248, 255)
        );
    }
}

آیا می‌توانم یک پیش‌تنظیم سبک جدول تنظیم کنم؟

بله. برای اعمال یک سبک جدول داخلی از table.setStylePreset(TableStylePreset.MEDIUM_STYLE_2_ACCENT_1) استفاده کنید.

همچنین ببینید

 فارسی