Ouvrir une présentation en Python

Vue d’ensemble

Au-delà de la création de présentations PowerPoint à partir de zéro, Aspose.Slides vous permet également d’ouvrir des présentations existantes. Après avoir chargé une présentation, vous pouvez récupérer des informations à son sujet, modifier le contenu des diapositives, ajouter de nouvelles diapositives, supprimer les diapositives existantes, et plus encore.

Ouvrir des présentations

Pour ouvrir une présentation existante, instanciez la classe Presentation et passez le chemin du fichier à son constructeur.

L’exemple Python suivant montre comment ouvrir une présentation et obtenir le nombre de diapositives :

import aspose.slides as slides

# Instanciez la classe Presentation et passez un chemin de fichier à son constructeur.
with slides.Presentation("sample.pptx") as presentation:
    # Affichez le nombre total de diapositives dans la présentation.
    print(presentation.slides.length)

Ouvrir des présentations protégées par mot de passe

Lorsque vous devez ouvrir une présentation protégée par mot de passe, transmettez le mot de passe via la propriété password de la classe LoadOptions pour la déchiffrer et la charger. Le code Python suivant montre cette opération :

import aspose.slides as slides

load_options = slides.LoadOptions()
load_options.password = "YOUR_PASSWORD"

with slides.Presentation("sample.pptx", load_options) as presentation:
    # Effectuez des opérations sur la présentation déchiffrée.

Ouvrir des présentations volumineuses

Aspose.Slides offre des options—en particulier la propriété blob_management_options de la classe LoadOptions—pour vous aider à charger des présentations volumineuses.

Ce code Python montre comment charger une présentation volumineuse (par exemple, 2 Go) :

import aspose.slides as slides
import os

file_path = "LargePresentation.pptx"

load_options = slides.LoadOptions()
# Choisissez le comportement KeepLocked—le fichier de présentation restera verrouillé pendant la durée de 
# l'instance Presentation, mais il n'est pas nécessaire de le charger en mémoire ou de le copier dans un fichier temporaire.
load_options.blob_management_options.presentation_locking_behavior = slides.PresentationLockingBehavior.KEEP_LOCKED
load_options.blob_management_options.is_temporary_files_allowed = True
load_options.blob_management_options.max_blobs_bytes_in_memory = 10 * 1024 * 1024  # 10 Mo

with slides.Presentation(file_path, load_options) as presentation:
    # La grande présentation a été chargée et peut être utilisée, tout en maintenant une faible consommation de mémoire.

    # Apportez des modifications à la présentation.
    presentation.slides[0].name = "Large presentation"

    # Enregistrez la présentation dans un autre fichier. La consommation de mémoire reste faible pendant cette opération.
    presentation.save("LargePresentation-copy.pptx", slides.export.SaveFormat.PPTX)

    # Ne faites pas cela ! Une exception d'E/S sera levée car le fichier est verrouillé jusqu'à la libération de l'objet présentation.
    os.remove(file_path)

# Il est correct de le faire ici. Le fichier source n'est plus verrouillé par l'objet présentation.
os.remove(file_path)

Info

Pour contourner certaines limitations lors de l’utilisation de flux, Aspose.Slides peut copier le contenu d’un flux. Charger une présentation volumineuse depuis un flux entraîne la copie de la présentation et peut ralentir le chargement. Par conséquent, lorsque vous devez charger une présentation volumineuse, nous recommandons fortement d’utiliser le chemin du fichier de présentation plutôt qu’un flux.

Lorsque vous créez une présentation contenant de gros objets (vidéo, audio, images haute résolution, etc.), vous pouvez utiliser la gestion BLOB pour réduire la consommation de mémoire.

Contrôler les ressources externes

Aspose.Slides fournit l’interface IResourceLoadingCallback qui vous permet de gérer les ressources externes. Le code Python suivant montre comment utiliser l’interface IResourceLoadingCallback :

# [TODO[not_supported_yet]: implémentation Python des interfaces .NET]

Charger des présentations sans objets binaires incorporés

Une présentation PowerPoint peut contenir les types d’objets binaires incorporés suivants :

projet VBA (accessible via Presentation.vba_project);
données incorporées d’objet OLE (accessible via OleEmbeddedDataInfo.embedded_file_data);
données binaires de contrôle ActiveX (accessible via Control.active_x_control_binary).

En utilisant la propriété LoadOptions.delete_embedded_binary_objects vous pouvez charger une présentation sans aucun objet binaire incorporé.

Cette propriété est utile pour supprimer les contenus binaires potentiellement malveillants. Le code Python suivant montre comment charger une présentation sans aucun contenu binaire incorporé :

import aspose.slides as slides

load_options = slides.LoadOptions()
load_options.delete_embedded_binary_objects = True

with slides.Presentation("malware.ppt", load_options) as presentation:
    # Effectuez des opérations sur la présentation.

FAQ

Comment savoir si un fichier est corrompu et ne peut pas être ouvert ?

Vous recevrez une exception de validation/parsing de format lors du chargement. Ces erreurs mentionnent souvent une structure ZIP invalide ou des enregistrements PowerPoint corrompus.

Que se passe-t-il si les polices requises sont manquantes lors de l’ouverture ?

Le fichier s’ouvrira, mais le rendu/export ultérieur pourra substituer les polices. Configurez les substitutions de polices ou ajoutez les polices requises à l’environnement d’exécution.

Qu’en est-il des médias incorporés (vidéo/audio) lors de l’ouverture ?

Ils deviennent disponibles en tant que ressources de la présentation. Si les médias sont référencés via des chemins externes, assurez-vous que ces chemins sont accessibles dans votre environnement ; sinon le rendu/export peut omettre les médias.

Créer une présentation en Python Examiner la présentation