Aspose.Slides for .NET 24.6 Release Notes

using (Presentation presentation = new Presentation("pres.pptx"))
{
    presentation.ReplaceText("the", "***", new TextSearchOptions() {WholeWordsOnly = true}, null);
    presentation.Save("pres-out.pptx", SaveFormat.Pptx);
}

public class Example
{
    public void Execute()
    {
        using (Presentation pres = new Presentation("pres.pptx"))
        {
            // Create callback.
            FindResultCallback callback = new FindResultCallback();

            // Highlight all words "address". 
            pres.HighlightText("address", Color.Yellow, new TextSearchOptions(), callback);

            // Output the number of found fragments of the given text. 
            Console.WriteLine(callback.Count);

            // Output data for each word "address" found. 
            foreach (WordInfo info in callback.Words)
            {
                Console.WriteLine("{0}, {1}", info.FoundText, info.TextPosition);
            }

            // Get all the data about the found cases in the first slide. 
            WordInfo[] elements = callback.GetElemensForSlide(callback.SlideNumbers[0]);
            
           pres.Save("pres-out.pptx",SaveFormat.Pptx);
        }
    }
}

/// <summary>
/// Class that provides information about all found occurrences of a given text.
/// </summary>
internal class FindResultCallback : IFindResultCallback
{
    // Array of retrieved text information.
    public readonly List<WordInfo> Words = new List<WordInfo>();

    /// <summary>
    /// The number of matches found to a given text.
    /// </summary>
    public int Count
    {
        get { return Words.Count; }
    }

    /// <summary>
    /// Gets all slides in which the given text was found.
    /// </summary>
    public int[] SlideNumbers
    {
        get
        {
            var slideNumbers = new List<int>();
            foreach (var element in Words)
            {
                int slideNumber = ((Slide)element.TextFrame.Slide).SlideNumber;
                if (!slideNumbers.Contains(slideNumber))
                    slideNumbers.Add(slideNumber);
            }
            return slideNumbers.ToArray();
        }
    }

    /// <summary>
    /// Gets all occurrences of the found text on the slide.
    /// </summary>
    /// <param name="slideNumber">Slide number</param>
    public WordInfo[] GetElemensForSlide(int slideNumber)
    {
        var foundElements = new List<WordInfo>();
        foreach (var element in Words)
        {
            if (((Slide)element.TextFrame.Slide).SlideNumber == slideNumber)
                foundElements.Add(element);
        }
        return foundElements.ToArray();
    }

    /// <summary>
    /// Callback method that receives data about the found text.
    /// </summary>
    /// <param name="textFrame">The <see cref="ITextFrame"/> in which the text was found.</param>
    /// <param name="sourceText">The source text in which the text was found.</param>
    /// <param name="foundText">The found text.</param>
    /// <param name="textPosition">The position of the found text.</param>
    public void FoundResult(ITextFrame textFrame, string oldText, string foundText, int textPosition)
    {
        Words.Add(new WordInfo(textFrame, oldText, foundText, textPosition));
    }
}

/// <summary>
/// Class providing information about each text found in the presentation.
/// </summary>
public class WordInfo
{
    internal WordInfo(ITextFrame textFrame, string sourceText, string foundText, int textPosition)
    {
        TextFrame = textFrame;
        SourceText = sourceText;
        FoundText = foundText;
        TextPosition = textPosition;
    }

    /// <summary>
    /// Gets found text.
    /// </summary>
    public string FoundText { get; }

    /// <summary>
    /// Gets the source text for the TextFrame in which the text was found.
    /// </summary>
    public string SourceText { get;}

    /// <summary>
    /// The position of the found text in the text frame.
    /// </summary>
    public int TextPosition { get; }

    /// <summary>
    /// The text frame in which the text was found.
    /// </summary>
    public ITextFrame TextFrame { get; }
}

using (Presentation presentation = new Presentation("pres.pptx"))
{
    // highlighting all words 'important'
    ((AutoShape)presentation.Slides[0].Shapes[0]).TextFrame.HighlightText("important", Color.LightBlue);
    // highlighting all separate 'the' occurrences
    ((AutoShape)presentation.Slides[0].Shapes[0]).TextFrame.HighlightText("the", Color.Violet, new TextSearchOptions()
        { WholeWordsOnly = true }, null);
    presentation.Save("pres-out2.pptx", SaveFormat.Pptx);
}

using (Presentation presentation = new Presentation("pres.pptx"))
{
    Regex regex = new Regex(@"\b[^\s]{10,}\b");
    // highlighting all words with 10 or more characters
    ((AutoShape)presentation.Slides[0].Shapes[0]).TextFrame.HighlightRegex(regex, Color.Blue, null);
    presentation.Save("SomePresentation-out.pptx", SaveFormat.Pptx);
}

using (Presentation presentation = new Presentation("SomePresentation.pptx"))
{
    // Replace all separate 'the' occurrences with '***'
    ((AutoShape)presentation.Slides[0].Shapes[0]).TextFrame.ReplaceText("the", "***", new TextSearchOptions()
        { WholeWordsOnly = true }, null);
    presentation.Save("SomePresentation-out2.pptx", SaveFormat.Pptx);
}

using (Presentation presentation = new Presentation("pres.pptx"))
{
    Regex regex = new Regex(@"\b[^\s]{5,}\b");
    // Replace all words with 10 or more characters with '***'
    ((AutoShape)presentation.Slides[0].Shapes[0]).TextFrame.ReplaceRegex(regex, "***", null);
    presentation.Save("SomePresentation-out.pptx", SaveFormat.Pptx);
}

using (Presentation presentation = new Presentation("pres.pptx"))
{
    // highlighting all separate 'the' occurrences
    presentation.HighlightText("the", Color.Violet, new TextSearchOptions() {WholeWordsOnly = true}, null);
    // highlight all 'abi' character sequences
    presentation.HighlightText("abi", Color.Red);
    presentation.Save("pres-out.pptx", SaveFormat.Pptx);
}

using (Presentation presentation = new Presentation("pres.pptx"))
{
    Regex regex = new Regex(@"\b[^\s]{10,}\b");
    // highlighting all words with 10 or more characters
    presentation.HighlightRegex(regex, Color.Blue, null);
    presentation.Save("pres-out.pptx", SaveFormat.Pptx);
}

using (Presentation presentation = new Presentation("SomePresentation.pptx"))
{
    // Replace all separate 'the' occurrences with '***'
    presentation.ReplaceText("the", "***", new TextSearchOptions() {WholeWordsOnly = true}, null);
    presentation.Save("SomePresentation-out2.pptx", SaveFormat.Pptx);
}

using (Presentation presentation = new Presentation("SomePresentation.pptx"))
{
    Regex regex = new Regex(@"\b[^\s]{10,}\b");
    // Replace all words with 10 or more characters with '***'
    presentation.ReplaceRegex(regex, "***", null);
    presentation.Save("SomePresentation-out.pptx", SaveFormat.Pptx);
}

using (Presentation pres = new Presentation("pres.pptx"))
{
    RenderingOptions options = new RenderingOptions();
    options.GradientStyle = GradientStyle.PowerPointUI;
    IImage img = pres.Slides[0].GetImage(options, 2f, 2f);
}