EditPresentation¶

编辑 PowerPoint (.pptx) 演示文稿：按顺序排列的一批操作以原子方式应用并另存为新版本，因此如果任何操作失败，则不会保存任何内容。若要改为从现有演示文稿创建新文稿（翻译、变体或待修改的副本），请传入 saveAs：编辑后的文稿会作为新演示文稿创建，并返回其 documentId 以供后续批次使用，而原始文稿保持不变；此时 operations 可以为空以进行纯复制。先调用 ReadPresentation；通过它报告的 id 来定位幻灯片和形状（幻灯片 id 不是幻灯片编号）。位置和大小以点为单位，从幻灯片左上角计算。文本偏移量按段落中的字符数计算；\n 分隔段落。颜色为 RRGGBB 十六进制值或主题名称（accent1-accent6、tx1、tx2、bg1、bg2）。使用 setText 重写形状的文本（它会保留每个段落的格式），formatText/formatParagraphs 用于设置样式（未指定范围时作用于整个形状），formatBody 用于设置文本框的边距、自动调整、列数和文字方向（垂直或堆叠文本，也适用于表格单元格），addSlide 使用版式名称创建新幻灯片（标题和正文填充其占位符），addShape 用于文本框、预设形状、线条、表格、图表或图片，setChartData/setChartType/formatChart 用于读取操作标记为可编辑的图表，mergeCells/formatCells/setTableStyle/setTableGrid 用于表格（单元格文本通过带有 cell 的文本操作处理），cropPicture/formatPicture 用于图片（裁剪、填充或适应边框、亮度、对比度、重新着色、透明度），groupShapes/ungroupShape、setSlideLayout、setTransition、setAnimations/addAnimation/removeAnimations 用于幻灯片的点击式动画（按名称使用进入、强调、退出和动作路径效果，按播放顺序；setAnimations 会替换整个列表并保留列出的现有动画），setShapeEffects 用于阴影、发光、柔化边缘和反射（按图库预设名称或选项；formatText 也支持文本阴影和发光），setCustomGeometry 用于将形状轮廓重新绘制为形状本地坐标中的路径（moveTo/lineTo/cubicBezTo/quadBezTo/arcTo/close；外框跟随路径，同时保留其格式和文本），mergeShapes 用于对重叠形状进行联合/组合/拆分/相交/相减（按选择顺序；第一个形状的格式和 id 优先），SmartArt 可通过 addShape {kind: smartArt, layout, items: [{text, level}], colors, style} 创建，editSmartArt（setText、addNode、deleteNode、promote、demote、moveUp、moveDown、setNodes、setLayout、setColors、setStyle、reset，按读取操作列出的节点 id 操作）以及 convertSmartArt（转换为形状或文本）。方程使用 insertEquation（LaTeX 风格的线性文本，例如 \frac{a}{b}、x^2、\sqrt{x}、\sum_{i=1}^{n}；若不提供形状，则会新建一个居中文本框）和 setEquation（方程在其段落中作为一个 U+FFFC 字符，位于读取操作列出的索引处；可通过针对该字符的 deleteText 将其删除）。审阅评论使用 addComment/replyComment/editComment/resolveComment/deleteComment/deleteAllComments（线程 id 来自读取操作；旧版线程只能编辑或删除；使用用户名进行签名）。幻灯片母版和版式：将母版或版式 id（读取操作会列出它们，至少 2147483648）作为 slide 传递给形状、文本、表格、图片或背景操作，以便更改应用于使用该母版或版式的每张幻灯片；另有 addLayout/renameLayout/deleteLayout/insertPlaceholder/setLayoutOptions 和 setBackgroundStyle (1-12)。setThemeColors/setThemeFonts 通过主题重新设置整个文稿的样式（优先使用它们，而不是逐个重新着色形状）。setHeaderFooter 用于设置幻灯片编号、日期和页脚（省略 slides 以应用于所有幻灯片）。setSlideSize 用于更改幻灯片大小（scale fit 会将内容缩小到新大小）。addSection/renameSection/removeSection/moveSection 用于将幻灯片组织为节（按读取操作报告的节 id）。setGuides 用于替换文稿的绘图参考线，replaceText 用于在整个文稿中查找和替换。所创建幻灯片和形状的 id 会随更改后的幻灯片一并返回（即它们现在的读取结果）；请检查这些 id。最多 100 个操作。

参数¶