Sök och ersätt text i PowerPoint-presentationer i Python

Vad den här sidan handlar om

Sök, markera och ersätt text i PowerPoint-presentationer med Aspose.Slides för Python via .NET.

Översikt

Aspose.Slides for Python via .NET kan söka, markera och ersätta text i en enskild textram eller i en hel presentation. Dessa funktioner är användbara för granskning, redigering, terminologikontroller, mallrensning och andra automatiserade dokumentbehandlingsarbetsflöden.

I de första exemplen nedan använder vi en fil med namnet “sample.pptx” som innehåller en enda textruta på den första bilden med följande text:

Exempeltext

Välj sökområde

Använd metoder på TextFrame för att begränsa en operation till en enda textram. Använd metoder på Presentation för att bearbeta all tillämplig text i presentationen.

Operation	En textram	Hela presentationen
Markera bokstavlig text	TextFrame.highlight_text	Presentation.highlight_text
Markera reguljära uttrycksmatchningar	TextFrame.highlight_regex	Presentation.highlight_regex
Ersätt bokstavlig text	TextFrame.replace_text	Presentation.replace_text
Ersätt reguljära uttrycksmatchningar	TextFrame.replace_regex	Presentation.replace_regex

Konfigurera textmatchning

För bokstavliga textoperationer, använd TextSearchOptions för att styra matchning:

TextSearchOptions.whole_words_only begränsar matchningar till hela ord.
TextSearchOptions.case_sensitive styr om teckenens versal‑/gemener måste matcha.
TextSearchOptions.include_notes inkluderar bildanteckningar i sök‑, ersättnings‑ och markeringsoperationer på presentationsnivå.

Reguljära uttrycksoperationer använder en mönstersträng, så matchningsregler såsom skiftlägeskänslighet och ordgränser definieras av själva uttrycket.

Markera text

Använd metoden TextFrame.highlight_text för att markera bokstavliga textmatchningar i en textram. Skicka in TextSearchOptions för att styra sökningen.

Kodexemplet nedan markerar alla förekomster av tecknen “try” och markerar sedan endast hela ordet “to”.

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]

    substring_search_options = slides.TextSearchOptions()
    substring_search_options.case_sensitive = False

    # Markera varje förekomst av "try" i textramen.
    shape.text_frame.highlight_text(
        "try", draw.Color.light_blue, substring_search_options, None
    )

    whole_word_search_options = slides.TextSearchOptions()
    whole_word_search_options.whole_words_only = True
    whole_word_search_options.case_sensitive = False

    # Markera endast hela ordet "to".
    shape.text_frame.highlight_text(
        "to", draw.Color.violet, whole_word_search_options, None
    )

    presentation.save("highlighted_text.pptx", slides.export.SaveFormat.PPTX)

Resultatet:

Den markerade texten

Markera text med reguljära uttryck

Metoden TextFrame.highlight_regex markerar textmatchningar som hittas med ett reguljärt uttryck i en textram.

Följande kod markerar alla ord som innehåller sju eller fler tecken:

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]
    word_pattern = r"\b[^\s]{7,}\b"

    shape.text_frame.highlight_regex(word_pattern, draw.Color.yellow, None)

    presentation.save(
        "highlighted_text_using_regex.pptx", slides.export.SaveFormat.PPTX
    )

Resultatet:

Den markerade texten med reguljärt uttryck

Markera text i hela presentationen

Använd Presentation.highlight_text och Presentation.highlight_regex för att söka igenom alla tillämpliga textramar i en presentation. Följande exempel markerar ett bokstavligt begrepp och alla e‑postadresser:

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    search_options = slides.TextSearchOptions()
    search_options.whole_words_only = True
    search_options.case_sensitive = False

    presentation.highlight_text(
        "confidential", draw.Color.orange, search_options, None
    )

    email_pattern = r"(?i)\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b"
    presentation.highlight_regex(email_pattern, draw.Color.yellow)

    presentation.save(
        "highlighted_presentation.pptx", slides.export.SaveFormat.PPTX
    )

Ersätt text i en textram

Använd TextFrame.replace_text för bokstavlig text och TextFrame.replace_regex för mönsterbaserad ersättning. Dessa metoder uppdaterar den matchade texten i den befintliga textramen, som behåller formateringen i omkringliggande delar istället för att bygga om textramen från en enkel sträng.

Följande exempel standardiserar en stavningsvariant och ersätter sedan versionsetiketter:

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]

    search_options = slides.TextSearchOptions()
    search_options.whole_words_only = True
    search_options.case_sensitive = False

    shape.text_frame.replace_text(
        "colour", "color", search_options, None
    )

    version_pattern = r"(?i)\bv\d+(?:\.\d+)*\b"
    shape.text_frame.replace_regex(version_pattern, "current version")

    presentation.save(
        "updated_text_frame.pptx", slides.export.SaveFormat.PPTX
    )

Om en matchning sträcker sig över delar med olika formatering, granska resultatet för att bekräfta vilken formatering som ska tillämpas på den ersatta texten.

Ersätt text i hela presentationen

Använd Presentation.replace_text och Presentation.replace_regex för att tillämpa samma operationer i hela presentationen. Detta är användbart för mallrensning, terminologiska uppdateringar och redigering.

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    search_options = slides.TextSearchOptions()
    search_options.whole_words_only = True
    search_options.case_sensitive = True

    presentation.replace_text(
        "Contoso", "Example Corp", search_options, None
    )

    account_number_pattern = r"\bACCT-\d{6}\b"
    presentation.replace_regex(account_number_pattern, "ACCT-REDACTED")

    presentation.save(
        "updated_presentation.pptx", slides.export.SaveFormat.PPTX
    )

Vanliga frågor

Hur kan jag söka endast i en textruta istället för hela presentationen?

Få åtkomst till figurens textram och anropa TextFrame.highlight_text, TextFrame.highlight_regex, TextFrame.replace_text eller TextFrame.replace_regex på den textramen. Metoder på presentationsnivå bearbetar alla tillämpliga textramar istället.

Hur kan jag matcha hela ord med korrekt versalisering?

Sätt TextSearchOptions.whole_words_only och TextSearchOptions.case_sensitive till True och skicka in alternativen till en metod för markering eller ersättning av bokstavlig text. För reguljära uttryck definieras ordgränser och skiftlägeskänslighet i själva mönstret.

Kan sökning och ersättning inkludera text i bildanteckningar?

Ja. Sätt TextSearchOptions.include_notes till True när du använder en operation för bokstavlig text på presentationsnivå.

Behåller ersättning av text dess formatering?

TextFrame.replace_text och TextFrame.replace_regex modifierar den matchade texten i den befintliga textramen och behåller formateringen i de omgivande delarna. Om en matchning sträcker sig över delar med olika formatering, granska resultatet för att säkerställa att den ersatta texten använder önskad stil.

Formatera presentationstext i Python Animera PowerPoint-text i Python