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.