Aprire presentazioni su Android

Introduzione

Oltre a creare presentazioni PowerPoint da zero, Aspose.Slides consente anche di aprire presentazioni esistenti. Dopo aver caricato una presentazione, è possibile recuperare informazioni su di essa, modificare il contenuto delle diapositive, aggiungere nuove diapositive, rimuovere quelle esistenti e altro ancora.

Aprire presentazioni

Per aprire una presentazione esistente, istanzia la classe Presentation e passa il percorso del file al suo costruttore.

Il seguente esempio Java mostra come aprire una presentazione e ottenere il numero di diapositive:

// Istanzia la classe Presentation e passa un percorso file al suo costruttore.
Presentation presentation = new Presentation("Sample.pptx");
try {
    // Stampa il numero totale di diapositive nella presentazione.
    System.out.println(presentation.getSlides().size());
} finally {
    presentation.dispose();
}

Aprire presentazioni protette da password

Quando è necessario aprire una presentazione protetta da password, passa la password tramite il metodo setPassword della classe LoadOptions per decrittarla e caricarla. Il seguente codice Java dimostra questa operazione:

LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("YOUR_PASSWORD");

Presentation presentation = new Presentation("Sample.pptx", loadOptions);
try {
    // Esegui operazioni sulla presentazione decrittata.
} finally {
    presentation.dispose();
}

Aprire presentazioni di grandi dimensioni

Aspose.Slides fornisce opzioni—in particolare il metodo getBlobManagementOptions nella classe LoadOptions—per aiutarti a caricare presentazioni di grandi dimensioni.

Il seguente codice Java dimostra come caricare una presentazione di grandi dimensioni (ad esempio, 2 GB):

final String filePath = "LargePresentation.pptx";

LoadOptions loadOptions = new LoadOptions();
// Scegli il comportamento KeepLocked — il file della presentazione rimarrà bloccato per tutta la durata di
// l'istanza di Presentation, ma non è necessario caricarlo in memoria né copiarlo in un file temporaneo.
loadOptions.getBlobManagementOptions().setPresentationLockingBehavior(PresentationLockingBehavior.KeepLocked);
loadOptions.getBlobManagementOptions().setTemporaryFilesAllowed(true);
loadOptions.getBlobManagementOptions().setMaxBlobsBytesInMemory(10 * 1024 * 1024); // 10 MB

Presentation presentation = new Presentation(filePath, loadOptions);
try {
    // La presentazione grande è stata caricata e può essere usata, mentre il consumo di memoria rimane basso.

    // Apporta modifiche alla presentazione.
    presentation.getSlides().get_Item(0).setName("Large presentation");

    // Salva la presentazione in un altro file. Il consumo di memoria rimane basso durante questa operazione.
    presentation.save("LargePresentation-copy.pptx", SaveFormat.Pptx);

    // Non farlo! Verrà sollevata un'eccezione I/O perché il file è bloccato fino a quando l'oggetto Presentation non viene eliminato.
    //Files.delete(Paths.get(filePath));
} finally {
    presentation.dispose();
}

// È corretto farlo qui. Il file sorgente non è più bloccato dall'oggetto Presentation.
Files.delete(Paths.get(filePath));

Info

Per aggirare alcune limitazioni quando si lavora con gli stream, Aspose.Slides può copiare il contenuto di uno stream. Caricare una presentazione di grandi dimensioni da uno stream provoca la copia della presentazione e può rallentare il caricamento. Pertanto, quando è necessario caricare una presentazione di grandi dimensioni, consigliamo vivamente di utilizzare il percorso del file della presentazione invece di uno stream.

Quando si crea una presentazione che contiene oggetti di grandi dimensioni (video, audio, immagini ad alta risoluzione, ecc.), è possibile utilizzare la BLOB management per ridurre il consumo di memoria.

Controllare risorse esterne

Aspose.Slides fornisce l’interfaccia IResourceLoadingCallback che consente di gestire risorse esterne. Il seguente codice Java mostra come utilizzare l’interfaccia IResourceLoadingCallback:

LoadOptions loadOptions = new LoadOptions();
loadOptions.setResourceLoadingCallback(new ImageLoadingHandler());

Presentation presentation = new Presentation("Sample.pptx", loadOptions);

class ImageLoadingHandler implements IResourceLoadingCallback {
    public int resourceLoading(IResourceLoadingArgs args) {
        if (args.getOriginalUri().endsWith(".jpg")) {
            try {
                // Carica un'immagine sostitutiva.
                byte[] imageData = getImageBytes("aspose-logo.jpg"); // Usa qualsiasi metodo per ottenere i byte
                args.setData(imageData);
                return ResourceLoadingAction.UserProvided;
            } catch (RuntimeException ex) {
                return ResourceLoadingAction.Skip;
            }  catch (IOException ex) {
                ex.printStackTrace();
            }
        } else if (args.getOriginalUri().endsWith(".png")) {
            // Imposta un URL sostitutivo.
            args.setUri("http://www.google.com/images/logos/ps_logo2.png");
            return ResourceLoadingAction.Default;
        }
        // Ignora tutte le altre immagini.
        return ResourceLoadingAction.Skip;
    }
}

Caricare presentazioni senza oggetti binari incorporati

Una presentazione PowerPoint può contenere i seguenti tipi di oggetti binari incorporati:

• progetto VBA (accessibile tramite IPresentation.getVbaProject);
• dati incorporati di oggetti OLE (accessibili tramite IOleEmbeddedDataInfo.getEmbeddedFileData);
• dati binari di controlli ActiveX (accessibili tramite IControl.getActiveXControlBinary).

Utilizzando il metodo ILoadOptions.setDeleteEmbeddedBinaryObjects è possibile caricare una presentazione senza alcun oggetto binario incorporato.

Questo metodo è utile per rimuovere contenuti binari potenzialmente malevoli. Il seguente codice Java dimostra come caricare una presentazione senza alcun contenuto binario incorporato:

LoadOptions loadOptions = new LoadOptions();
loadOptions.setDeleteEmbeddedBinaryObjects(true);

Presentation presentation = new Presentation("malware.ppt", loadOptions);
try {
    // Esegui operazioni sulla presentazione.
} finally {
    presentation.dispose();
}

FAQ

Come posso capire se un file è corrotto e non può essere aperto?

Durante il caricamento verrà generata un’eccezione di convalida/parsing del formato. Tali errori spesso segnalano una struttura ZIP non valida o record PowerPoint danneggiati.

Cosa succede se i caratteri richiesti mancano durante l’apertura?

Il file si aprirà, ma in seguito la rendering/export potrebbe sostituire i caratteri. Configure font substitutions o add the required fonts all’ambiente di esecuzione.

Cosa succede ai media incorporati (video/audio) durante l’apertura?

Diventano disponibili come risorse della presentazione. Se i media sono referenziati tramite percorsi esterni, assicurati che tali percorsi siano accessibili nel tuo ambiente; altrimenti la rendering/export potrebbe omettere i media.