# Buscar e Substituir Texto em Apresentações PowerPoint em Python

> Buscar, destacar e substituir texto em apresentações PowerPoint com Aspose.Slides for Python via .NET.

Source: https://docs.aspose.com/slides/pt/python-net/search-and-replace-text/
Updated: 2026-09-02

## **Visão geral**

Aspose.Slides for Python via .NET pode pesquisar, destacar e substituir texto em um quadro de texto individual ou em toda a apresentação. Esses recursos são úteis para revisão, remoção de informações sensíveis, verificação de terminologia, limpeza de modelos e outros fluxos de trabalho automatizados de processamento de documentos.

Nos primeiros exemplos abaixo, utilizamos um arquivo chamado "sample.pptx", que contém uma única caixa de texto no primeiro slide com o seguinte conteúdo:

![Texto de exemplo](sample_text.png)

## **Escolher o Escopo da Busca**

Use métodos em [TextFrame](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/) para limitar uma operação a um quadro de texto. Use métodos em [Presentation](https://reference.aspose.com/slides/pt/python-net/aspose.slides/presentation/) para processar todo o texto aplicável na apresentação.

| Operação | Um quadro de texto | Apresentação inteira |
|---|---|---|
| Destacar texto literal | [TextFrame.highlight_text](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/highlight_text/) | [Presentation.highlight_text](https://reference.aspose.com/slides/pt/python-net/aspose.slides/presentation/highlight_text/) |
| Destacar correspondências de expressão regular | [TextFrame.highlight_regex](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/highlight_regex/) | [Presentation.highlight_regex](https://reference.aspose.com/slides/pt/python-net/aspose.slides/presentation/highlight_regex/) |
| Substituir texto literal | [TextFrame.replace_text](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/replace_text/) | [Presentation.replace_text](https://reference.aspose.com/slides/pt/python-net/aspose.slides/presentation/replace_text/) |
| Substituir correspondências de expressão regular | [TextFrame.replace_regex](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/replace_regex/) | [Presentation.replace_regex](https://reference.aspose.com/slides/pt/python-net/aspose.slides/presentation/replace_regex/) |

## **Configurar Correspondência de Texto**

Para operações de texto literal, use [TextSearchOptions](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textsearchoptions/) para controlar a correspondência:

- [TextSearchOptions.whole_words_only](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textsearchoptions/whole_words_only/) limita as correspondências a palavras completas.
- [TextSearchOptions.case_sensitive](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textsearchoptions/case_sensitive/) controla se a diferenciação entre maiúsculas e minúsculas deve ser considerada.
- [TextSearchOptions.include_notes](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textsearchoptions/include_notes/) inclui as notas dos slides nas operações de busca, substituição e destaque em nível de apresentação.

As operações com expressões regulares utilizam uma string de padrão, portanto as regras de correspondência, como sensibilidade a maiúsculas/minúsculas e limites de palavras, são definidas pela própria expressão.

## **Destacar Texto**

Use o método [TextFrame.highlight_text](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/highlight_text/) para destacar correspondências de texto literal em um quadro de texto. Passe um [TextSearchOptions](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textsearchoptions/) para controlar a busca.

O exemplo de código abaixo destaca todas as ocorrências dos caracteres **"try"** e, em seguida, destaca apenas a palavra completa **"to"**.

```python
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

    # Destacar cada ocorrência de "try" no quadro de texto.
    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

    # Destacar apenas a palavra completa "to".
    shape.text_frame.highlight_text(
        "to", draw.Color.violet, whole_word_search_options, None
    )

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

O resultado:

![O texto destacado](highlighted_text.png)

## **Destacar Texto Usando Expressões Regulares**

O método [TextFrame.highlight_regex](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/highlight_regex/) destaca as correspondências de texto encontradas por uma expressão regular em um quadro de texto.

O código a seguir destaca todas as palavras que contêm sete ou mais caracteres:

```python
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
    )
```

O resultado:

![O texto destacado usando a expressão regular](highlighted_text_using_regex.png)

## **Destacar Texto em Toda a Apresentação**

Use [Presentation.highlight_text](https://reference.aspose.com/slides/pt/python-net/aspose.slides/presentation/highlight_text/) e [Presentation.highlight_regex](https://reference.aspose.com/slides/pt/python-net/aspose.slides/presentation/highlight_regex/) para pesquisar todos os quadros de texto aplicáveis em uma apresentação. O exemplo a seguir destaca um termo literal e todos os endereços de email:

```python
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
    )
```

## **Substituir Texto em um Quadro de Texto**

Use [TextFrame.replace_text](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/replace_text/) para texto literal e [TextFrame.replace_regex](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/replace_regex/) para substituição baseada em padrão. Esses métodos atualizam o texto correspondido dentro do quadro de texto existente, preservando a formatação das partes ao redor em vez de reconstruir o quadro de texto a partir de uma string simples.

O exemplo a seguir padroniza uma variante ortográfica e, em seguida, substitui rótulos de versão:

```python
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
    )
```

Se uma correspondência abranger partes com formatações diferentes, revise o resultado para confirmar qual formatação deve ser aplicada ao texto substituído.

## **Substituir Texto em Toda a Apresentação**

Use [Presentation.replace_text](https://reference.aspose.com/slides/pt/python-net/aspose.slides/presentation/replace_text/) e [Presentation.replace_regex](https://reference.aspose.com/slides/pt/python-net/aspose.slides/presentation/replace_regex/) para aplicar as mesmas operações em toda a apresentação. Isso é útil para limpeza de modelos, atualização de terminologia e remoção de informações sensíveis.

```python
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
    )
```

## **Perguntas Frequentes**

**Como posso pesquisar apenas uma caixa de texto em vez de toda a apresentação?**

Obtenha o quadro de texto da forma e chame [TextFrame.highlight_text](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/highlight_text/), [TextFrame.highlight_regex](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/highlight_regex/), [TextFrame.replace_text](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/replace_text/) ou [TextFrame.replace_regex](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/replace_regex/) nesse quadro de texto. Os métodos em nível de apresentação processam todos os quadros de texto aplicáveis.

**Como posso combinar palavras completas com a capitalização correta?**

Defina [TextSearchOptions.whole_words_only](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textsearchoptions/whole_words_only/) e [TextSearchOptions.case_sensitive](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textsearchoptions/case_sensitive/) como `True` e passe as opções para um método de destaque ou substituição de texto literal. Para expressões regulares, defina os limites de palavras e a sensibilidade a maiúsculas/minúsculas diretamente no padrão.

**A busca e a substituição podem incluir texto nas notas dos slides?**

Sim. Defina [TextSearchOptions.include_notes](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textsearchoptions/include_notes/) como `True` ao usar uma operação de texto literal em nível de apresentação.

**A substituição de texto preserva sua formatação?**

[TextFrame.replace_text](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/replace_text/) e [TextFrame.replace_regex](https://reference.aspose.com/slides/pt/python-net/aspose.slides/textframe/replace_regex/) modificam o texto correspondente dentro do quadro de texto existente e mantêm a formatação das partes ao redor. Se uma correspondência abranger trechos com formatações diferentes, inspecione o resultado para garantir que a substituição use o estilo desejado.