所选内容是指当前在打开的演示文稿页面中所选的任何内容,例如一段突出显示的文本或一个表格。本指南介绍了如何使用 Apps Script 获取和设置有效演示文稿中的选择。
所选内容是脚本启动时的快照。如果用户在脚本运行期间点击并更改了选择,这些更改不会反映出来。
选择和选择类型
您可以使用 Selection 类读取选择。该类具有多种方法,用于根据所选对象的类型获取所选对象。
SelectionType 枚举表示所选对象的具体类型。例如,如果用户选择了形状中的一些文本,则选择类型将为 TEXT。在这种情况下,您可以使用 selection.getTextRange()
方法检索所选文本范围。
您还可以检索包含所选内容的对象;继续使用上面的示例,您可以使用 selection.getPageElementRange().getPageElements()[0]
检索包含所选文本的形状。同样,包含封闭形状的页面是当前活动页面;如需检索该页面,请使用 selection.getCurrentPage()
。
读出所选内容
如需读取所选内容,请使用 Presentation.getSelection() 方法,如以下示例所示:
阅读当前网页
如需检索用户正在查看的当前页面,请使用 getSelection() 和 getCurrentPage() 方法,如下所示:
请注意,当前网页可以是以下任意一种:
当前页面可以选择一个或多个对象,SelectionType 用于确定选择的类型。
根据选择类型读取选择
以下示例展示了如何使用选择类型以适当的方式读取当前选择。
朗读所选文字
您可以使用 Selection.getTextRange() 方法读取所选文字。文本选择有两种类型:
- 范围选择:如果形状包含文本“Hello”,然后选择了“He”,则返回的范围为 startIndex=0 和 endIndex=2。
- 光标选择:如果形状包含文本“Hello”,且光标位于“H”("H|ello") 之后,则返回的范围是空的范围,并且 startIndex=1 和 endIndex=1。
修改所选内容
脚本可以修改用户的选择。在脚本执行期间,脚本对演示文稿所做的任何选择更改都会反映在后续的选择操作中。
只有在脚本执行完成或调用 Presentation.saveAndClose()
后,选择更改才会反映在用户的浏览器中。
选择当前网页
您可以通过调用 selectAsCurrentPage() 方法,将有效演示中的页面选为当前页面。此方法会移除之前的所有页面元素、页面或文本选择。因此,在当前页面上使用此方法可取消选择该页面上的所有当前选择。例如:
选择网页元素
如需选择网页中的网页元素,请使用 PageElement.select() 方法。 这也会取消选择之前选择的所有网页元素。
例如:
选择多个网页元素
如需将其他网页元素附加到所选内容,请使用 PageElement.select(false) 方法。所有页面元素都必须位于当前页面中。
转换所选内容
您的脚本执行的修改可以转换当前选择,使所选内容会随着修改而发生变化。例如:
- 假设您选择了两个形状 A 和 B。
- 接下来,您的脚本会移除形状 A。
- 因此,选择会相对于所做修改进行转换,以便仅选择形状 B。
以下示例展示了如何通过操控所选页面元素来转换选择。
选择文字
可以使用 TextRange.select() 方法选择形状或表格单元格中包含的文本。如果文本包含在形状中,则该形状也会被选中。 如果文本包含在表格单元格中,则系统会同时选择该表格单元格及其封闭表格。
这还会将父页面设置为当前页面。
形状中的范围选择
以下示例展示了如何在形状中包含的文本中进行范围选择。
形状中的光标选择
以下示例展示了如何在形状中包含的文本中进行光标选择。
表格单元格中的范围选择
以下示例展示了如何在表格单元格中包含的文本中进行范围选择。
TableCell 中的光标选择
以下示例展示了如何在表格单元格中包含的文本中进行光标选择。
包含文本修改的选择转换
以下示例展示了如何通过修改所选文本来转换所选内容。
取消选择
没有明确的方法来取消选择文本或页面元素。不过,您可以使用 Page.selectAsCurrentPage()
或 pageElement.select()
方法来实现此结果。
选择当前页面
以下示例展示了如何通过将某个页面设置为当前页面来取消选择某个页面上的任何当前选择。
选择页面元素
以下示例展示了如何通过选择一个页面元素来取消选择某个页面上的所有当前选定项,从而从选定项中移除所有其他项。