Android'de PowerPoint Sunumlarında Metin Arama ve Değiştirme

Bu sayfa ne hakkında

PowerPoint sunumlarında metin arayın, vurgulayın ve değiştirin; Aspose.Slides for Android via Java ile her eşleşmeyi toplayın.

Genel Bakış

Aspose.Slides for Android via Java, bir metin çerçevesinde ya da tüm bir sunumda metin arayabilir, vurgulayabilir ve değiştirebilir. Her işlem, eşleşmeler hakkında bir sonuç geri çağrısı aracılığıyla uygulamayı da bilgilendirebilir. Bu sayede bir sunumu güncellerken eşleşen metni, bağlamını, konumunu, metin çerçevesini ve slayt numarasını içeren bir denetim izini aynı anda oluşturmak mümkün olur.

Bu yetenekler, gözden geçirme, redaksiyon, terminoloji kontrolleri, şablon temizliği ve otomatik raporlama iş akışları için yararlıdır.

Aşağıdaki ilk örneklerde, birincil slaytta tek bir metin kutusu içeren ve aşağıdaki metni barındıran “sample.pptx” adlı dosyayı kullanıyoruz:

Örnek metin

Arama Kapsamını Seçin

ITextFrame üzerindeki yöntemleri, bir işlemi tek bir metin çerçevesiyle sınırlamak için kullanın. IPresentation üzerindeki yöntemleri, sunumdaki tüm geçerli metni işlemek için kullanın.

İşlem	Tek metin çerçevesi	Tüm sunum
Doğrudan metni vurgula	ITextFrame.highlightText	IPresentation.highlightText
Düzenli ifade eşleşmelerini vurgula	ITextFrame.highlightRegex	IPresentation.highlightRegex
Doğrudan metni değiştir	ITextFrame.replaceText	IPresentation.replaceText
Düzenli ifade eşleşmelerini değiştir	ITextFrame.replaceRegex	IPresentation.replaceRegex

Metin Eşleştirmeyi Yapılandır

Doğrudan metin işlemleri için, eşleşmeyi kontrol etmek amacıyla TextSearchOptions kullanın:

TextSearchOptions.setWholeWordsOnly eşleşmeleri yalnızca tam kelimelerle sınırlar.
TextSearchOptions.setCaseSensitive karakter büyük/küçük harf eşleşmesinin gerekip gerekmediğini kontrol eder.
TextSearchOptions.setIncludeNotes sunum düzeyinde arama, değiştirme ve vurgulama işlemlerine slayt notlarını da dahil eder.

Düzenli ifade işlemleri, bir Java Pattern kullanır; bu nedenle büyük/küçük harf duyarlılığı ve kelime sınırları gibi eşleşme kuralları ifadenin ve bayrakların içinde tanımlanır.

Eşleşme Bilgilerini Geri Çağırma ile Topla

IFindResultCallback implement ederek her eşleşme için bir bildirim alın. Onun IFindResultCallback.foundResult yöntemi ilgili metin çerçevesini, kaynak metni, eşleşen metni ve eşleşme konumunu sağlar.

Geri çağırma doğrudan bir slayt numarası almaz. Aşağıdaki uygulama, bu numarayı üst slayttan türetir ve slayt notlarında bulunan metni de işler. Null olabilen bir Integer, aynı sonuç modelinin diğer slayt türleriyle ilişkilendirilen metni temsil etmesini sağlar.

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;
    }
}

Değiştirme işlemleri için, foundText orijinal eşleşen metni içerir; böylece geri çağırma tam olarak hangi terimlerin değiştirildiğini kaydedebilir.

Metni Vurgula

ITextFrame.highlightText yöntemini, bir metin çerçevesindeki doğrudan metin eşleşmelerini vurgulamak için kullanın. Aramayı kontrol etmek için [TextSearchOptions] ve eşleşme ayrıntılarını toplamak için bir geri çağırma geçirin.

Aşağıdaki kod örneği, “try” karakterlerinin tüm tekrarlarını vurgular ve ardından yalnızca “to” tam kelimesini vurgular. Her iki arama da eşleşmelerini aynı geri çağırmaya rapor eder.

import com.aspose.slides.*;
import android.graphics.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);
    int substringHighlightColor = Color.rgb(173, 216, 230);

    // Metin çerçevesinde "try" kelimesinin her geçişini vurgula.
    shape.getTextFrame().highlightText("try", substringHighlightColor, substringSearchOptions, callback);

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

    // Yalnızca tam kelime "to"yu vurgula.
    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();
}

Sonuç:

Vurgulanan metin

Düzenli İfadelerle Metni Vurgula

ITextFrame.highlightRegex yöntemi, bir metin çerçevesinde bir düzenli ifade ile bulunan metin eşleşmelerini vurgular.

Aşağıdaki kod, yedi veya daha fazla karakter içeren tüm kelimeleri vurgular ve her bir eşleşmeyi toplar:

import com.aspose.slides.*;
import android.graphics.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();
}

Sonuç:

Düzenli ifade kullanılarak vurgulanan metin

Bir Sunum Genelinde Metni Vurgula

IPresentation.highlightText ve IPresentation.highlightRegex yöntemlerini, bir sunumdaki tüm geçerli metin çerçevelerinde arama yapmak için kullanın. Aşağıdaki örnek, bir doğrudan terimi ve tüm e-posta adreslerini vurgular; iki arama için ayrı sonuç koleksiyonları tutar.

import com.aspose.slides.*;
import android.graphics.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);

    int termHighlightColor = Color.rgb(255, 165, 0);
    presentation.highlightText("confidential", termHighlightColor, 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();
}

Bir Metin Çerçevesinde Metni Değiştir

Doğrudan metin için ITextFrame.replaceText , desen tabanlı değiştirme için ITextFrame.replaceRegex kullanın. Bu yöntemler, mevcut metin çerçevesindeki eşleşen metni günceller; çevresindeki bölümlerin biçimlendirmesini tutar ve metin çerçevesini düz bir dizeden yeniden oluşturmaz.

Aşağıdaki örnek, bir yazım varyantını standartlaştırır ve ardından sürüm etiketlerini değiştirir. Aynı geri çağırma, her iki işlemde eşleşen orijinal terimleri kaydeder.

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();
}

Eğer bir eşleşme, farklı biçimlendirmeye sahip bölümleri kapsıyorsa, çıktıyı gözden geçirerek hangi biçimlendirmenin yerine konulan metne uygulanması gerektiğini teyit edin.

Bir Sunum Genelinde Metni Değiştir

IPresentation.replaceText ve IPresentation.replaceRegex yöntemlerini, bir sunum genelinde aynı işlemleri uygulamak için kullanın. Bu, şablon temizliği, terminoloji güncellemeleri ve redaksiyon için yararlıdır.

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();
}

Raporlama için Eşleşmeleri Grupla

Her sonuç slayt numarasını ve metin çerçevesini depoladığından, uygulamalar eşleşmeleri denetim, raporlama veya gözden geçirme iş akışları için gruplayabilir. Aşağıdaki örnek, toplanan sonuçları önce slayta, ardından metin çerçevesine göre gruplar:

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() + "'");
        }
    }
}

SSS

Yalnızca bir metin kutusunu tüm sunum yerine nasıl arayabilirim?

Şeklin metin çerçevesini alın ve bu metin çerçevesi üzerinde ITextFrame.highlightText, ITextFrame.highlightRegex, ITextFrame.replaceText, veya ITextFrame.replaceRegex yöntemlerini çağırın. Sunum düzeyindeki yöntemler, tüm geçerli metin çerçevelerini işler.

Tam kelimeleri doğru büyük/küçük harfle nasıl eşleştirebilirim?

Tam kelimeleri ve doğru büyük/küçük harfleri eşleştirmek için TextSearchOptions.setWholeWordsOnly ve TextSearchOptions.setCaseSensitive değerlerini true olarak ayarlayın ve bu seçenekleri doğrudan metin vurgulama veya değiştirme yöntemine geçirin. Düzenli ifadeler için, kelime sınırlarını ve büyük/küçük harf duyarlılığını Java Pattern içinde tanımlayın.

Arama ve değiştirme slayt notlarındaki metni içerebilir mi?

Evet. Sunum düzeyinde doğrudan metin işlemi kullanırken TextSearchOptions.setIncludeNotes değerini true olarak ayarlayın. Yukarıda gösterilen geri çağırma uygulaması, bir not slaydındaki eşleşmeyi üst slayt numarasına eşler.

Sunumu ikinci kez taramadan nasıl bir rapor oluşturabilirim?

IFindResultCallback uygulamasını vurgulama veya değiştirme işlemine geçirin. Geri çağırma, işlem çalışırken her eşleşmeyi alır; böylece uygulama, kaynak metni, eşleşen metni, konumu, metin çerçevesini ve türetilen slayt numarasını daha sonra gruplama veya dışa aktarma için depolayabilir.

Metni değiştirmek biçimlendirmesini korur mu?

ITextFrame.replaceText ve ITextFrame.replaceRegex eşleşen metni mevcut metin çerçevesi içinde değiştirir ve çevresindeki bölümlerin biçimlendirmesini korur. Eğer bir eşleşme farklı biçimlendirmeye sahip bölümleri kapsıyorsa, sonucun istenen stili kullandığından emin olmak için kontrol edin.

Android'de Sunum Metnini Biçimlendir Android'de PowerPoint Metnini Canlandırma