Recuperar e Atualizar Propriedades de Visualização da Apresentação no Android
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 referentes ao posicionamento das diferentes regiões de conteúdo. Essas informações permitem que o aplicativo salve seu estado de visualização no arquivo, de modo que, ao ser reaberto, a visualização esteja no mesmo estado em que a apresentação foi salva pela última vez.
O método IViewProperties.getNormalViewProperties foi adicionado para fornecer acesso às propriedades da visualização normal da apresentação.
As interfaces INormalViewProperties, INormalViewRestoredProperties e seus descendentes, bem como o enum SplitterBarStateType foram adicionados.
Sobre INormalViewProperties
Representa as propriedades da visualização normal.
Os métodos getShowOutlineIcons e setShowOutlineIcons especificam se o aplicativo deve exibir ícones ao mostrar o conteúdo do contorno em qualquer uma 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 um estado minimizado quando a região lateral está suficientemente pequena.
A propriedade getPreferSingleView e setPreferSingleView especificam se o usuário prefere ver uma região de conteúdo única em tela cheia em vez da visualização normal padrão com três regiões de conteúdo. Se habilitado, o aplicativo pode optar por 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 divisor horizontal ou vertical deve ser exibida. Uma barra divisor horizontal separa o slide da região de conteúdo abaixo do slide, e a barra divisor 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 da visualização normal, quando o valor SplitterBarStateType.Restored for aplicado a getVerticalBarState e getHorizontalBarState respectivamente.
Sobre Restaurar INormalViewProperties
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 restoredTop, altura quando filho de restoredLeft).
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.
Um exemplo abaixo mostra como acessar as propriedades ViewProperties.getNormalViewProperties de uma apresentação.
Presentation pres = new Presentation();
try {
pres.getViewProperties().getNormalViewProperties().setHorizontalBarState(SplitterBarStateType.Restored);
pres.getViewProperties().getNormalViewProperties().setVerticalBarState(SplitterBarStateType.Maximized);
// Restaurar as propriedades de visualização da apresentação
pres.getViewProperties().getNormalViewProperties().getRestoredTop().setAutoAdjust(true);
pres.getViewProperties().getNormalViewProperties().getRestoredTop().setDimensionSize(80);
pres.getViewProperties().getNormalViewProperties().setShowOutlineIcons(true);
pres.save("presentation_normal_view_state.pptx", SaveFormat.Pptx);
} finally {
pres.dispose();
}
Definir o Valor de Zoom Padrão
Para definir as propriedades de visualização, siga os passos abaixo:
- Crie uma instância da classe Presentation.
- Defina as View Properties de Presentation.
- Salve a apresentação como um arquivo PPTX. No exemplo abaixo, definimos o valor de zoom para a visualização de slides e também para a visualização de notas.
Presentation presentation = new Presentation();
try {
// Definindo as propriedades de visualização da apresentação
presentation.getViewProperties().getSlideViewProperties().setScale(100); // Valor de zoom em porcentagem para a visualização de slide
presentation.getViewProperties().getNotesViewProperties().setScale(100); // Valor de zoom em porcentagem para a visualização de notas
presentation.save("Zoom_out.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Perguntas Frequentes
Posso definir configurações de visualização diferentes para diferentes seções de uma apresentação?
As configurações de visualização são definidas no nível da apresentação (Normal View/Slide View), 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 as preferências do usuário, mas o arquivo em si contém um único conjunto de propriedades de visualização.
Posso preparar um modelo com View Properties 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 inicial de visualização.