.NET ile PowerPoint Sunumlarında Metin Arama ve Değiştirme

Bu sayfa ne hakkında

Aspose.Slides for .NET ile PowerPoint sunumlarında metin arama, vurgulama ve değiştirme işlemlerini gerçekleştirirken her eşleşmeyi toplar.

Genel Bakış

Aspose.Slides for .NET, bireysel bir metin çerçevesinde veya tüm sunumda metin arayabilir, vurgulayabilir ve değiştirebilir. Her işlem, sonuç geri çağrısı aracılığıyla her eşleşme hakkında bir uygulamayı da bilgilendirebilir. Bu, bir sunumu güncellerken eşleşen metni, bağlamını, konumunu, metin çerçevesini ve slayt numarasını içeren bir denetim izi oluşturmayı mümkün kılar.

Bu özellikler, inceleme, redaksiyon, terminoloji kontrolleri, şablon temizliği ve otomatik raporlama iş akışları için kullanışlıdır.

Aşağıdaki ilk örneklerde, ilk slaytta aşağıdaki metni içeren tek bir metin kutusu bulunan “sample.pptx” adlı bir dosya kullanıyoruz:

Arama Kapsamını Seçin

ITextFrame yöntemiyle bir işlemi tek bir metin çerçevesiyle sınırlayabilirsiniz. Presentation yöntemiyle sunumdaki tüm uygulanabilir metni işleyebilirsiniz.

İşlem	Tek metin çerçevesi	Tüm sunum
Literal metni vurgula	ITextFrame.HighlightText	Presentation.HighlightText
Düzenli ifade eşleşmelerini vurgula	ITextFrame.HighlightRegex	Presentation.HighlightRegex
Literal metni değiştir	ITextFrame.ReplaceText	Presentation.ReplaceText
Düzenli ifade eşleşmelerini değiştir	ITextFrame.ReplaceRegex	Presentation.ReplaceRegex

Metin Eşleştirmeyi Yapılandırma

Literal metin işlemleri için, eşleşmeyi kontrol etmek üzere TextSearchOptions kullanın:

• TextSearchOptions.WholeWordsOnly eşleşmeleri yalnızca tam kelimelerle sınırlar.
• TextSearchOptions.CaseSensitive karakter büyük/küçük harf eşleşmesinin gerekip gerekmediğini kontrol eder.
• TextSearchOptions.IncludeNotes sunum seviyesindeki arama, değiştirme ve vurgulama işlemlerine slayt notlarını dahil eder.

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

Bir Metin Çerçevesinin Sahibini Belirleme

Genel metin işleme iş akışları, metin ararken, değiştirirken, doğrularken veya dışa aktarırken genellikle bir [ITextFrame] alır. Metin çerçevesine sahip sunum nesnesini belirlemek için ITextFrame.ParentShape ve ITextFrame.ParentCell kullanın.

Metin çerçevesi sahibi	ParentShape	ParentCell
Bir AutoShape veya metin içeren başka bir şekil	The owning IShape	null
Bir tablo hücresi	null	The owning ICell

Her iki özellik de salt‑okunur gezinme özellikleridir. Okunmaları metin çerçevesini hareket ettirmez veya sahibini değiştirmez. Genel kod, her iki değeri de null için kontrol etmeli ve hiçbir sahibin bulunmadığı durumları ele almalıdır.

Aşağıdaki örnek, bir sunumdaki metin çerçevelerini yinelemek için SlideUtil.GetAllTextFrames kullanır. Şekiller için şekil adını, şekil tipini ve içinde bulunduğu slaytı raporlar. Tablo hücreleri için sıfır tabanlı sütun ve satır koordinatlarını ve içinde bulunduğu slaytı raporlar.

using System;
using Aspose.Slides;
using Aspose.Slides.Util;

using var presentation = new Presentation("presentation.pptx");

var textFrames = SlideUtil.GetAllTextFrames(presentation, false);

foreach (var textFrame in textFrames)
{
    var ownerShape = textFrame.ParentShape;
    if (ownerShape != null)
    {
        var shapeName = string.IsNullOrEmpty(ownerShape.Name) ? "(unnamed)" : ownerShape.Name;
        var shapeType = GetShapeType(ownerShape);
        var slideLabel = GetSlideLabel(ownerShape.Slide);
        Console.WriteLine($"Shape: {shapeName}; type: {shapeType}; {slideLabel}");

        continue;
    }

    var ownerCell = textFrame.ParentCell;
    if (ownerCell != null)
    {
        var slideLabel = GetSlideLabel(ownerCell.Slide);
        Console.WriteLine($"Table cell: column {ownerCell.FirstColumnIndex}, row {ownerCell.FirstRowIndex}; {slideLabel}");
        continue;
    }

    Console.WriteLine("The text frame owner is not available as a shape or table cell.");
}

static string GetShapeType(IShape shape)
{
    if (shape is IGeometryShape geometryShape)
    {
        return geometryShape.ShapeType.ToString();
    }

    return shape.GetType().Name;
}

static string GetSlideLabel(IBaseSlide baseSlide)
{
    if (baseSlide is ISlide slide)
    {
        return $"slide {slide.SlideNumber}";
    }

    if (baseSlide is INotesSlide notesSlide)
    {
        return $"notes for slide {notesSlide.ParentSlide.SlideNumber}";
    }

    return baseSlide.GetType().Name;
}

SmartArt içeriği için, ISmartArtNode.Shapes içindeki şekilleri yineleyin ve her ISmartArtShape.TextFrame erişin. Metin çerçevesi, ilişkili şekle ITextFrame.ParentShape aracılığıyla izlenebilir, ITextFrame.ParentCell ise null dır. Bu nedenle, örnekteki şekil dalı SmartArt düğümlerinden gelen metni de işler.

Bir Geri Çağrı ile Eşleşme Bilgisi Toplama

IFindResultCallback uygulayarak her eşleşme için bir bildirim alabilirsiniz. Bunun IFindResultCallback.FoundResult yöntemi ilgili metin çerçevesini, kaynak metni, eşleşen metni ve eşleşme konumunu sağlar.

Geri çağrı doğrudan bir slayt numarası almaz. Aşağıdaki uygulama, bunu üst slayttan türetir ve slayt notlarında bulunan metni de işler. Null olabilen bir slayt numarası, aynı sonuç modelinin diğer slayt tiplerine ait metni temsil etmesine izin verir.

using System.Collections.Generic;
using Aspose.Slides;

public sealed class TextMatch
{
    public TextMatch(ITextFrame textFrame, string sourceText, string foundText, int textPosition, int? slideNumber)
    {
        TextFrame = textFrame;
        SourceText = sourceText;
        FoundText = foundText;
        TextPosition = textPosition;
        SlideNumber = slideNumber;
    }

    public ITextFrame TextFrame { get; }
    public string SourceText { get; }
    public string FoundText { get; }
    public int TextPosition { get; }
    public int? SlideNumber { get; }
}

public sealed class TextSearchCallback : IFindResultCallback
{
    public List<TextMatch> Results { get; } = new();

    public void FoundResult(ITextFrame textFrame, string sourceText, string foundText, int textPosition)
    {
        var slideNumber = GetSlideNumber(textFrame);
        var result = new TextMatch(textFrame, sourceText, foundText, textPosition, slideNumber);

        Results.Add(result);
    }

    private static int? GetSlideNumber(ITextFrame textFrame)
    {
        var parentSlide = textFrame.ParentShape?.Slide ?? textFrame.ParentCell?.Slide ?? textFrame.Slide;

        if (parentSlide is ISlide slide)
        {
            return slide.SlideNumber;
        }

        if (parentSlide is INotesSlide notesSlide)
        {
            return notesSlide.ParentSlide.SlideNumber;
        }

        return null;
    }
}

Değiştirme işlemleri için, FoundText orijinal eşleşen metni içerir; bu sayede geri çağrı hangi terimlerin değiştirildiğini tam olarak kaydedebilir.

Metni Vurgulama

ITextFrame.HighlightText yöntemini kullanarak bir metin çerçevesinde literal metin eşleşmelerini vurgulayabilirsiniz. Aramayı kontrol etmek için TextSearchOptions geçirin ve eşleşme ayrıntılarını toplamak için bir geri çağrı sağlayın.

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

using System;
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("sample.pptx");

// Get the first shape from the first slide.
var shape = (IAutoShape)presentation.Slides[0].Shapes[0];
var callback = new TextSearchCallback();

var substringSearchOptions = new TextSearchOptions
{
    CaseSensitive = false
};

// Highlight every occurrence of "try" in the text frame.
shape.TextFrame.HighlightText("try", Color.LightBlue, substringSearchOptions, callback);

var wholeWordSearchOptions = new TextSearchOptions
{
    WholeWordsOnly = true,
    CaseSensitive = false
};

// Highlight only the complete word "to".
shape.TextFrame.HighlightText("to", Color.Violet, wholeWordSearchOptions, callback);

foreach (var result in callback.Results)
{
    Console.WriteLine($"Found '{result.FoundText}' at position {result.TextPosition} on slide {result.SlideNumber}.");
}

presentation.Save("highlighted_text.pptx", SaveFormat.Pptx);

Sonuç:

Düzenli İfadelerle Metni Vurgulama

ITextFrame.HighlightRegex yöntemi, bir metin çerçevesinde 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 eşleşmeyi toplar:

using System.Drawing;
using System.Text.RegularExpressions;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("sample.pptx");

var shape = (IAutoShape)presentation.Slides[0].Shapes[0];
var callback = new TextSearchCallback();
var regex = new Regex(@"\b[^\s]{7,}\b");

shape.TextFrame.HighlightRegex(regex, Color.Yellow, callback);

presentation.Save("highlighted_text_using_regex.pptx", SaveFormat.Pptx);

Sonuç:

Sunum Genelinde Metni Vurgulama

Presentation.HighlightText ve Presentation.HighlightRegex yöntemlerini kullanarak bir sunumdaki tüm uygulanabilir metin çerçevelerinde arama yapabilirsiniz. Aşağıdaki örnek, bir literal terimi ve tüm e‑posta adreslerini vurgular; iki arama için sonuç koleksiyonları ayrı tutulur.

using System.Drawing;
using System.Text.RegularExpressions;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("presentation.pptx");

var termCallback = new TextSearchCallback();
var searchOptions = new TextSearchOptions
{
    WholeWordsOnly = true,
    CaseSensitive = false
};

presentation.HighlightText("confidential", Color.Orange, searchOptions, termCallback);

var emailCallback = new TextSearchCallback();
var emailRegex = new Regex(@"\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b", RegexOptions.IgnoreCase);

presentation.HighlightRegex(emailRegex, Color.Yellow, emailCallback);

presentation.Save("highlighted_presentation.pptx", SaveFormat.Pptx);

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

Literal metin için ITextFrame.ReplaceText, desen‑tabanlı değiştirme için ITextFrame.ReplaceRegex kullanın. Bu yöntemler, mevcut metin çerçevesi içinde eşleşen metni günceller; böylece çerçeve, yalnızca düz bir dizeden yeniden oluşturulmak yerine çevresindeki bölüm biçimlendirmesini korur.

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ğrı, iki işlemde de eşleşen orijinal terimleri kaydeder.

using System.Text.RegularExpressions;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("presentation.pptx");

var shape = (IAutoShape)presentation.Slides[0].Shapes[0];
var callback = new TextSearchCallback();
var searchOptions = new TextSearchOptions
{
    WholeWordsOnly = true,
    CaseSensitive = false
};

shape.TextFrame.ReplaceText("colour", "color", searchOptions, callback);

var versionRegex = new Regex(@"\bv\d+(?:\.\d+)*\b", RegexOptions.IgnoreCase);
shape.TextFrame.ReplaceRegex(versionRegex, "current version", callback);

presentation.Save("updated_text_frame.pptx", SaveFormat.Pptx);

Bir eşleşme, farklı biçimlendirmeye sahip bölümleri kapsıyorsa, çıktıyı gözden geçirerek hangi biçimin değiştirme metnine uygulanacağını doğrulayın.

Sunum Genelinde Metni Değiştirme

Presentation.ReplaceText ve Presentation.ReplaceRegex kullanarak aynı işlemleri tüm sunuma uygulayabilirsiniz. Bu, şablon temizliği, terminoloji güncellemeleri ve redaksiyon için kullanışlıdır.

using System.Text.RegularExpressions;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("presentation.pptx");

var callback = new TextSearchCallback();
var searchOptions = new TextSearchOptions
{
    WholeWordsOnly = true,
    CaseSensitive = true
};

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

var accountNumberRegex = new Regex(@"\bACCT-\d{6}\b");
presentation.ReplaceRegex(accountNumberRegex, "ACCT-REDACTED", callback);

presentation.Save("updated_presentation.pptx", SaveFormat.Pptx);

Raporlama için Eşleşmeleri Gruplama

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

using System;
using System.Linq;

var matchesBySlide = callback.Results.GroupBy(result => result.SlideNumber);

foreach (var slideGroup in matchesBySlide)
{
    var slideLabel = slideGroup.Key.HasValue ? slideGroup.Key.Value.ToString() : "Other";
    Console.WriteLine($"Slide: {slideLabel}");

    var matchesByTextFrame = slideGroup.GroupBy(result => result.TextFrame);
    foreach (var textFrameGroup in matchesByTextFrame)
    {
        Console.WriteLine($"  Text frame: {textFrameGroup.Key.Text}");

        foreach (var result in textFrameGroup)
        {
            Console.WriteLine($"    '{result.FoundText}' at position {result.TextPosition}; context: '{result.SourceText}'");
        }
    }
}

SSS

Nasıl tüm sunum yerine yalnızca bir metin kutusunu arayabilirim?

Şeklin metin çerçevesini alın ve o çerçeve üzerinde ITextFrame.HighlightText, ITextFrame.HighlightRegex, ITextFrame.ReplaceText veya ITextFrame.ReplaceRegex çağırın. Sunum‑seviyesi yöntemler ise tüm uygulanabilir metin çerçevelerini işler.

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

TextSearchOptions.WholeWordsOnly ve TextSearchOptions.CaseSensitive seçeneklerini true olarak ayarlayın ve bu seçenekleri literal‑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ı .NET Regex içinde tanımlayın.

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

Evet. Sunum‑seviyesi literal‑metin işlemi kullanırken TextSearchOptions.IncludeNotes seçeneğini true yapın. Yukarıdaki geri çağrı uygulaması, not slaydındaki bir eşleşmeyi üst slayt numarasına bağlar.

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

Vurgulama veya değiştirme işlemi sırasında bir IFindResultCallback uygulaması sağlayın. Geri çağrı, 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 gruplamak veya dışa aktarmak için saklayabilir.

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

ITextFrame.ReplaceText ve ITextFrame.ReplaceRegex mevcut metin çerçevesi içinde eşleşen metni değiştirir ve çevresindeki bölüm biçimlendirmesini tutar. Bir eşleşme farklı biçimlendirmeye sahip bölümleri kapsıyorsa, değiştirme işleminin istediğiniz stili kullandığını doğrulamak için sonucu inceleyin.