Recuperar e Atualizar Propriedades de Visualização da Apresentação em Python via Java
Introdução
Na visualização normal do PowerPoint, o slide aparece entre um painel lateral para miniaturas ou um contorno e um painel de notas abaixo. Aspose.Slides for Python via Java expõe as preferências de edição salvas da apresentação através de Presentation.getViewProperties. Elas incluem o layout dos painéis, níveis de zoom, espaçamento da grade e visibilidade de comentários.
Sobre NormalViewProperties
Use getNormalViewProperties para acessar a classe NormalViewProperties. setShowOutlineIcons controla se ícones aparecem ao lado dos títulos dos slides no contorno. setSnapVerticalSplitter permite que o painel lateral se ajuste ao estado minimizado quando o usuário o reduz. setPreferSingleView indica a preferência por exibir um único painel na janela completa.
setVerticalBarState controla o divisor entre o painel lateral e o slide. setHorizontalBarState controla o divisor acima do painel de notas. Ambos aceitam um valor do tipo SplitterBarStateType de Minimized, Maximized ou Restored.
Sobre Restaurar NormalViewProperties
Quando um divisor é restaurado, getRestoredLeft fornece o tamanho salvo do painel lateral e getRestoredTop fornece o tamanho salvo da área superior do slide. Ambos retornam uma instância de NormalViewRestoredProperties. Seu método setDimensionSize aceita uma porcentagem de 0 a 100, e setAutoAdjust controla se o editor ajusta o tamanho quando a janela é redimensionada.
Este exemplo atualiza uma apresentação existente. Ele restaura o divisor horizontal, define o tamanho retornado por getRestoredTop para 80 % com ajuste automático habilitado e maximiza o divisor vertical. Também chama setShowOutlineIcons para exibir ícones na visualização de contorno.
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()
Definir o Valor de Zoom Padrão
getSlideViewProperties e getNotesViewProperties armazenam configurações de zoom independentes para o editor. Essas configurações não afetam as dimensões dos slides, a reprodução da apresentação ou a resolução da exportação de imagens.
Este exemplo abre uma apresentação existente e chama setVariableScale para ajustar o slide à janela de edição. Para a página de notas, desabilita o dimensionamento automático e chama setScale para definir um zoom fixo de 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()
Definir o Espaçamento da Grade
setGridSpacing define a distância entre as linhas da grade de edição em toda a apresentação. Recebe um valor positivo em pontos, com 72 pontos por polegada. Este exemplo imprime o espaçamento atual em uma apresentação existente e salva uma grade de um quarto de polegada ao definir o intervalo para 18 pontos.
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()
A grade se repete em intervalos fixos. Drawing guides marcam posições horizontais ou verticais individuais. Ambos são auxílios de edição e aparecem apenas em editores que os exibem. Apresentações de slides e exportações para PDF, imagens ou SVG os omitêm.
Mostrar ou Ocultar Comentários ao Abrir uma Apresentação
setShowComments armazena uma preferência que editores compatíveis usam ao abrir a apresentação. Para uma apresentação existente com comentários, este exemplo imprime a configuração atual e salva uma cópia com os comentários ocultos. Também chama setLastView com ViewType.SlideView para que a cópia seja aberta na visualização de slide.
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()
Ocultar comentários preserva o texto, autores, posições, respostas e status deles. Para alterar os próprios comentários, veja Presentation Comments. As configurações de exportação controlam se os comentários aparecem em PDF, HTML, imagens, notas ou folhetos.
FAQ
Por que a grade fica oculta quando reabro a apresentação?
A apresentação armazena o intervalo da grade. Para ver a grade, habilite a visibilidade da grade no editor.
Limpar guias de desenho altera o espaçamento da grade?
Não. Adicionar, mover ou limpar uma guia não altera o intervalo da grade.
Seções diferentes de uma apresentação podem ter configurações de visualização diferentes?
Não. Presentation.getViewProperties se aplica a toda a apresentação.
Posso salvar configurações de visualização diferentes para usuários diferentes?
O arquivo armazena um conjunto de propriedades de visualização para todos. Um editor também pode aplicar as preferências locais de um usuário.
Posso salvar configurações de visualização em um modelo?
Sim. Apresentações criadas a partir do modelo herdam suas configurações de visualização salvas.