Получить и обновить свойства просмотра презентации в JavaScript
Введение
В обычном представлении PowerPoint слайд отображается между боковой панелью с миниатюрами или схемой и панелью заметок снизу. Aspose.Slides для Node.js через Java предоставляет сохранённые параметры редактирования презентации через Presentation.getViewProperties. Они включают расположение панелей, уровни масштабирования, интервалы сетки и видимость комментариев.
О NormalViewProperties
Используйте getNormalViewProperties для доступа к классу NormalViewProperties. setShowOutlineIcons управляет тем, отображаются ли значки рядом с названиями слайдов в схеме. setSnapVerticalSplitter позволяет боковой панели автоматически переходить в свернутое состояние, когда пользователь уменьшает её ширину. setPreferSingleView указывает предпочтение отображения одной панели в полном окне.
setVerticalBarState управляет разделителем между боковой панелью и слайдом. setHorizontalBarState управляет разделителем над панелью заметок. Оба принимают значение SplitterBarStateType — Minimized, Maximized или Restored.
О восстановлении NormalViewProperties
Когда разделитель восстанавливается, getRestoredLeft возвращает сохранённый размер боковой панели, а getRestoredTop — сохранённый размер верхней области слайда. Оба предоставляют доступ к NormalViewRestoredProperties. Его метод setDimensionSize принимает процент от 0 до 100, а setAutoAdjust управляет тем, автоматически ли редактор изменяет размер при изменении размеров окна.
В этом примере обновляется существующая презентация. Он восстанавливает горизонтальный разделитель, устанавливает размер, возвращаемый getRestoredTop, в 80 % с включённым автоматическим регулированием, и разворачивает вертикальный разделитель. Также вызывается setShowOutlineIcons, чтобы отображать значки в представлении схемы.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("input.pptx");
try {
const normalView = presentation.getViewProperties().getNormalViewProperties();
normalView.setHorizontalBarState(slides.SplitterBarStateType.Restored);
normalView.setVerticalBarState(slides.SplitterBarStateType.Maximized);
normalView.getRestoredTop().setAutoAdjust(true);
normalView.getRestoredTop().setDimensionSize(80);
normalView.setShowOutlineIcons(true);
presentation.save("presentation_normal_view_state.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Установить значение масштаба по умолчанию
getSlideViewProperties и getNotesViewProperties хранят независимые настройки масштабирования для редактора. Эти настройки не влияют на размеры слайдов, воспроизведение презентации или разрешение при экспорте изображений.
В этом примере открывается существующая презентация и вызывается setVariableScale, чтобы подогнать слайд под окно редактирования. Для страницы заметок отключается автоматическое масштабирование и вызывается setScale, чтобы установить фиксированный масштаб 80 %.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("input.pptx");
try {
const viewProperties = presentation.getViewProperties();
viewProperties.getSlideViewProperties().setVariableScale(true);
viewProperties.getNotesViewProperties().setVariableScale(false);
viewProperties.getNotesViewProperties().setScale(80);
presentation.save("zoom.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Установить интервал сетки
setGridSpacing задает расстояние между линиями редактирующей сетки во всей презентации. Принимает положительное значение в пунктах, при этом в дюйме 72 пункта. В этом примере выводится текущий интервал в существующей презентации и сохраняется сетка с шагом в четверть дюйма, задав интервал 18 пунктов.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("input.pptx");
try {
const viewProperties = presentation.getViewProperties();
console.log("Current grid spacing: " + viewProperties.getGridSpacing() + " points");
viewProperties.setGridSpacing(18);
presentation.save("grid-spacing.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Сетка повторяется с фиксированным интервалом. Руководства по рисованию отмечают отдельные горизонтальные или вертикальные позиции. Оба служат подсказками при редактировании и отображаются только в редакторах, которые их поддерживают. Слайд-шоу и экспорты в PDF, изображения или SVG их не включают.
Показать или скрыть комментарии при открытии презентации
setShowComments сохраняет предпочтение, которое совместимые редакторы используют при открытии презентации. Для существующей презентации с комментариями этот пример выводит текущее значение и сохраняет копию с скрытыми комментариями. Также вызывается setLastView с ViewType.SlideView, чтобы копия открывалась в представлении слайда.
const java = require("java");
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("input.pptx");
try {
const viewProperties = presentation.getViewProperties();
console.log("Current comment visibility: " + viewProperties.getShowComments());
const hideComments = java.newByte(slides.NullableBool.False);
viewProperties.setShowComments(hideComments);
viewProperties.setLastView(slides.ViewType.SlideView);
presentation.save("comments-hidden.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Скрытие комментариев сохраняет их текст, авторов, позиции, ответы и статусы. Чтобы изменить сами комментарии, смотрите Комментарии к презентации. Параметры экспорта определяют, будут ли комментарии отображаться в PDF, HTML, изображениях, заметках или раздаточных материалах.
FAQ
Почему сетка скрыта при повторном открытии презентации?
Презентация сохраняет интервал сетки. Чтобы увидеть сетку, включите её отображение в редакторе.
Удаление руководств по рисованию меняет интервал сетки?
Нет. Добавление, перемещение или удаление руководства не изменяют интервал сетки.
Могут ли разные разделы презентации иметь разные настройки представления?
Нет. Presentation.getViewProperties применяется ко всей презентации.
Могу ли я сохранить разные настройки представления для разных пользователей?
Файл сохраняет один набор свойств представления для всех. Редактор может также применять локальные предпочтения пользователя.
Могу ли я сохранить настройки представления в шаблоне?
Да. Презентации, созданные из шаблона, наследуют сохранённые настройки представления.