Recuperar e Atualizar Propriedades de Visualização da Apresentação em PHP
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 PHP via Java expõe as preferências de edição salvas da apresentação através de Presentation::getViewProperties. Esses 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 seu estado minimizado quando o usuário o reduz. setPreferSingleView indica preferência por exibir um único painel na janela inteira.
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 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 expõem 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.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\SplitterBarStateType;
$presentation = new Presentation("demo.pptx");
try {
$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 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, ele desativa o dimensionamento automático e chama setScale para definir um zoom fixo de 80%.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("demo.pptx");
try {
$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
O método setGridSpacing de ViewProperties define a distância entre as linhas de grade de edição em toda a apresentação. Ele 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.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("demo.pptx");
try {
$viewProperties = $presentation->getViewProperties();
echo "Current grid spacing: " . java_values($viewProperties->getGridSpacing()) . " points" . PHP_EOL;
$viewProperties->setGridSpacing(18.0);
$presentation->save("grid-spacing.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
A grade se repete em um intervalo fixo. Guias de desenho marcam posições horizontais ou verticais individuais. Ambos são auxiliares de edição e aparecem apenas em editores que os exibem. Apresentações e exportações para PDF, imagens ou SVG os omitem.
Mostrar ou Ocultar Comentários ao Abrir uma Apresentação
setShowComments armazena uma preferência que os 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.
use aspose\slides\NullableBool;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ViewType;
$presentation = new Presentation("comments.pptx");
try {
$viewProperties = $presentation->getViewProperties();
echo "Current comment visibility: " . java_values($viewProperties->getShowComments()) . PHP_EOL;
$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 Comentários da Apresentação. 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.
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 único 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 as configurações de visualização salvas.