检索和更新 JavaScript 中的演示文稿视图属性

本页内容简介

了解 Aspose.Slides for Node.js via Java 的视图属性，以自定义 PPT、PPTX 和 ODP 幻灯片格式——调整布局、缩放级别和显示设置。

介绍

普通视图由三个内容区域组成：幻灯片本身、侧边内容区域和底部内容区域。属性涉及不同内容区域的位置。此信息使应用程序能够将视图状态保存到文件中，从而在重新打开时，视图保持与上次保存演示文稿时相同的状态。

已添加方法 ViewProperties.getNormalViewProperties，用于访问演示文稿的普通视图属性。

已添加NormalViewProperties、NormalViewRestoredProperties 类及其派生类，以及SplitterBarStateType 枚举。

关于 NormalViewProperties

表示普通视图属性。

方法getShowOutlineIcons 和 setShowOutlineIcons 指定当在普通视图模式的任意内容区域显示大纲内容时，应用程序是否应显示图标。

方法getSnapVerticalSplitter 和 setSnapVerticalSplitter 指定当侧边区域足够小时，垂直分割栏是否应捕捉到最小化状态。

属性getPreferSingleView 和 setPreferSingleView 指定用户是否更喜欢在全窗口单内容区域而非标准的包含三个内容区域的普通视图中查看。如果启用，应用程序可能会选择在整个窗口显示其中一个内容区域。

方法getVerticalBarState 和 getHorizontalBarState 指定水平或垂直分割栏应显示的状态。水平分割栏将幻灯片与幻灯片下方的内容区域分隔，垂直分割栏将幻灯片与侧边内容区域分隔。可能的取值有：SplitterBarStateType.Minimized、SplitterBarStateType.Maximized 和 SplitterBarStateType.Restored。

方法getRestoredLeft 和 getRestoredTop 指定普通视图中顶部或侧边幻灯片区域的大小，当对getVerticalBarState 和 getHorizontalBarState 应用 SplitterBarStateType.Restored 值时。

关于恢复 NormalViewProperties

在普通视图中指定幻灯片区域的大小（当作为getRestoredTop 的子项时为宽度，作为getRestoredLeft 的子项时为高度），当区域处于可变的恢复大小（既未最小化也未最大化）时。

方法getDimensionSize 指定幻灯片区域的大小（当作为 restoredTop 的子项时为宽度，作为 restoredLeft 的子项时为高度）。

方法getAutoAdjust 指定在调整包含视图的窗口大小时，侧边内容区域的大小是否应自动补偿新的尺寸。

下面的示例展示了如何访问演示文稿的 ViewProperties.getNormalViewProperties 属性。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

var pres = new aspose.slides.Presentation();
try {
    pres.getViewProperties().getNormalViewProperties().setHorizontalBarState(aspose.slides.SplitterBarStateType.Restored);
    pres.getViewProperties().getNormalViewProperties().setVerticalBarState(aspose.slides.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", aspose.slides.SaveFormat.Pptx);
} finally {
    pres.dispose();
}

设置默认缩放值

Aspose.Slides for Node.js via Java 现已支持为演示文稿设置默认缩放值，使得打开演示文稿时已设置好缩放。可以通过设置演示文稿的 [ViewProperties] 实现。

getSlideViewProperties 和 getNotesViewProperties 都可以通过编程方式设置。在本主题中，我们将通过示例演示如何在 Aspose.Slides 中设置 [Presentation] 的 [View Properties]。

要设置视图属性，请按以下步骤操作：

创建一个 Presentation 类的实例。
设置 Presentation 的 View Properties。
将演示文稿写入为 PPTX 文件。
在下面的示例中，我们已经为幻灯片视图和备注视图设置了缩放值。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

var presentation = new aspose.slides.Presentation();
try {
    // 设置演示文稿的视图属性
    presentation.getViewProperties().getSlideViewProperties().setScale(100); // 幻灯片视图的缩放值（百分比）
    presentation.getViewProperties().getNotesViewProperties().setScale(100); // 备注视图的缩放值（百分比）
    presentation.save("Zoom_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

设置网格间距

使用 Presentation.getViewProperties 访问演示文稿级别的视图设置。ViewProperties.getGridSpacing 和 ViewProperties.setGridSpacing 方法读取或更改底层编辑网格的间隔。此设置适用于整个演示文稿，而不是单个幻灯片。网格间距以点为单位，72 点等于一英寸。请使用正值，符合 API 文档的要求。

下面的示例打开现有的 demo.pptx，打印其当前网格间距，设置四分之一英寸的间隔，并保存结果。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

var presentation = new aspose.slides.Presentation("demo.pptx");
try {
    var gridSpacing = presentation.getViewProperties().getGridSpacing();
    console.log("Current grid spacing: " + gridSpacing + " points");

    presentation.getViewProperties().setGridSpacing(18);
    presentation.save("grid-spacing.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

网格不同于 drawing guides。网格间距控制一个规则的间隔，而绘图参考线是单独定位的水平或垂直对齐线。添加、移动或清除绘图参考线不会改变网格间距。

网格和绘图参考线都是编辑辅助工具。它们不会在 PDF、图像、SVG 或幻灯片放映中作为幻灯片内容呈现。存储网格间距并不保证编辑器会显示网格：其可见性还取决于查看器或编辑器的偏好设置。

常见问题

为什么重新打开演示文稿后网格不可见？
文件会存储网格间距，但由编辑器决定是否显示网格。请检查编辑器的网格可见性设置。

清除绘图参考线会改变网格间距吗？
不会。绘图参考线和网格间距是独立的设置。清除参考线不会改变已存储的网格间隔。

我可以为演示文稿的不同章节设置不同的视图设置吗？
[View settings] 在演示文稿级别定义（普通视图/幻灯片视图），而非按章节划分，因此在打开文档时，整个文档使用同一套参数。

我可以为不同用户预定义不同的视图状态吗？
不能。设置存储在文件中并共享。查看应用程序可以遵循用户偏好，但文件本身仅包含一套视图属性。

我可以准备一个预定义 View Properties 的模板，使新演示文稿以相同方式打开吗？
可以。由于 [view properties] 存储在演示文稿级别，您可以将其嵌入模板中，并基于该模板创建新文档，从而拥有相同的初始视图配置。

管理 JavaScript 中的演示文稿属性在 Node.js 中管理演示文稿注释