在 Java 中检索和更新演示文稿视图属性
简介
在 PowerPoint 的普通视图中,幻灯片显示在侧边窗格(用于缩略图或大纲)和下方的备注窗格之间。Aspose.Slides for Java 通过 Presentation.getViewProperties 暴露演示文稿保存的编辑首选项。这些包括窗格布局、缩放级别、网格间距和批注可见性。
关于 INormalViewProperties
使用 getNormalViewProperties 访问 INormalViewProperties 接口。setShowOutlineIcons 控制是否在大纲中的幻灯片标题旁显示图标。setSnapVerticalSplitter 使侧边窗格在用户收窄时自动贴合到最小化状态。setPreferSingleView 表示在全窗口中显示单个窗格的首选项。
setVerticalBarState 控制侧边窗格与幻灯片之间的分隔条。setHorizontalBarState 控制备注窗格上方的分隔条。两者均接受 SplitterBarStateType 的值 Minimized、Maximized 或 Restored。
关于恢复 INormalViewProperties
当分隔条被恢复时,getRestoredLeft 提供侧边窗格的已保存大小,且 getRestoredTop 提供上部幻灯片区域的已保存大小。两者均公开 INormalViewRestoredProperties。其 setDimensionSize 方法接受 0 到 100 的百分比,而 setAutoAdjust 控制编辑器在窗口大小改变时是否自动调整大小。
以下示例更新现有演示文稿。它恢复水平分隔条,将 getRestoredTop 返回的大小设置为 80% 并启用自动调整,同时将垂直分隔条最大化。它还调用 setShowOutlineIcons 在大纲视图中显示图标。
import com.aspose.slides.*;
Presentation presentation = new Presentation("demo.pptx");
try {
INormalViewProperties 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();
}
设置默认缩放值
getSlideViewProperties 和 getNotesViewProperties 为编辑器存储独立的缩放设置。这些设置不会影响幻灯片尺寸、幻灯片放映播放或图像导出分辨率。
以下示例打开现有演示文稿并调用 setVariableScale 使幻灯片适应编辑窗口。对于备注页,它禁用自动缩放并调用 setScale 将缩放固定为 80%。
import com.aspose.slides.*;
Presentation presentation = new Presentation("demo.pptx");
try {
IViewProperties viewProperties = presentation.getViewProperties();
viewProperties.getSlideViewProperties().setVariableScale(true);
viewProperties.getNotesViewProperties().setVariableScale(false);
viewProperties.getNotesViewProperties().setScale(80);
presentation.save("zoom.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
设置网格间距
setGridSpacing 设置整个演示文稿中编辑网格线之间的距离。它接受以点为单位的正数值,1 英寸等于 72 点。以下示例在现有演示文稿中打印当前间距,并通过将间隔设为 18 点来保存四分之一英寸的网格。
import com.aspose.slides.*;
Presentation presentation = new Presentation("demo.pptx");
try {
IViewProperties viewProperties = presentation.getViewProperties();
System.out.println("Current grid spacing: " + viewProperties.getGridSpacing() + " points");
viewProperties.setGridSpacing(18f);
presentation.save("grid-spacing.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
网格以固定间隔重复。Drawing guides 标记单独的水平或垂直位置。两者都是编辑辅助,仅在显示它们的编辑器中出现。幻灯片放映以及导出为 PDF、图像或 SVG 时会省略它们。
打开演示文稿时显示或隐藏批注
setShowComments 保存兼容编辑器在打开演示文稿时使用的首选项。对于带有批注的现有演示文稿,以下示例打印当前设置并保存一个隐藏批注的副本。它还使用 ViewType.SlideView 调用 setLastView,使副本在幻灯片视图中打开。
import com.aspose.slides.*;
Presentation presentation = new Presentation("comments.pptx");
try {
IViewProperties viewProperties = presentation.getViewProperties();
System.out.println("Current comment visibility: " + viewProperties.getShowComments());
viewProperties.setShowComments(NullableBool.False);
viewProperties.setLastView(ViewType.SlideView);
presentation.save("comments-hidden.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
隐藏批注会保留其文本、作者、位置、回复和状态。要更改批注本身,请参阅 Presentation Comments。导出设置决定批注是否出现在 PDF、HTML、图像、备注或讲义中。
常见问题
为什么我重新打开演示文稿时网格会消失?
演示文稿保存了网格间隔。要查看网格,请在编辑器中启用网格可见性。
清除绘图指南会改变网格间距吗?
不会。添加、移动或清除指南都不会改变网格间隔。
演示文稿的不同章节可以有不同的视图设置吗?
不能。Presentation.getViewProperties 适用于整个演示文稿。
我可以为不同用户保存不同的视图设置吗?
文件仅为所有人存储一套视图属性。编辑器可能会额外应用用户的本地首选项。
我可以在模板中保存视图设置吗?
可以。基于该模板创建的演示文稿会继承其保存的视图设置。