Quản lý Bảng Trình chiếu trong Java

Trang này nói về điều gì

Tạo và chỉnh sửa bảng trong các slide PowerPoint bằng Aspose.Slides cho Java. Khám phá các ví dụ mã đơn giản để tối ưu hoá quy trình làm việc với bảng.

Giới thiệu

Bảng trong PowerPoint là một cách hiệu quả để hiển thị và trình bày thông tin. Thông tin trong lưới các ô (sắp xếp theo hàng và cột) rất trực quan và dễ hiểu.

Aspose.Slides cung cấp lớp Table, giao diện ITable, lớp Cell, giao diện ICell và các kiểu khác để cho phép bạn tạo, cập nhật và quản lý bảng trong mọi loại bản trình bày.

Tạo bảng từ đầu

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu đến slide qua chỉ mục của nó.
Định nghĩa một mảng columnWidth.
Định nghĩa một mảng rowHeight.
Thêm một đối tượng ITable vào slide thông qua phương thức addTable.
Duyệt qua từng ICell để áp dụng định dạng cho các viền trên, dưới, phải và trái.
Gộp hai ô đầu tiên của hàng đầu tiên trong bảng.
Truy cập tới TextFrame của một ICell.
Thêm một số văn bản vào TextFrame.
Lưu bản trình bày đã chỉnh sửa.

Mã Java này cho bạn thấy cách tạo một bảng trong bản trình bày:

import com.aspose.slides.*;
import java.awt.Color;

// Khởi tạo một lớp Presentation đại diện cho tệp PPTX
Presentation pres = new Presentation();
try {
    // Truy cập slide đầu tiên
    ISlide sld = pres.getSlides().get_Item(0);

    // Xác định các cột với độ rộng và các hàng với độ cao
    double[] dblCols = {50, 50, 50};
    double[] dblRows = {50, 30, 30, 30, 30};

    // Thêm một shape bảng vào slide
    ITable tbl = sld.getShapes().addTable(100, 50, dblCols, dblRows);

    // Thiết lập định dạng viền cho mỗi ô
    for (int row = 0; row < tbl.getRows().size(); row++)
    {
        for (int cell = 0; cell < tbl.getRows().get_Item(row).size(); cell++)
        {
            ICellFormat cellFormat = tbl.getRows().get_Item(row).get_Item(cell).getCellFormat();
            
            cellFormat.getBorderTop().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderTop().setWidth(5);

            cellFormat.getBorderBottom().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderBottom().setWidth(5);

            cellFormat.getBorderLeft().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderLeft().setWidth(5);

            cellFormat.getBorderRight().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderRight().setWidth(5);
        }
    }
    // Gộp các ô 1 và 2 của hàng 1
    tbl.mergeCells(tbl.getRows().get_Item(0).get_Item(0), tbl.getRows().get_Item(0).get_Item(1), false);

    // Thêm một số văn bản vào ô đã gộp
    tbl.getRows().get_Item(0).get_Item(0).getTextFrame().setText("Merged Cells");

    // Lưu bản trình chiếu ra đĩa
    pres.save("table.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Đánh số trong bảng tiêu chuẩn

Trong một bảng tiêu chuẩn, việc đánh số các ô là trực quan và bắt đầu từ 0. Ô đầu tiên trong bảng được chỉ mục là 0,0 (cột 0, hàng 0).

Ví dụ, các ô trong một bảng có 4 cột và 4 hàng được đánh số như sau:

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

Mã Java này cho bạn thấy cách chỉ định đánh số cho các ô trong bảng:

import com.aspose.slides.*;
import java.awt.Color;

// Khởi tạo một lớp Presentation đại diện cho tệp PPTX
Presentation pres = new Presentation();
try {
    // Truy cập slide đầu tiên
    ISlide sld = pres.getSlides().get_Item(0);

    // Xác định các cột với độ rộng và các hàng với độ cao
    double[] dblCols = { 70, 70, 70, 70 };
    double[] dblRows = { 70, 70, 70, 70 };

    // Thêm một shape bảng vào slide
    ITable tbl = sld.getShapes().addTable(100, 50, dblCols, dblRows);

    // Thiết lập định dạng viền cho mỗi ô
    for (IRow row : tbl.getRows())
    {
        for (ICell cell : row)
        {
            cell.getCellFormat().getBorderTop().getFillFormat().setFillType(FillType.Solid);
            cell.getCellFormat().getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cell.getCellFormat().getBorderTop().setWidth(5);

            cell.getCellFormat().getBorderBottom().getFillFormat().setFillType(FillType.Solid);
            cell.getCellFormat().getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cell.getCellFormat().getBorderBottom().setWidth(5);

            cell.getCellFormat().getBorderLeft().getFillFormat().setFillType(FillType.Solid);
            cell.getCellFormat().getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cell.getCellFormat().getBorderLeft().setWidth(5);

            cell.getCellFormat().getBorderRight().getFillFormat().setFillType(FillType.Solid);
            cell.getCellFormat().getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cell.getCellFormat().getBorderRight().setWidth(5);
        }
    }

    // Lưu bản trình chiếu ra đĩa
    pres.save("StandardTables_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Truy cập bảng hiện có

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu đến slide chứa bảng qua chỉ mục của nó.
Tạo một đối tượng ITable và gán giá trị null cho nó.
Duyệt qua tất cả các đối tượng IShape cho đến khi tìm thấy bảng.

Nếu bạn nghi ngờ slide đang làm việc chỉ chứa một bảng, bạn có thể kiểm tra tất cả các shape nó chứa. Khi một shape được xác định là bảng, bạn có thể ép kiểu nó thành đối tượng Table. Nhưng nếu slide chứa nhiều bảng, bạn nên tìm bảng cần thiết thông qua thuộc tính setAlternativeText(String value).
Sử dụng đối tượng ITable để làm việc với bảng. Trong ví dụ dưới, chúng tôi đã thêm một hàng mới vào bảng.
Lưu bản trình bày đã chỉnh sửa.

Mã Java này cho bạn thấy cách truy cập và làm việc với một bảng hiện có:

import com.aspose.slides.*;

// Khởi tạo lớp Presentation đại diện cho tệp PPTX
Presentation pres = new Presentation("UpdateExistingTable.pptx");
try {

    // Truy cập slide đầu tiên
    ISlide sld = pres.getSlides().get_Item(0);

    // Khởi tạo TableEx với giá trị null
    ITable tbl = null;

    // Duyệt qua các shape và thiết lập tham chiếu tới bảng được tìm thấy
    for (IShape shp : sld.getShapes()) 
    {
        if (shp instanceof ITable) 
        {
            tbl = (ITable) shp;
            // Đặt văn bản cho cột đầu tiên của hàng thứ hai
            tbl.get_Item(0, 1).getTextFrame().setText("New");
        }
    }
    
    // Lưu bản trình chiếu đã sửa vào đĩa
    pres.save("table1_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Tìm ô chứa một Text Frame

Khi mã xử lý văn bản chung nhận một ITextFrame từ một bảng, hãy sử dụng phương thức ITextFrame.getParentCell để lấy ô sở hữu ICell. Đối với Text Frame trong ô bảng, ITextFrame.getParentCell trả về chủ sở hữu và ITextFrame.getParentShape trả về null, mặc dù bảng bản thân nó cũng là một shape.

Các tọa độ của ô có thể truy cập qua các phương thức chỉ-đọc ICell.getFirstColumnIndex và ICell.getFirstRowIndex. ITextFrame.getParentCell cũng cung cấp khả năng điều hướng chỉ-đọc: nó trả về chủ sở hữu nhưng không thay đổi quyền sở hữu. Luôn kiểm tra giá trị trả về có phải null trước khi sử dụng.

Đối với một ví dụ hoàn chỉnh xác định chủ sở hữu ô bảng và shape, bao gồm các shape liên quan tới nút SmartArt, hãy xem Search and Replace Text.

Căn chỉnh văn bản trong bảng

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu đến slide qua chỉ mục của nó.
Thêm một đối tượng ITable vào slide.
Truy cập một đối tượng ITextFrame từ bảng.
Truy cập IParagraph của ITextFrame.
Căn chỉnh văn bản theo chiều dọc.
Lưu bản trình bày đã chỉnh sửa.

Mã Java này cho bạn thấy cách căn chỉnh văn bản trong bảng:

import com.aspose.slides.*;
import java.awt.Color;

// Tạo một thể hiện của lớp Presentation
Presentation pres = new Presentation();
try {
    // Lấy slide đầu tiên 
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Xác định các cột với độ rộng và các hàng với độ cao
    double[] dblCols = { 120, 120, 120, 120 };
    double[] dblRows = { 100, 100, 100, 100 };
    
    // Thêm shape bảng vào slide
    ITable tbl = slide.getShapes().addTable(100, 50, dblCols, dblRows);
    tbl.get_Item(1, 0).getTextFrame().setText("10");
    tbl.get_Item(2, 0).getTextFrame().setText("20");
    tbl.get_Item(3, 0).getTextFrame().setText("30");
    
    // Truy cập vào khung văn bản
    ITextFrame txtFrame = tbl.get_Item(0, 0).getTextFrame();
    
    // Tạo đối tượng Paragraph cho khung văn bản
    IParagraph paragraph = txtFrame.getParagraphs().get_Item(0);
    
    // Tạo đối tượng Portion cho đoạn văn
    IPortion portion = paragraph.getPortions().get_Item(0);
    portion.setText("Text here");
    portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
    portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    
    // Căn chỉnh văn bản theo chiều dọc
    ICell cell = tbl.get_Item(0, 0);
    cell.setTextAnchorType(TextAnchorType.Center);
    cell.setTextVerticalType(TextVerticalType.Vertical270);
    
    // Lưu bản trình chiếu vào đĩa
    pres.save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Đặt định dạng văn bản ở mức bảng

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu đến slide qua chỉ mục của nó.
Truy cập một đối tượng ITable từ Slide.
Đặt setFontHeight(float value) cho văn bản.
Đặt setAlignment(int value) và setMarginRight(float value).
Đặt setTextVerticalType(byte value).
Lưu bản trình bày đã chỉnh sửa.

Mã Java này cho bạn thấy cách áp dụng các tùy chọn định dạng ưa thích cho văn bản trong bảng:

import com.aspose.slides.*;

// Tạo một thể hiện của lớp Presentation
Presentation pres = new Presentation("simpletable.pptx");
try {
    // Giả sử shape đầu tiên trên slide đầu tiên là một bảng
    ITable someTable = (ITable) pres.getSlides().get_Item(0).getShapes().get_Item(0);
    
    // Đặt độ cao phông chữ cho các ô trong bảng
    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(25);
    someTable.setTextFormat(portionFormat);
    
    // Đặt căn chỉnh văn bản và lề phải cho các ô trong bảng trong một lần gọi
    ParagraphFormat paragraphFormat = new ParagraphFormat();
    paragraphFormat.setAlignment(TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
    someTable.setTextFormat(paragraphFormat);
    
    // Đặt kiểu dọc cho văn bản của các ô trong bảng
    TextFrameFormat textFrameFormat = new TextFrameFormat();
    textFrameFormat.setTextVerticalType(TextVerticalType.Vertical);
    someTable.setTextFormat(textFrameFormat);
    
    pres.save("result.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Lấy thuộc tính kiểu bảng

Aspose.Slides cho phép bạn lấy các thuộc tính kiểu của một bảng để có thể sử dụng những chi tiết này cho bảng khác hoặc ở nơi khác. Mã Java này cho bạn thấy cách lấy các thuộc tính kiểu từ một kiểu bảng đã định sẵn:

import com.aspose.slides.*;

Presentation pres = new Presentation();
try {
    ITable table = pres.getSlides().get_Item(0).getShapes().addTable(10, 10, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
    table.setStylePreset(TableStylePreset.DarkStyle1); // thay đổi giao diện preset mặc định 

    // Lấy preset kiểu của bảng
    int stylePreset = table.getStylePreset();
    System.out.println("Table style preset: " + stylePreset);

    // Áp dụng preset kiểu đã lấy cho bảng khác
    ITable anotherTable = pres.getSlides().get_Item(0).getShapes().addTable(10, 100, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
    anotherTable.setStylePreset(stylePreset);

    pres.save("table.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Khóa tỷ lệ khung hình của bảng

Tỷ lệ khung hình của một hình học là tỉ lệ giữa các kích thước của nó trong các chiều khác nhau. Aspose.Slides cung cấp thuộc tính setAspectRatioLocked cho phép bạn khóa thiết lập tỷ lệ khung hình cho bảng và các shape khác.

Mã Java này cho bạn thấy cách khóa tỷ lệ khung hình cho một bảng:

import com.aspose.slides.*;

Presentation pres = new Presentation("pres.pptx");
try {
    ITable table = (ITable)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    table.getGraphicalObjectLock().setAspectRatioLocked(!table.getGraphicalObjectLock().getAspectRatioLocked()); // đảo ngược

    System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    pres.save("pres-out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Tôi có thể bật chế độ đọc từ phải sang trái (RTL) cho toàn bảng và văn bản trong các ô không?

Có. Bảng cung cấp phương thức setRightToLeft, và các đoạn văn có ParagraphFormat.setRightToLeft. Sử dụng cả hai sẽ đảm bảo thứ tự RTL và hiển thị đúng bên trong các ô.

Làm thế nào để ngăn người dùng di chuyển hoặc thay đổi kích thước bảng trong tệp cuối cùng?

Sử dụng shape locks để tắt việc di chuyển, thay đổi kích thước, chọn, v.v. Các khóa này cũng áp dụng cho bảng.

Việc chèn hình ảnh vào ô làm nền có được hỗ trợ không?

Có. Bạn có thể đặt một picture fill cho ô; hình ảnh sẽ phủ toàn bộ vùng ô theo chế độ đã chọn (kéo dài hoặc lát).

Quản lý hàng và cột trong bảng PowerPoint bằng Java