Recuperar e Atualizar Propriedades de Visualização da Apresentação em C++

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 C++ expõe as preferências de edição salvas da apresentação por meio de Presentation::get_ViewProperties. Elas incluem o layout dos painéis, níveis de zoom, espaçamento da grade e visibilidade de comentários.

Sobre INormalViewProperties

Use get_NormalViewProperties para acessar a interface INormalViewProperties. set_ShowOutlineIcons controla se ícones aparecem ao lado dos títulos dos slides no contorno. set_SnapVerticalSplitter permite que o painel lateral encaixe em seu estado minimizado quando o usuário o reduz. set_PreferSingleView indica uma preferência por exibir um único painel na janela completa.

set_VerticalBarState controla o divisor entre o painel lateral e o slide. set_HorizontalBarState 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, get_RestoredLeft fornece o tamanho salvo do painel lateral e get_RestoredTop fornece o tamanho salvo da área superior do slide. Ambos expõem INormalViewRestoredProperties. Seu método set_DimensionSize aceita uma porcentagem de 0 a 100, e set_AutoAdjust 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 da área superior do slide exposta por get_RestoredTop para 80% com ajuste automático habilitado, e maximiza o divisor vertical. Também habilita ícones de contorno com set_ShowOutlineIcons para a visualização de contorno.

#include <DOM/INormalViewProperties.h>
#include <DOM/INormalViewRestoredProperties.h>
#include <DOM/IViewProperties.h>
#include <DOM/Presentation.h>
#include <DOM/SplitterBarStateType.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto presentation = System::MakeObject<Presentation>(u"demo.pptx");

auto normalView = presentation->get_ViewProperties()->get_NormalViewProperties();
normalView->set_HorizontalBarState(SplitterBarStateType::Restored);
normalView->set_VerticalBarState(SplitterBarStateType::Maximized);
auto restoredTop = normalView->get_RestoredTop();
restoredTop->set_AutoAdjust(true);
restoredTop->set_DimensionSize(80.0f);
normalView->set_ShowOutlineIcons(true);

presentation->Save(u"presentation_normal_view_state.pptx", SaveFormat::Pptx);

Definir o Valor de Zoom Padrão

get_SlideViewProperties e get_NotesViewProperties armazenam configurações de zoom independentes para o editor. Essas configurações não afetam as dimensões dos slides, a reprodução de apresentação de slides ou a resolução de exportação de imagens.

Este exemplo abre uma apresentação existente e habilita o dimensionamento automático com set_VariableScale para ajustar o slide à janela de edição. Para a página de notas, desabilita o dimensionamento automático e usa set_Scale para definir um zoom fixo de 80%.

#include <DOM/ICommonSlideViewProperties.h>
#include <DOM/IViewProperties.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto presentation = System::MakeObject<Presentation>(u"demo.pptx");

auto viewProperties = presentation->get_ViewProperties();
viewProperties->get_SlideViewProperties()->set_VariableScale(true);
auto notesView = viewProperties->get_NotesViewProperties();
notesView->set_VariableScale(false);
notesView->set_Scale(80);

presentation->Save(u"zoom.pptx", SaveFormat::Pptx);

Definir o Espaçamento da Grade

set_GridSpacing 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 exibe o espaçamento atual em uma apresentação existente e salva uma grade de um quarto de polegada definindo o intervalo para 18 pontos.

#include <system/console.h>
#include <DOM/IViewProperties.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto presentation = System::MakeObject<Presentation>(u"demo.pptx");

auto viewProperties = presentation->get_ViewProperties();
auto gridSpacing = viewProperties->get_GridSpacing();
System::Console::WriteLine(u"Current grid spacing: {0} points", gridSpacing);

viewProperties->set_GridSpacing(18.0f);

presentation->Save(u"grid-spacing.pptx", SaveFormat::Pptx);

A grade se repete em intervalos fixos. Guias de desenho 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

set_ShowComments armazena uma preferência que editores compatíveis usam ao abrir a apresentação. Para uma apresentação existente com comentários, este exemplo exibe a configuração atual e salva uma cópia com os comentários ocultos. Também chama set_LastView com ViewType::SlideView para que a cópia abra na visualização de slide.

#include <system/console.h>
#include <DOM/IViewProperties.h>
#include <DOM/NullableBool.h>
#include <DOM/Presentation.h>
#include <ViewType.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

auto presentation = System::MakeObject<Presentation>(u"comments.pptx");

auto viewProperties = presentation->get_ViewProperties();
auto showComments = viewProperties->get_ShowComments();
System::Console::WriteLine(u"Current comment visibility: {0}", showComments);

viewProperties->set_ShowComments(NullableBool::False);
viewProperties->set_LastView(ViewType::SlideView);

presentation->Save(u"comments-hidden.pptx", SaveFormat::Pptx);

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.

Perguntas Frequentes

Por que a grade fica oculta quando eu 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::get_ViewProperties 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.