Recuperar e Atualizar Propriedades de Visualização da Apresentação em Python via Java
Introdução
A visualização normal consiste em três regiões de conteúdo: o próprio slide, uma região de conteúdo lateral e uma região de conteúdo inferior. As propriedades da visualização normal descrevem o posicionamento dessas regiões de conteúdo. Essa informação permite que o aplicativo salve seu estado de visualização no arquivo, de modo que, ao reabrir, a visualização esteja no mesmo estado em que a apresentação foi salva pela última vez.
O método ViewProperties.getNormalViewProperties foi adicionado para fornecer acesso às propriedades da visualização normal de uma apresentação.
As classes NormalViewProperties e NormalViewRestoredProperties e a enumeração SplitterBarStateType foram adicionadas.
Sobre NormalViewProperties
Representa as propriedades da visualização normal.
Os métodos getShowOutlineIcons e setShowOutlineIcons especificam se o aplicativo deve mostrar ícones ao exibir conteúdo de contorno em qualquer das regiões de conteúdo do modo de visualização normal.
Os métodos getSnapVerticalSplitter e setSnapVerticalSplitter especificam se o divisor vertical deve travar em estado minimizado quando a região lateral for suficientemente pequena.
Os métodos getPreferSingleView e setPreferSingleView especificam se o usuário prefere ver uma única região de conteúdo em tela cheia em vez da visualização normal padrão com três regiões de conteúdo. Se ativado, o aplicativo pode escolher exibir uma das regiões de conteúdo em toda a janela.
Os métodos getVerticalBarState e getHorizontalBarState especificam o estado em que a barra divisora horizontal ou vertical deve ser exibida. Uma barra divisora horizontal separa o slide da região de conteúdo abaixo do slide; uma barra divisora vertical separa o slide da região de conteúdo lateral. Os valores possíveis são: SplitterBarStateType.Minimized, SplitterBarStateType.Maximized e SplitterBarStateType.Restored.
Os métodos getRestoredLeft e getRestoredTop especificam o dimensionamento da região superior ou lateral do slide na visualização normal, quando o valor SplitterBarStateType.Restored é aplicado a getVerticalBarState e getHorizontalBarState, respectivamente.
Sobre Restaurar NormalViewProperties
Especifica o dimensionamento da região do slide (largura quando filho de getRestoredTop, altura quando filho de getRestoredLeft) da visualização normal, quando a região tem um tamanho restaurado variável (nem minimizado nem maximizado).
O método getDimensionSize especifica o tamanho da região do slide (largura quando filho de getRestoredTop, altura quando filho de getRestoredLeft).
O método getAutoAdjust especifica se o tamanho da região de conteúdo lateral deve compensar o novo tamanho ao redimensionar a janela que contém a visualização dentro do aplicativo.
O exemplo abaixo mostra como acessar ViewProperties.getNormalViewProperties para uma apresentação.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, SplitterBarStateType
presentation = Presentation()
try:
normal_view_properties = presentation.getViewProperties().getNormalViewProperties()
normal_view_properties.setHorizontalBarState(SplitterBarStateType.Restored)
normal_view_properties.setVerticalBarState(SplitterBarStateType.Maximized)
# Restaurar as propriedades de visualização da apresentação.
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 Padrão de Zoom
Note
O Aspose.Slides for Python via Java oferece suporte à definição do valor de zoom padrão, de modo que ele já seja aplicado quando a apresentação for aberta. Isso pode ser feito configurando o ViewProperties de uma apresentação. Os métodos getSlideViewProperties e getNotesViewProperties podem ser configurados programaticamente. Neste tópico, veremos com um exemplo como definir as Propriedades de Visualização da Presentation no Aspose.Slides.Para definir as propriedades de visualização, siga estas etapas:
- Crie uma instância da classe Presentation.
- Defina as Propriedades de Visualização da Presentation.
- Grave a apresentação como um arquivo PPTX.
No exemplo abaixo, definimos o valor de zoom tanto para a visualização de slide quanto para a visualização de notas.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation()
try:
# Definir as propriedades de visualização da apresentação.
presentation.getViewProperties().getSlideViewProperties().setScale(100) # Porcentagem de zoom para a visualização de slide.
presentation.getViewProperties().getNotesViewProperties().setScale(100) # Porcentagem de zoom para a visualização de notas.
presentation.save("Zoom_out.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
FAQ
Posso definir diferentes configurações de visualização para diferentes seções de uma apresentação?
As configurações de visualização são definidas no nível da apresentação (Visualização Normal/Visualização de Slide), não por seção, portanto um único conjunto de parâmetros se aplica a todo o documento quando ele é aberto.
Posso pré-definir diferentes estados de visualização para diferentes usuários?
Não. As configurações são armazenadas no arquivo e são compartilhadas. Aplicativos de visualização podem respeitar preferências do usuário, mas o próprio arquivo contém um único conjunto de propriedades de visualização.
Posso preparar um modelo com Propriedades de Visualização pré-definidas para que novas apresentações abram da mesma forma?
Sim. Como as propriedades de visualização são armazenadas no nível da apresentação, você pode incorporá‑las em um modelo e criar novos documentos a partir dele com a mesma configuração de visualização inicial.