Quản lý các ô bảng trong bài thuyết trình trên Android

Tổng quan

Aspose.Slides cho phép bạn truy cập và chỉnh sửa các ô bảng trong bài thuyết trình PowerPoint. Bài viết này giải thích cách xác định các ô bảng đã hợp nhất, xóa viền ô, làm việc với việc đánh số ô sau khi hợp nhất hoặc tách ô, thay đổi màu nền của ô, và thêm hình ảnh vào bên trong một ô bảng. Các ví dụ cho thấy cách tạo hoặc mở một bài thuyết trình, lấy bảng từ một slide, cập nhật định dạng ô thông qua các thuộc tính ô, và lưu bài thuyết trình đã chỉnh sửa dưới dạng tệp PPTX.

Aspose.Slides sử dụng chỉ mục bắt đầu từ 0 để truy cập các ô bảng theo thứ tự (column, row).

Xác định một ô bảng đã hợp nhất

Ví dụ mở một bài thuyết trình hiện có và truy cập hình dạng đầu tiên trên slide đầu tiên dưới dạng bảng. Nó giả định rằng slide và hình dạng tồn tại và hình dạng là một bảng. Sau đó nó lặp qua tất cả các hàng và cột và sử dụng isMergedCell để xác định các ô trong vùng đã hợp nhất. Đối với mỗi kết quả phù hợp, nó in tọa độ ô theo thứ tự row;column, getRowSpan, getColSpan, và tọa độ bắt đầu của vùng, getFirstRowIndex và getFirstColumnIndex.

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation_with_table.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    ITable table = (ITable) slide.getShapes().get_Item(0);

    int rowCount = table.getRows().size();
    for (int rowIndex = 0; rowIndex < rowCount; rowIndex++)
    {
        int columnCount = table.getColumns().size();
        for (int columnIndex = 0; columnIndex < columnCount; columnIndex++)
        {
            ICell cell = table.get_Item(columnIndex, rowIndex);
            if (cell.isMergedCell())
            {
                System.out.printf("Cell %d;%d belongs to a merged region with RowSpan=%d and ColSpan=%d starting at %d;%d.%n", rowIndex, columnIndex, cell.getRowSpan(), cell.getColSpan(), cell.getFirstRowIndex(), cell.getFirstColumnIndex());
            }
        }
    }
} finally {
    presentation.dispose();
}

Xóa viền ô bảng

Tạo một Presentation và thêm một bảng vào slide đầu tiên của nó bằng addTable. Độ rộng cột, chiều cao hàng và vị trí bảng được chỉ định bằng điểm. Ví dụ đặt tất cả bốn viền ô thành FillType.NoFill, khiến chúng không hiển thị.

import com.aspose.slides.*;

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

    double[] columnWidths = { 50, 50, 50, 50 };
    double[] rowHeights = { 50, 30, 30, 30, 30 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    for (IRow row : table.getRows())
        for (ICell cell : row)
        {
            cell.getCellFormat().getBorderTop().getFillFormat().setFillType(FillType.NoFill);
            cell.getCellFormat().getBorderBottom().getFillFormat().setFillType(FillType.NoFill);
            cell.getCellFormat().getBorderLeft().getFillFormat().setFillType(FillType.NoFill);
            cell.getCellFormat().getBorderRight().getFillFormat().setFillType(FillType.NoFill);
        }

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

Thêm viền chéo cho ô

Sử dụng getBorderDiagonalDown để vẽ một đường từ góc trên‑trái đến góc dưới‑phải, và getBorderDiagonalUp để vẽ một đường từ góc dưới‑trái đến góc trên‑phải. Đường chéo có thể đánh dấu tiêu đề góc; cả hai đường chéo có thể tạo thành một ký hiệu X để đánh dấu ô là không áp dụng.

Mỗi đường chéo là một ILineFormat. Trong getFillFormat, sử dụng setFillType để chọn FillType.Solid và chọn một màu qua getSolidFillColor. Đặt độ rộng của đường bằng điểm với setWidth.

Ví dụ tạo ba ô trong một hàng: một đường chéo đỏ xuôi, một đường chéo xanh ngược, và cả hai đường chéo. Nó để nguyên viền trên, dưới, trái và phải của ô.

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

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

    double[] columnWidths = { 210, 210, 210 };
    double[] rowHeights = { 160 };
    ITable table = slide.getShapes().addTable(45, 130, columnWidths, rowHeights);

    ILineFormat downwardBorder = table.get_Item(0, 0).getCellFormat().getBorderDiagonalDown();
    downwardBorder.getFillFormat().setFillType(FillType.Solid);
    downwardBorder.getFillFormat().getSolidFillColor().setColor(Color.RED);
    downwardBorder.setWidth(3);

    ILineFormat upwardBorder = table.get_Item(1, 0).getCellFormat().getBorderDiagonalUp();
    upwardBorder.getFillFormat().setFillType(FillType.Solid);
    upwardBorder.getFillFormat().getSolidFillColor().setColor(Color.BLUE);
    upwardBorder.setWidth(5);

    ILineFormat crossDownwardBorder = table.get_Item(2, 0).getCellFormat().getBorderDiagonalDown();
    crossDownwardBorder.getFillFormat().setFillType(FillType.Solid);
    crossDownwardBorder.getFillFormat().getSolidFillColor().setColor(Color.RED);
    crossDownwardBorder.setWidth(3);

    ILineFormat crossUpwardBorder = table.get_Item(2, 0).getCellFormat().getBorderDiagonalUp();
    crossUpwardBorder.getFillFormat().setFillType(FillType.Solid);
    crossUpwardBorder.getFillFormat().getSolidFillColor().setColor(Color.BLUE);
    crossUpwardBorder.setWidth(5);

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

Một đường chéo là một thuộc tính định dạng, không phải là tách ô. Mỗi ô giữ một khung văn bản duy nhất, truy cập qua getTextFrame; các vùng ở hai phía của đường chéo không thể được chỉnh sửa độc lập.

The saved table, rendered in Microsoft PowerPoint:

Ba ô bảng hiển thị một đường chéo đỏ từ trên‑trái đến dưới‑phải, một đường chéo xanh từ dưới‑trái đến trên‑phải, và cả hai đường chéo tạo thành một ký hiệu X.

Trái sang phải: đường chéo xuôi (đỏ, 3 pt), đường chéo ngược (xanh, 5 pt), và cả hai đường chéo.

Hợp nhất các ô bảng

Sử dụng mergeCells để kết hợp một phạm vi hình chữ nhật của các ô bảng thành một ô. Xác định các ô ở góc trên‑trái và góc dưới‑phải của phạm vi. Đối số cuối cùng kiểm soát việc hợp nhất có thể bao gồm các ô ngoài phạm vi đã chỉ định; false giữ việc hợp nhất trong phạm vi đó.

Ví dụ tạo một bảng 4‑by‑4 với các cột và hàng có độ rộng 70 điểm, sau đó hợp nhất bốn ô trung tâm từ (1, 1) tới (2, 2). Ô kết quả trải qua hai cột và hai hàng, trong khi lưới cơ sở của bảng vẫn giữ bốn cột và bốn hàng. Để truy cập nội dung hoặc định dạng của ô đã hợp nhất, sử dụng vị trí trên‑trái của nó: table.get_Item(1, 1) trong ví dụ này. Các vị trí khác trong phạm vi đã hợp nhất vẫn là một phần của lưới bảng, vì vậy các chỉ mục của các ô ngoài phạm vi không thay đổi.

import com.aspose.slides.*;

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

    double[] columnWidths = { 70, 70, 70, 70 };
    double[] rowHeights = { 70, 70, 70, 70 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    table.mergeCells(table.get_Item(1, 1), table.get_Item(2, 2), false);

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

Tách các ô bảng

Merging cells in the previous example preserves the table’s grid. Splitting a cell can introduce a new grid column and change the column indices of cells to its right. Aspose.Slides follows PowerPoint’s table grid model.

This example creates a 4-by-4 table with 70-point columns and rows and calls splitByWidth on cell (1, 1). Half of the cell’s 70-point width is passed to create two equal-width cells.

After this split, the two halves are accessed as table.get_Item(1, 1) and table.get_Item(2, 1). The table grid now has five columns: cells originally in columns 2 and 3 move to columns 3 and 4, respectively. Row indices remain unchanged. Use these updated column indices when accessing cells after the split.

import com.aspose.slides.*;

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

    double[] columnWidths = { 70, 70, 70, 70 };
    double[] rowHeights = { 70, 70, 70, 70 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    table.get_Item(1, 1).splitByWidth(table.get_Item(1, 1).getWidth() / 2);

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

Một ô 70 điểm chưa hợp nhất được tách thành hai ô 35 điểm, thêm một cột lưới thứ năm và dịch các chỉ mục sang phải.

Việc tách chiều rộng ảnh hưởng đến ô (1, 1), sử dụng chỉ mục bắt đầu từ 0 (cột, hàng). Các hàng khác giữ một ô trải qua cả hai vị trí cột mới.

Tách các ô đã hợp nhất theo chiều hàng hoặc cột

Để chuẩn bị các ô mẫu đã hợp nhất cho việc đưa dữ liệu, sử dụng splitByRowSpan để tách dọc theo ranh giới hàng hiện có, hoặc splitByColSpan để tách dọc theo ranh giới cột.

Tham số index đếm số hàng ở phần trên hoặc số cột ở phần trái của việc tách; nó tương đối với vùng đã hợp nhất:

Ví dụ mong đợi một bài thuyết trình có một bảng là hình dạng đầu tiên trên slide đầu tiên, với các ô (1, 2) và (1, 3) hợp nhất theo chiều dọc. Bắt đầu từ vị trí thấp hơn, nó sử dụng getFirstColumnIndex và getFirstRowIndex để xác định nguồn gốc và kiểm tra cả hai phạm vi. splitByRowSpan(1) sau đó tách các hàng 2 và 3 cho tên sản phẩm. Đối với một hợp nhất ngang hai cột, sử dụng splitByColSpan(1) thay thế.

import com.aspose.slides.*;

Presentation presentation = new Presentation("table_template.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    ITable table = (ITable) slide.getShapes().get_Item(0);

    ICell selectedCell = table.get_Item(1, 3);
    int firstColumnIndex = selectedCell.getFirstColumnIndex();
    int firstRowIndex = selectedCell.getFirstRowIndex();
    ICell mergedCell = table.get_Item(firstColumnIndex, firstRowIndex);

    if (mergedCell.isMergedCell() && mergedCell.getRowSpan() == 2 && mergedCell.getColSpan() == 1)
    {
        mergedCell.splitByRowSpan(1);

        // Lấy các ô kết quả từ bảng sau khi tách.
        ICell upperCell = table.get_Item(firstColumnIndex, firstRowIndex);
        ICell lowerCell = table.get_Item(firstColumnIndex, firstRowIndex + 1);
        System.out.println("Upper cell merged: " + upperCell.isMergedCell());
        System.out.println("Lower cell merged: " + lowerCell.isMergedCell());

        upperCell.getTextFrame().setText("Product A");
        lowerCell.getTextFrame().setText("Product B");

        presentation.save("split_template.pptx", SaveFormat.Pptx);
    }
    else
    {
        System.out.println("Select a merged region spanning exactly two rows and one column.");
    }
} finally {
    presentation.dispose();
}

Lưới bảng và các chỉ mục ô xung quanh vẫn không thay đổi. Lấy các ô kết quả bằng tọa độ của chúng; ở đây, cả hai có phạm vi là 1 và isMergedCell in ra false. Các vùng lớn hơn vẫn có thể còn một phần được hợp nhất sau một lần tách.

Văn bản gốc và định dạng của nó vẫn nằm trong ô trên (hoặc trái); ô mới trống nhưng kế thừa định dạng ô như màu nền, viền và lề. Hãy đưa dữ liệu vào các ô sau khi tách và đặt bất kỳ định dạng văn bản nào cần thiết một cách rõ ràng.

Bản thuyết trình đã lưu chứa các ô “Product A” và “Product B” riêng biệt với định dạng ô của mẫu được giữ nguyên. Xem Cell API Reference để biết chi tiết.

Tách một ô theo độ cao cụ thể

splitByHeight lấy độ cao của phần trên tính bằng điểm. splitByRowSpan lấy số hàng lưới hiện có ở phần trên. Để căn giữa một ô 40 điểm trong cột bên phải, trừ 40 từ độ cao thực tế của ô và chia phần không gian còn lại đều lên trên và dưới nó.

import com.aspose.slides.*;

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

    double[] columnWidths = { 160, 160 };
    double[] rowHeights = { 140 };

    ITable table = slide.getShapes().addTable(50, 50, columnWidths, rowHeights);
    table.get_Item(0, 0).getTextFrame().setText("Left");

    double height = table.get_Item(1, 0).getHeight();
    double margin = (height - 40) / 2;

    table.get_Item(1, 0).splitByHeight(margin);
    table.get_Item(1, 1).splitByHeight(40);
    table.get_Item(1, 1).getTextFrame().setText("Middle");

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

Lần tách đầu tiên thêm một hàng lưới và để lại 90 điểm ở phần dưới của ô (1, 1). Lần tách thứ hai chia ô đó thành một ô giữa có độ cao 40 điểm và một ô dưới có độ cao 50 điểm. Cột bên phải giờ có ba ô với độ cao lần lượt là 50, 40 và 50 điểm từ trên xuống dưới. Ô bên trái trải qua cả ba hàng và giữ nguyên độ cao gốc là 140 điểm.

Ô bên trái trải toàn bộ chiều cao bảng bên cạnh ba ô có Ô Giữa ở trung tâm.

Thay đổi màu nền ô bảng

Ví dụ này tạo một bảng với các cột 150 điểm và các hàng 50 điểm. Nó sử dụng setFillType để chọn một nền đặc và đặt màu trả về bởi getSolidFillColor thành màu đỏ cho ô (2, 3), ở cột thứ ba và hàng thứ tư.

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

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

    double[] columnWidths = { 150, 150, 150, 150 };
    double[] rowHeights = { 50, 50, 50, 50, 50 };
    ITable table = slide.getShapes().addTable(50, 50, columnWidths, rowHeights);

    ICell cell = table.get_Item(2, 3);
    cell.getCellFormat().getFillFormat().setFillType(FillType.Solid);
    cell.getCellFormat().getFillFormat().getSolidFillColor().setColor(Color.RED);

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

Thêm hình ảnh vào bên trong ô bảng

Đặt hình ảnh đầu vào trong thư mục làm việc trước khi chạy ví dụ này. Nó tải hình ảnh bằng Images.fromFile và thêm nó vào bộ sưu tập hình ảnh của bài thuyết trình bằng addImage. Sau đó nó gán hình ảnh cho chế độ điền ảnh của ô (0, 0), ô đầu tiên trong bảng.

PictureFillMode.Stretch kéo dài hình ảnh để lấp đầy ô, điều này có thể làm thay đổi tỷ lệ khung hình. Độ rộng cột và chiều cao hàng được tính bằng điểm. Hình ảnh đã tải được giải phóng trong khối finally sau khi đã được thêm vào bài thuyết trình.

import com.aspose.slides.*;

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

    double[] columnWidths = { 150, 150, 150, 150 };
    double[] rowHeights = { 100, 100, 100, 100, 90 };
    ITable table = slide.getShapes().addTable(50, 50, columnWidths, rowHeights);

    IPPImage ppImage;
    IImage image = Images.fromFile("aspose_logo.jpg");
    try {
        ppImage = presentation.getImages().addImage(image);
    } finally {
        image.dispose();
    }

    table.get_Item(0, 0).getCellFormat().getFillFormat().setFillType(FillType.Picture);
    table.get_Item(0, 0).getCellFormat().getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch);
    table.get_Item(0, 0).getCellFormat().getFillFormat().getPictureFillFormat().getPicture().setImage(ppImage);

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

Câu hỏi thường gặp

Tôi có thể đặt độ dày và kiểu đường viền khác nhau cho các phía khác nhau của một ô duy nhất không?

Có. Các viền top/bottom/left/right có các thuộc tính riêng, vì vậy độ dày và kiểu của mỗi phía có thể khác nhau.

Điều gì xảy ra với hình ảnh nếu tôi thay đổi kích thước cột/hàng sau khi đặt một hình ảnh làm nền cho ô?

Hành vi phụ thuộc vào fill mode (stretch/tile). Khi kéo dài, hình ảnh sẽ điều chỉnh theo ô mới; khi lát, các ô ảnh sẽ được tính lại.

Tôi có thể gán một siêu liên kết cho toàn bộ nội dung của một ô không?

Liên kết siêu văn bản được đặt ở mức đoạn văn bản (phần) bên trong khung văn bản của ô hoặc ở mức toàn bộ bảng/hình dạng. Trong thực tế, bạn gán liên kết cho một phần hoặc cho toàn bộ văn bản trong ô.

Tôi có thể đặt các phông chữ khác nhau trong một ô duy nhất không?

Có. Khung văn bản của ô hỗ trợ portions (đoạn) với định dạng độc lập — họa tiết phông, kiểu, kích thước và màu.