Enregistrer des présentations sur Android

Vue d’ensemble

Présentations ouvertes sur Android décrit comment utiliser la classe Presentation pour ouvrir une présentation. Cet article explique comment créer et enregistrer des présentations. La classe Presentation contient le contenu d’une présentation. Que vous créiez une présentation à partir de zéro ou que vous modifiiez une présentation existante, vous souhaiterez l’enregistrer une fois terminé. Avec Aspose.Slides for Android, vous pouvez enregistrer dans un file ou stream. Cet article explique les différentes façons d’enregistrer une présentation.

Enregistrer des présentations dans des fichiers

Enregistrez une présentation dans un fichier en appelant la méthode save de la classe Presentation. Passez le nom du fichier et le format d’enregistrement à la méthode. L’exemple suivant montre comment enregistrer une présentation avec Aspose.Slides.

// Instancier la classe Presentation qui représente un fichier de présentation.
Presentation presentation = new Presentation();
try {
    // Effectuer un travail ici...

    // Enregistrer la présentation dans un fichier.
    presentation.save("Output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Enregistrer des présentations dans des flux

Vous pouvez enregistrer une présentation dans un flux en transmettant un flux de sortie à la méthode save de la classe Presentation. Une présentation peut être écrite dans de nombreux types de flux. Dans l’exemple ci‑dessous, nous créons une nouvelle présentation et l’enregistrons dans un flux de fichier.

// Instancier la classe Presentation qui représente un fichier de présentation.
Presentation presentation = new Presentation();
try {
    OutputStream fileStream = new FileOutputStream("Output.pptx");
    try {
        // Enregistrer la présentation dans le flux.
        presentation.save(fileStream, SaveFormat.Pptx);
    } finally {
        fileStream.close();
    }
} finally {
    presentation.dispose();
}

Enregistrer des présentations avec un type de vue prédéfini

Aspose.Slides vous permet de définir la vue initiale que PowerPoint utilise lorsque la présentation générée s’ouvre via la classe ViewProperties. Utilisez la méthode setLastView avec une valeur de l’énumération ViewType.

Presentation presentation = new Presentation();
try {
    presentation.getViewProperties().setLastView(ViewType.SlideMasterView);
    presentation.save("SlideMasterView.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Enregistrer des présentations au format Strict Office Open XML

Aspose.Slides vous permet d’enregistrer une présentation au format Strict Office Open XML. Utilisez la classe PptxOptions et définissez sa propriété conformance lors de l’enregistrement. Si vous définissez Conformance.Iso29500_2008_Strict, le fichier de sortie est enregistré au format Strict Office Open XML.

L’exemple ci‑dessous crée une présentation et l’enregistre au format Strict Office Open XML.

PptxOptions options = new PptxOptions();
options.setConformance(Conformance.Iso29500_2008_Strict);

// Instancier la classe Presentation qui représente un fichier de présentation.
Presentation presentation = new Presentation();
try {
    // Enregistrer la présentation au format Strict Office Open XML.
    presentation.save("StrictOfficeOpenXml.pptx", SaveFormat.Pptx, options);
} finally {
    presentation.dispose();
}

Enregistrer des présentations au format Office Open XML en mode Zip64

Un fichier Office Open XML est une archive ZIP qui impose des limites de 4 GB (2^32 octets) sur la taille non compressée de tout fichier, la taille compressée de tout fichier et la taille totale de l’archive, ainsi qu’une limite de 65 535 (2^16‑1) fichiers. Les extensions du format ZIP64 élèvent ces limites à 2^64.

La méthode IPptxOptions.setZip64Mode vous permet de choisir quand utiliser les extensions du format ZIP64 lors de l’enregistrement d’un fichier Office Open XML.

Cette méthode peut être utilisée avec les modes suivants :

IfNecessary utilise les extensions ZIP64 uniquement si la présentation dépasse les limites ci‑dessus. C’est le mode par défaut.
Never n’utilise jamais les extensions ZIP64.
Always utilise toujours les extensions ZIP64.

Le code suivant montre comment enregistrer une présentation en PPTX avec les extensions ZIP64 activées :

PptxOptions pptxOptions = new PptxOptions();
pptxOptions.setZip64Mode(Zip64Mode.Always);

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("OutputZip64.pptx", SaveFormat.Pptx, pptxOptions);
} finally {
    presentation.dispose();
}

NOTE

Lorsque vous enregistrez avec Zip64Mode.Never, une PptxException est levée si la présentation ne peut pas être enregistrée au format ZIP32.

Enregistrer des présentations sans actualiser la vignette

La méthode PptxOptions.setRefreshThumbnail contrôle la génération de la vignette lors de l’enregistrement d’une présentation au format PPTX :

Si elle est définie sur true, la vignette est actualisée pendant l’enregistrement. C’est la valeur par défaut.
Si elle est définie sur false, la vignette actuelle est conservée. Si la présentation n’a pas de vignette, aucune n’est générée.

Dans le code ci‑dessous, la présentation est enregistrée au format PPTX sans actualiser sa vignette.

PptxOptions pptxOptions = new PptxOptions();
pptxOptions.setRefreshThumbnail(false);

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("Output.pptx", SaveFormat.Pptx, pptxOptions);
}
finally {
    presentation.dispose();
}

Info

Cette option permet de réduire le temps nécessaire à l’enregistrement d’une présentation au format PPTX.

Mise à jour de la progression d’enregistrement en pourcentage

L’interface IProgressCallback est utilisée via la méthode setProgressCallback exposée par l’interface ISaveOptions et la classe abstraite SaveOptions. Assignez une implémentation de IProgressCallback avec setProgressCallback pour recevoir des mises à jour de la progression d’enregistrement sous forme de pourcentage.

Les extraits de code suivants montrent comment utiliser IProgressCallback.

ISaveOptions saveOptions = new PdfOptions();
saveOptions.setProgressCallback(new ExportProgressHandler());

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("Output.pdf", SaveFormat.Pdf, saveOptions);
} finally {
    presentation.dispose();
}

class ExportProgressHandler implements IProgressCallback {
    public void reporting(double progressValue) {
        // Utilisez la valeur de pourcentage de progression ici.
        int progress = (int) progressValue;

        System.out.println(progress + "% of the file has been converted.");
    }
}

Info

Aspose a développé une application gratuite PowerPoint Splitter utilisant sa propre API. L’application vous permet de diviser une présentation en plusieurs fichiers en enregistrant les diapositives sélectionnées en nouveaux fichiers PPTX ou PPT.

FAQ

La « sauvegarde rapide » (sauvegarde incrémentielle) est‑elle prise en charge afin que seules les modifications soient écrites ?

Non. L’enregistrement crée le fichier cible complet à chaque fois ; la sauvegarde incrémentielle « fast save » n’est pas prise en charge.

Est‑il sûr d’enregistrer la même instance de Presentation depuis plusieurs threads ?

Non. Une instance de Presentation n’est pas thread‑safe ; enregistrez‑la depuis un seul thread.

Que se passe‑t‑il avec les hyperliens et les fichiers liés externement lors de l’enregistrement ?

Les hyperliens sont conservés. Les fichiers liés externement (par ex. des vidéos via des chemins relatifs) ne sont pas copiés automatiquement — assurez‑vous que les chemins référencés restent accessibles.

Puis‑je définir/enregistrer les métadonnées du document (Auteur, Titre, Société, Date) ?

Oui. Les propriétés standard du document sont prises en charge et seront écrites dans le fichier lors de l’enregistrement.

Convertir la présentation Gérer le diaporama sur Android