Recupera e aggiorna le proprietà di visualizzazione della presentazione in Python via Java

Introduzione

Nella visualizzazione normale di PowerPoint, la diapositiva appare tra un riquadro laterale per le miniature o la scaletta e un riquadro note sotto. Aspose.Slides per Python via Java espone le preferenze di modifica salvate della presentazione tramite Presentation.getViewProperties. Queste includono la disposizione dei riquadri, i livelli di zoom, la spaziatura della griglia e la visibilità dei commenti.

Informazioni su NormalViewProperties

Usa getNormalViewProperties per accedere alla classe NormalViewProperties. setShowOutlineIcons controlla se le icone appaiono accanto ai titoli delle diapositive nella scaletta. setSnapVerticalSplitter consente al riquadro laterale di agganciarsi allo stato ridotto quando l’utente lo restringe. setPreferSingleView indica una preferenza per visualizzare un solo riquadro nella finestra intera.

setVerticalBarState controlla il divisore tra il riquadro laterale e la diapositiva. setHorizontalBarState controlla il divisore sopra il riquadro note. Entrambi accettano un valore SplitterBarStateType di Minimized, Maximized o Restored.

Informazioni sul ripristino di NormalViewProperties

Quando un divisore viene ripristinato, getRestoredLeft fornisce la dimensione salvata del riquadro laterale e getRestoredTop fornisce la dimensione salvata dell’area superiore della diapositiva. Entrambi restituiscono un’istanza di NormalViewRestoredProperties. Il suo metodo setDimensionSize accetta una percentuale da 0 a 100, e setAutoAdjust controlla se l’editor adegua la dimensione quando la finestra viene ridimensionata.

Questo esempio aggiorna una presentazione esistente. Ripristina il divisore orizzontale, imposta la dimensione restituita da getRestoredTop all'80% con l’adattamento automatico abilitato, e massimizza il divisore verticale. Chiama anche setShowOutlineIcons per visualizzare le icone nella vista scaletta.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SplitterBarStateType

presentation = Presentation("demo.pptx")
try:
    normal_view_properties = presentation.getViewProperties().getNormalViewProperties()
    normal_view_properties.setHorizontalBarState(SplitterBarStateType.Restored)
    normal_view_properties.setVerticalBarState(SplitterBarStateType.Maximized)

    normal_view_properties.getRestoredTop().setAutoAdjust(True)
    normal_view_properties.getRestoredTop().setDimensionSize(80)
    normal_view_properties.setShowOutlineIcons(True)

    presentation.save("presentation_normal_view_state.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Imposta il valore di zoom predefinito

getSlideViewProperties e getNotesViewProperties memorizzano impostazioni di zoom indipendenti per l’editor. Queste impostazioni non influenzano le dimensioni delle diapositive, la riproduzione della presentazione o la risoluzione di esportazione delle immagini.

Questo esempio apre una presentazione esistente e chiama setVariableScale per adattare la diapositiva alla finestra di modifica. Per la pagina delle note, disabilita la scalatura automatica e chiama setScale per impostare uno zoom fisso dell'80%.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("demo.pptx")
try:
    view_properties = presentation.getViewProperties()
    view_properties.getSlideViewProperties().setVariableScale(True)
    notes_view = view_properties.getNotesViewProperties()
    notes_view.setVariableScale(False)
    notes_view.setScale(80)

    presentation.save("zoom.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Imposta la spaziatura della griglia

setGridSpacing imposta la distanza tra le linee della griglia di modifica in tutta la presentazione. Accetta un valore positivo in punti, con 72 punti per pollice. Questo esempio stampa la spaziatura corrente in una presentazione esistente e salva una griglia di un quarto di pollice impostando l’intervallo a 18 punti.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("demo.pptx")
try:
    grid_spacing = presentation.getViewProperties().getGridSpacing()
    print(f"Current grid spacing: {grid_spacing} points")

    presentation.getViewProperties().setGridSpacing(18.0)

    presentation.save("grid-spacing.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

La griglia si ripete a intervalli fissi. Guide di disegno segnano posizioni orizzontali o verticali individuali. Entrambi sono ausili di modifica e appaiono solo negli editor che li visualizzano. Le presentazioni e le esportazioni in PDF, immagini o SVG li omettono.

Mostra o nascondi i commenti all’apertura di una presentazione

setShowComments memorizza una preferenza che gli editor compatibili usano all’apertura della presentazione. Per una presentazione esistente con commenti, questo esempio stampa l’impostazione corrente e salva una copia con i commenti nascosti. Chiama anche setLastView con ViewType.SlideView in modo che la copia si apra nella vista diapositiva.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import NullableBool, Presentation, SaveFormat, ViewType

presentation = Presentation("comments.pptx")
try:
    show_comments = presentation.getViewProperties().getShowComments()
    print(f"Current comment visibility: {show_comments}")

    presentation.getViewProperties().setShowComments(NullableBool.False_)
    presentation.getViewProperties().setLastView(ViewType.SlideView)
    
    presentation.save("comments-hidden.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Nascondere i commenti ne conserva il testo, gli autori, le posizioni, le risposte e gli stati. Per modificare i commenti stessi, consulta Commenti della presentazione. Le impostazioni di esportazione controllano se i commenti appaiono in PDF, HTML, immagini, note o dispense.

FAQ

Perché la griglia è nascosta quando riapro la presentazione?
La presentazione salva l’intervallo della griglia. Per vedere la griglia, abilita la visibilità della griglia nell’editor.

La cancellazione delle guide di disegno modifica la spaziatura della griglia?
No. Aggiungere, spostare o cancellare una guida lascia l’intervallo della griglia invariato.

Le diverse sezioni di una presentazione possono avere impostazioni di visualizzazione diverse?
No. Presentation.getViewProperties si applica all’intera presentazione.

Posso salvare impostazioni di visualizzazione diverse per utenti diversi?
Il file memorizza un unico set di proprietà di visualizzazione per tutti. Un editor può anche applicare le preferenze locali di un utente.

Posso salvare le impostazioni di visualizzazione in un modello?
Sì. Le presentazioni create dal modello ereditano le impostazioni di visualizzazione salvate.