在 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 适用于整个演示文稿。

我可以为不同用户保存不同的视图设置吗?

文件仅为所有人存储一套视图属性。编辑器可能会额外应用用户的本地首选项。

我可以在模板中保存视图设置吗?

可以。基于该模板创建的演示文稿会继承其保存的视图设置。