Tìm kiếm và Thay thế Văn bản trong Bản trình bày PowerPoint bằng Java

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

Tìm kiếm, đánh dấu và thay thế văn bản trong các bản trình bày PowerPoint đồng thời thu thập mọi kết quả khớp bằng Aspose.Slides cho Java.

Tổng quan

Aspose.Slides for Java có thể tìm kiếm, đánh dấu và thay thế văn bản trong một khung văn bản riêng lẻ hoặc trên toàn bộ bản trình bày. Mỗi thao tác cũng có thể thông báo cho ứng dụng về mọi kết quả khớp thông qua một callback kết quả. Điều này cho phép cập nhật bản trình bày và đồng thời xây dựng nhật ký audit chứa văn bản đã khớp, ngữ cảnh, vị trí, khung văn bản và số slide.

Các khả năng này hữu ích cho việc xem xét, xóa bớt, kiểm tra thuật ngữ, dọn dẹp mẫu và quy trình báo cáo tự động.

Trong các ví dụ đầu tiên bên dưới, chúng tôi sử dụng tệp có tên “sample.pptx”, chứa một hộp văn bản duy nhất trên slide đầu tiên với văn bản sau:

Chọn Phạm vi Tìm kiếm

Sử dụng các phương thức trên ITextFrame để giới hạn một thao tác cho một khung văn bản. Sử dụng các phương thức trên Presentation để xử lý tất cả văn bản áp dụng trong bản trình bày.

Thao tác	Một khung văn bản	Toàn bộ bản trình bày
Đánh dấu văn bản nguyên bản	ITextFrame.highlightText	Presentation.highlightText
Đánh dấu các khớp biểu thức chính quy	ITextFrame.highlightRegex	Presentation.highlightRegex
Thay thế văn bản nguyên bản	ITextFrame.replaceText	Presentation.replaceText
Thay thế các khớp biểu thức chính quy	ITextFrame.replaceRegex	Presentation.replaceRegex

Cấu hình khớp văn bản

Đối với các thao tác văn bản nguyên bản, sử dụng TextSearchOptions để kiểm soát việc khớp:

• TextSearchOptions.setWholeWordsOnly giới hạn kết quả khớp chỉ các từ hoàn chỉnh.
• TextSearchOptions.setCaseSensitive kiểm soát việc có phải phân biệt chữ hoa chữ thường hay không.
• TextSearchOptions.setIncludeNotes bao gồm ghi chú slide trong các thao tác tìm kiếm, thay thế và đánh dấu ở mức bản trình bày.

Các thao tác biểu thức chính quy sử dụng Pattern của Java, vì vậy các quy tắc khớp như phân biệt chữ hoa chữ thường và ranh giới từ được định nghĩa bởi biểu thức và các cờ của nó.

Thu thập thông tin khớp bằng Callback

Triển khai IFindResultCallback để nhận thông báo cho mỗi khớp. Phương thức IFindResultCallback.foundResult của nó cung cấp khung văn bản liên quan, văn bản nguồn, văn bản đã khớp và vị trí khớp.

Callback không nhận trực tiếp số slide. Triển khai dưới đây suy ra nó từ slide cha và đồng thời xử lý văn bản được tìm thấy trong ghi chú slide. Một Integer có thể null cho phép cùng mô hình kết quả biểu diễn văn bản liên quan tới các loại slide khác.

import com.aspose.slides.*;
import java.util.ArrayList;
import java.util.List;

final class TextMatch {
    private final ITextFrame textFrame;
    private final String sourceText;
    private final String foundText;
    private final int textPosition;
    private final Integer slideNumber;

    TextMatch(ITextFrame textFrame, String sourceText, String foundText, int textPosition, Integer slideNumber) {
        this.textFrame = textFrame;
        this.sourceText = sourceText;
        this.foundText = foundText;
        this.textPosition = textPosition;
        this.slideNumber = slideNumber;
    }

    ITextFrame getTextFrame() {
        return textFrame;
    }

    String getSourceText() {
        return sourceText;
    }

    String getFoundText() {
        return foundText;
    }

    int getTextPosition() {
        return textPosition;
    }

    Integer getSlideNumber() {
        return slideNumber;
    }
}

final class TextSearchCallback implements IFindResultCallback {
    private final List<TextMatch> results = new ArrayList<TextMatch>();

    List<TextMatch> getResults() {
        return results;
    }

    @Override
    public void foundResult(ITextFrame textFrame, String sourceText, String foundText, int textPosition) {
        Integer slideNumber = getSlideNumber(textFrame);
        TextMatch result = new TextMatch(textFrame, sourceText, foundText, textPosition, slideNumber);
        results.add(result);
    }

    private static Integer getSlideNumber(ITextFrame textFrame) {
        if (!(textFrame instanceof TextFrame)) {
            return null;
        }

        IBaseSlide parentSlide = ((TextFrame) textFrame).getSlide();

        if (parentSlide instanceof ISlide) {
            return ((ISlide) parentSlide).getSlideNumber();
        }

        if (parentSlide instanceof INotesSlide) {
            return ((INotesSlide) parentSlide).getParentSlide().getSlideNumber();
        }

        return null;
    }
}

Đối với các thao tác thay thế, foundText chứa văn bản khớp gốc, vì vậy callback có thể ghi lại chính xác các thuật ngữ đã được thay thế.

Đánh dấu Văn bản

Sử dụng phương thức ITextFrame.highlightText để đánh dấu các khớp văn bản nguyên bản trong một khung văn bản. Truyền TextSearchOptions để kiểm soát việc tìm kiếm và một callback để thu thập chi tiết khớp.

Ví dụ mã dưới đây đánh dấu tất cả các lần xuất hiện của các ký tự “try” và sau đó chỉ đánh dấu từ hoàn chỉnh “to”. Cả hai tìm kiếm đều báo cáo các khớp của chúng tới cùng một callback.

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

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IAutoShape shape = (IAutoShape) slide.getShapes().get_Item(0);
    TextSearchCallback callback = new TextSearchCallback();

    TextSearchOptions substringSearchOptions = new TextSearchOptions();
    substringSearchOptions.setCaseSensitive(false);
    Color substringHighlightColor = new Color(173, 216, 230);

    // Đánh dấu mọi lần xuất hiện của "try" trong khung văn bản.
    shape.getTextFrame().highlightText("try", substringHighlightColor, substringSearchOptions, callback);

    TextSearchOptions wholeWordSearchOptions = new TextSearchOptions();
    wholeWordSearchOptions.setWholeWordsOnly(true);
    wholeWordSearchOptions.setCaseSensitive(false);
    Color wholeWordHighlightColor = new Color(238, 130, 238);

    // Đánh dấu chỉ từ hoàn chỉnh "to".
    shape.getTextFrame().highlightText("to", wholeWordHighlightColor, wholeWordSearchOptions, callback);

    for (TextMatch result : callback.getResults()) {
        System.out.println("Found '" + result.getFoundText() + "' at position " +
                result.getTextPosition() + " on slide " + result.getSlideNumber() + ".");
    }

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

Kết quả:

Đánh dấu Văn bản bằng Biểu thức Chính quy

Phương thức ITextFrame.highlightRegex đánh dấu các khớp văn bản được tìm thấy bằng một biểu thức chính quy trong một khung văn bản.

Mã sau đây đánh dấu tất cả các từ chứa bảy ký tự trở lên và thu thập mỗi khớp:

import com.aspose.slides.*;
import java.awt.Color;
import java.util.regex.Pattern;

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IAutoShape shape = (IAutoShape) slide.getShapes().get_Item(0);
    TextSearchCallback callback = new TextSearchCallback();
    Pattern regex = Pattern.compile("\\b[^\\s]{7,}\\b");

    shape.getTextFrame().highlightRegex(regex, Color.YELLOW, callback);

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

Kết quả:

Đánh dấu Văn bản trên Toàn bộ Bản trình bày

Sử dụng Presentation.highlightText và Presentation.highlightRegex để tìm kiếm tất cả các khung văn bản áp dụng trong một bản trình bày. Ví dụ sau đây đánh dấu một thuật ngữ nguyên bản và tất cả địa chỉ email đồng thời giữ các bộ kết quả riêng biệt cho hai tìm kiếm.

import com.aspose.slides.*;
import java.awt.Color;
import java.util.regex.Pattern;

Presentation presentation = new Presentation("presentation.pptx");
try {
    TextSearchCallback termCallback = new TextSearchCallback();
    TextSearchOptions searchOptions = new TextSearchOptions();
    searchOptions.setWholeWordsOnly(true);
    searchOptions.setCaseSensitive(false);

    presentation.highlightText("confidential", Color.ORANGE, searchOptions, termCallback);

    TextSearchCallback emailCallback = new TextSearchCallback();
    Pattern emailRegex = Pattern.compile(
            "\\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\\.[A-Z]{2,}\\b",
            Pattern.CASE_INSENSITIVE);

    presentation.highlightRegex(emailRegex, Color.YELLOW, emailCallback);
    presentation.save("highlighted_presentation.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Thay thế Văn bản trong Khung Văn bản

Sử dụng ITextFrame.replaceText cho văn bản nguyên bản và ITextFrame.replaceRegex cho việc thay thế dựa trên mẫu. Những phương thức này cập nhật văn bản đã khớp trong khung văn bản hiện có, giữ định dạng phần xung quanh thay vì tạo lại khung văn bản từ một chuỗi đơn.

Ví dụ dưới đây chuẩn hoá một biến thể chính tả và sau đó thay thế các nhãn phiên bản. Cùng một callback ghi lại các thuật ngữ gốc đã khớp bởi cả hai thao tác.

import com.aspose.slides.*;
import java.util.regex.Pattern;

Presentation presentation = new Presentation("presentation.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IAutoShape shape = (IAutoShape) slide.getShapes().get_Item(0);
    TextSearchCallback callback = new TextSearchCallback();
    TextSearchOptions searchOptions = new TextSearchOptions();
    searchOptions.setWholeWordsOnly(true);
    searchOptions.setCaseSensitive(false);

    shape.getTextFrame().replaceText("colour", "color", searchOptions, callback);

    Pattern versionRegex = Pattern.compile("\\bv\\d+(?:\\.\\d+)*\\b", Pattern.CASE_INSENSITIVE);
    shape.getTextFrame().replaceRegex(versionRegex, "current version", callback);

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

Nếu một khớp bao phủ các phần với định dạng khác nhau, hãy kiểm tra kết quả để xác nhận định dạng nào nên áp dụng cho văn bản thay thế.

Thay thế Văn bản trên Toàn bộ Bản trình bày

Sử dụng Presentation.replaceText và Presentation.replaceRegex để áp dụng cùng các thao tác trên toàn bộ bản trình bày. Điều này hữu ích cho việc dọn dẹp mẫu, cập nhật thuật ngữ và xóa bớt.

import com.aspose.slides.*;
import java.util.regex.Pattern;

Presentation presentation = new Presentation("presentation.pptx");
try {
    TextSearchCallback callback = new TextSearchCallback();
    TextSearchOptions searchOptions = new TextSearchOptions();
    searchOptions.setWholeWordsOnly(true);
    searchOptions.setCaseSensitive(true);

    presentation.replaceText("Contoso", "Example Corp", searchOptions, callback);

    Pattern accountNumberRegex = Pattern.compile("\\bACCT-\\d{6}\\b");
    presentation.replaceRegex(accountNumberRegex, "ACCT-REDACTED", callback);

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

Nhóm Các Khớp cho Báo cáo

Vì mỗi kết quả lưu lại số slide và khung văn bản, các ứng dụng có thể nhóm các khớp cho quy trình audit, báo cáo hoặc xem xét. Ví dụ dưới đây nhóm các kết quả đã thu thập đầu tiên theo slide và sau đó theo khung văn bản:

import com.aspose.slides.ITextFrame;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;

Map<Integer, Map<ITextFrame, List<TextMatch>>> matchesBySlide =
        new LinkedHashMap<Integer, Map<ITextFrame, List<TextMatch>>>();

for (TextMatch result : callback.getResults()) {
    Integer slideNumber = result.getSlideNumber();
    Map<ITextFrame, List<TextMatch>> matchesByTextFrame = matchesBySlide.get(slideNumber);

    if (matchesByTextFrame == null) {
        matchesByTextFrame = new LinkedHashMap<ITextFrame, List<TextMatch>>();
        matchesBySlide.put(slideNumber, matchesByTextFrame);
    }

    ITextFrame textFrame = result.getTextFrame();
    List<TextMatch> textFrameMatches = matchesByTextFrame.get(textFrame);

    if (textFrameMatches == null) {
        textFrameMatches = new java.util.ArrayList<TextMatch>();
        matchesByTextFrame.put(textFrame, textFrameMatches);
    }

    textFrameMatches.add(result);
}

for (Map.Entry<Integer, Map<ITextFrame, List<TextMatch>>> slideEntry : matchesBySlide.entrySet()) {
    String slideLabel = slideEntry.getKey() == null ? "Other" : slideEntry.getKey().toString();
    System.out.println("Slide: " + slideLabel);

    for (Map.Entry<ITextFrame, List<TextMatch>> textFrameEntry : slideEntry.getValue().entrySet()) {
        System.out.println("  Text frame: " + textFrameEntry.getKey().getText());

        for (TextMatch result : textFrameEntry.getValue()) {
            System.out.println("    '" + result.getFoundText() + "' at position " +
                    result.getTextPosition() + "; context: '" + result.getSourceText() + "'");
        }
    }
}

FAQ

Làm thế nào để tôi chỉ tìm kiếm trong một hộp văn bản thay vì toàn bộ bản trình bày?

Lấy khung văn bản của shape và gọi ITextFrame.highlightText, ITextFrame.highlightRegex, ITextFrame.replaceText, hoặc ITextFrame.replaceRegex trên khung văn bản đó. Các phương thức ở mức Presentation sẽ xử lý tất cả các khung văn bản áp dụng.

Làm thế nào để tôi khớp các từ hoàn chỉnh với đúng chữ hoa chữ thường?

Đặt TextSearchOptions.setWholeWordsOnly và TextSearchOptions.setCaseSensitive thành true, và truyền các tùy chọn vào phương thức đánh dấu hoặc thay thế văn bản nguyên bản. Đối với biểu thức chính quy, định nghĩa ranh giới từ và phân biệt chữ hoa chữ thường trong Pattern của Java.

Việc tìm kiếm và thay thế có thể bao gồm văn bản trong ghi chú slide không?

Có. Đặt TextSearchOptions.setIncludeNotes thành true khi sử dụng thao tác văn bản nguyên bản ở mức presentation. Triển khai callback ở trên ánh xạ một khớp trong slide ghi chú trở lại số slide cha.

Làm sao tôi có thể tạo báo cáo mà không phải quét bản trình bày lần thứ hai?

Truyền một triển khai IFindResultCallback vào thao tác đánh dấu hoặc thay thế. Callback nhận mọi khớp trong khi thao tác chạy, vì vậy ứng dụng có thể lưu trữ văn bản nguồn, văn bản đã khớp, vị trí, khung văn bản và số slide suy ra để nhóm hoặc xuất sau.

Việc thay thế văn bản có giữ định dạng không?

ITextFrame.replaceText và ITextFrame.replaceRegex sửa đổi văn bản đã khớp trong khung văn bản hiện có và giữ định dạng phần xung quanh. Nếu một khớp bao phủ các phần với định dạng khác nhau, kiểm tra kết quả để đảm bảo việc thay thế sử dụng kiểu mong muốn.