Recuperar e Atualizar Propriedades de Visualização da Apresentação em Java
Introdução
Na visualização normal do PowerPoint, o slide aparece entre um painel lateral para miniaturas ou um esboço e um painel de notas abaixo. Aspose.Slides for Java expõe as preferências de edição salvas da apresentação através de Presentation.getViewProperties. Estas incluem o layout dos painéis, níveis de zoom, espaçamento da grade e visibilidade de comentários.
Sobre INormalViewProperties
Use getNormalViewProperties para acessar a interface INormalViewProperties. setShowOutlineIcons controla se ícones aparecem ao lado dos títulos dos slides no esboço. setSnapVerticalSplitter permite que o painel lateral trave em seu estado minimizado quando o usuário o reduz. setPreferSingleView indica 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 SplitterBarStateType de Minimized, Maximized ou Restored.
Sobre Restaurar INormalViewProperties
Quando um divisor é restaurado, getRestoredLeft fornece o tamanho salvo do painel lateral e getRestoredTop fornece o tamanho salvo da área superior do slide. Ambos expõem INormalViewRestoredProperties. 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 esboço.
import com.aspose.slides.*;
Presentation presentation = new Presentation("demo.pptx");
try {
INormalViewProperties normalView = presentation.getViewProperties().getNormalViewProperties();
normalView.setHorizontalBarState(SplitterBarStateType.Restored);
normalView.setVerticalBarState(SplitterBarStateType.Maximized);
normalView.getRestoredTop().setAutoAdjust(true);
normalView.getRestoredTop().setDimensionSize(80);
normalView.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 de 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, ele desabilita o dimensionamento automático e chama setScale para definir um zoom fixo de 80 %.
import com.aspose.slides.*;
Presentation presentation = new Presentation("demo.pptx");
try {
IViewProperties viewProperties = presentation.getViewProperties();
viewProperties.getSlideViewProperties().setVariableScale(true);
viewProperties.getNotesViewProperties().setVariableScale(false);
viewProperties.getNotesViewProperties().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. Aceita 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 definindo o intervalo para 18 pontos.
import com.aspose.slides.*;
Presentation presentation = new Presentation("demo.pptx");
try {
IViewProperties viewProperties = presentation.getViewProperties();
System.out.println("Current grid spacing: " + viewProperties.getGridSpacing() + " points");
viewProperties.setGridSpacing(18f);
presentation.save("grid-spacing.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
A grade se repete em intervalo fixo. 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 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 abra na visualização de slide.
import com.aspose.slides.*;
Presentation presentation = new Presentation("comments.pptx");
try {
IViewProperties viewProperties = presentation.getViewProperties();
System.out.println("Current comment visibility: " + viewProperties.getShowComments());
viewProperties.setShowComments(NullableBool.False);
viewProperties.setLastView(ViewType.SlideView);
presentation.save("comments-hidden.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Ocultar comentários preserva seu texto, autores, posições, respostas e status. 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 os guias de desenho altera o espaçamento da grade?
Não. Adicionar, mover ou limpar um guia deixa o intervalo da grade inalterado.
Diferentes seções de uma apresentação podem ter configurações de visualização diferentes?
Não. Presentation.getViewProperties aplica-se 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 pode também aplicar preferências locais do 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.