Recherche et remplacement de texte dans les présentations PowerPoint en Python
Vue d’ensemble
Aspose.Slides for Python via .NET peut rechercher, mettre en évidence et remplacer du texte dans un cadre de texte individuel ou dans l’ensemble d’une présentation. Ces fonctionnalités sont utiles pour la révision, la rédaction, la vérification de terminologie, le nettoyage de modèles et d’autres flux de travail automatisés de traitement de documents.
Dans les premiers exemples ci‑dessous, nous utilisons un fichier nommé “sample.pptx”, qui contient une seule zone de texte sur la première diapositive avec le texte suivant :
Choisir l’étendue de la recherche
Utilisez les méthodes sur TextFrame pour limiter une opération à un seul cadre de texte. Utilisez les méthodes sur Presentation pour traiter tous les textes applicables dans la présentation.
| Opération | Un cadre de texte | Présentation entière |
|---|---|---|
| Mettre en évidence le texte littéral | TextFrame.highlight_text | Presentation.highlight_text |
| Mettre en évidence les correspondances d’expression régulière | TextFrame.highlight_regex | Presentation.highlight_regex |
| Remplacer le texte littéral | TextFrame.replace_text | Presentation.replace_text |
| Remplacer les correspondances d’expression régulière | TextFrame.replace_regex | Presentation.replace_regex |
Configurer la correspondance de texte
Pour les opérations de texte littéral, utilisez TextSearchOptions pour contrôler la correspondance :
- TextSearchOptions.whole_words_only limite les correspondances aux mots complets.
- TextSearchOptions.case_sensitive contrôle si la casse des caractères doit correspondre.
- TextSearchOptions.include_notes inclut les notes de diapositive dans les opérations de recherche, de remplacement et de mise en évidence au niveau de la présentation.
Les opérations d’expression régulière utilisent une chaîne de modèle, de sorte que les règles de correspondance telles que la sensibilité à la casse et les limites de mots sont définies par l’expression.
Mettre en évidence le texte
Utilisez la méthode TextFrame.highlight_text pour mettre en évidence les correspondances de texte littéral dans un cadre de texte. Passez TextSearchOptions pour contrôler la recherche.
L’exemple de code ci‑dessous met en évidence toutes les occurrences des caractères “try” puis ne met en évidence que le mot complet “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
# Mettre en surbrillance chaque occurrence de "try" dans le cadre de texte.
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
# Mettre en surbrillance uniquement le mot complet "to".
shape.text_frame.highlight_text(
"to", draw.Color.violet, whole_word_search_options, None
)
presentation.save("highlighted_text.pptx", slides.export.SaveFormat.PPTX)
Le résultat :
Mettre en évidence le texte à l’aide d’expressions régulières
La méthode TextFrame.highlight_regex met en évidence les correspondances de texte trouvées par une expression régulière dans un cadre de texte.
Le code suivant met en évidence tous les mots contenant sept caractères ou plus :
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
)
Le résultat :
Mettre en évidence le texte sur l’ensemble d’une présentation
Utilisez Presentation.highlight_text et Presentation.highlight_regex pour rechercher tous les cadres de texte applicables dans une présentation. L’exemple suivant met en évidence un terme littéral et toutes les adresses e‑mail :
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
)
Remplacer le texte dans un cadre de texte
Utilisez TextFrame.replace_text pour le texte littéral et TextFrame.replace_regex pour le remplacement basé sur un modèle. Ces méthodes mettent à jour le texte correspondant dans le cadre de texte existant, qui conserve le formatage de la portion environnante au lieu de reconstruire le cadre de texte à partir d’une chaîne simple.
L’exemple suivant uniformise une variante orthographique puis remplace les libellés de version :
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
)
Si une correspondance couvre des portions avec un formatage différent, examinez la sortie pour confirmer quel formatage doit être appliqué au texte de remplacement.
Remplacer le texte sur l’ensemble d’une présentation
Utilisez Presentation.replace_text et Presentation.replace_regex pour appliquer les mêmes opérations sur toute la présentation. Cela est utile pour le nettoyage de modèles, les mises à jour de terminologie et la rédaction.
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
)
FAQ
Comment puis‑je rechercher uniquement une zone de texte au lieu de toute la présentation ?
Obtenez le cadre de texte de la forme et appelez TextFrame.highlight_text, TextFrame.highlight_regex, TextFrame.replace_text, ou TextFrame.replace_regex sur ce cadre de texte. Les méthodes au niveau de la présentation traitent tous les cadres de texte applicables à la place.
Comment puis‑je correspondre à des mots complets avec la bonne capitalisation ?
Définissez TextSearchOptions.whole_words_only et TextSearchOptions.case_sensitive sur True, puis passez les options à une méthode de mise en évidence ou de remplacement de texte littéral. Pour les expressions régulières, définissez les limites de mots et la sensibilité à la casse directement dans le modèle.
La recherche et le remplacement peuvent‑ils inclure le texte des notes de diapositive ?
Oui. Définissez TextSearchOptions.include_notes sur True lors de l’utilisation d’une opération de texte littéral au niveau de la présentation.
Le remplacement du texte préserve‑t‑il son formatage ?
TextFrame.replace_text et TextFrame.replace_regex modifient le texte correspondant dans le cadre de texte existant et conservent le formatage de la portion environnante. Si une correspondance couvre des portions avec un formatage différent, inspectez le résultat pour vous assurer que le remplacement utilise le style souhaité.