Получить и обновить свойства представления презентации на Android

Обычный режим просмотра состоит из трех областей содержимого: самого слайда, боковой области содержимого и нижней области содержимого. Свойства, относящиеся к позиционированию различных областей содержимого. Эта информация позволяет приложению сохранять состояние просмотра в файл, чтобы при повторном открытии просмотр находился в том же состоянии, что и при последнем сохранении презентации.

Метод IViewProperties.getNormalViewProperties был добавлен для предоставления доступа к свойствам обычного режима просмотра презентации.

Интерфейсы INormalViewProperties, INormalViewRestoredProperties и их наследники, а также перечисление SplitterBarStateType были добавлены.

Об INormalViewProperties

Представляет свойства обычного режима просмотра.

Методы getShowOutlineIcons и setShowOutlineIcons указывают, должен ли приложение отображать значки при выводе содержания конспекта в любой из областей содержимого обычного режима просмотра.

Методы getSnapVerticalSplitter и setSnapVerticalSplitter указывают, должен ли вертикальный разделитель переходить в свернутое состояние, когда боковая область достаточно мала.

Свойства getPreferSingleView и setPreferSingleView указывают, предпочитает ли пользователь видеть одноблочную область во весь экран вместо стандартного обычного режима просмотра с тремя областями содержимого. При включении приложение может выбрать отображение одной из областей содержимого на весь экран.

Методы getVerticalBarState и getHorizontalBarState определяют состояние, в котором должна отображаться горизонтальная или вертикальная полоска разделителя. Горизонтальная полоска разделителя отделяет слайд от области содержимого под слайдом, вертикальная — от боковой области. Возможные значения: SplitterBarStateType.Minimized, SplitterBarStateType.Maximized и SplitterBarStateType.Restored.

Методы getRestoredLeft и getRestoredTop определяют размеры верхней или боковой области слайда в обычном режиме просмотра, когда значение SplitterBarStateType.Restored применено к getVerticalBarState и getHorizontalBarState соответственно.

О восстановлении INormalViewProperties

Определяет размеры области слайда (ширина, когда это дочерний элемент getRestoredTop, высота, когда это дочерний элемент getRestoredLeft) обычного режима просмотра, когда область имеет переменный восстановленный размер (не свернута и не развернута).

Метод getDimensionSize определяет размер области слайда (ширина, когда дочерний элемент restoredTop, высота, когда дочерний элемент restoredLeft).

Метод getAutoAdjust определяет, должна ли размер боковой области содержимого компенсировать новый размер при изменении размеров окна, содержащего просмотр в приложении.

Приведенный ниже пример показывает, как получить доступ к свойствам ViewProperties.getNormalViewProperties для презентации.

Presentation pres = new Presentation();
try {
    pres.getViewProperties().getNormalViewProperties().setHorizontalBarState(SplitterBarStateType.Restored);
    pres.getViewProperties().getNormalViewProperties().setVerticalBarState(SplitterBarStateType.Maximized);
    
    // Восстановить свойства просмотра презентации
    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();
}

Установить значение масштабирования по умолчанию

Aspose.Slides для Android через Java теперь поддерживает установку значения масштабирования по умолчанию для презентации, так что при открытии презентации масштаб уже установлен. Это можно сделать, задав ViewProperties презентации. getSlideViewProperties и getNotesViewProperties могут быть заданы программно. В этой статье мы покажем на примере, как установить View Properties для Presentation в Aspose.Slides.

Чтобы установить свойства просмотра, выполните следующие шаги:

1. Создайте экземпляр класса Presentation.
2. Задайте View Properties для Presentation.
3. Сохраните презентацию в файл PPTX.
   В приведённом ниже примере мы задали значение масштабирования для просмотра слайда, а также для просмотра заметок.

Presentation presentation = new Presentation();
try {
    // Установка свойств просмотра презентации
    presentation.getViewProperties().getSlideViewProperties().setScale(100); // Значение масштабирования в процентах для просмотра слайда
    presentation.getViewProperties().getNotesViewProperties().setScale(100); // Значение масштабирования в процентах для просмотра заметок 

    presentation.save("Zoom_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

Можно ли задать разные параметры просмотра для разных секций презентации?

Параметры просмотра (Normal View/Slide View) определяются на уровне презентации, а не для каждой секции, поэтому один набор параметров применяется ко всему документу при его открытии.

Можно ли заранее определить разные состояния просмотра для разных пользователей?

Нет. Настройки хранятся в файле и являются общими. Приложения‑просмотрщики могут учитывать предпочтения пользователя, но сам файл содержит один набор свойств просмотра.

Можно ли подготовить шаблон с предустановленными свойствами просмотра, чтобы новые презентации открывались одинаково?

Да. Поскольку свойства просмотра хранятся на уровне презентации, их можно включить в шаблон и создавать из него новые документы с той же начальной конфигурацией просмотра.