# fsys.openXml.pptx.editor 库模块帮助文档 ## fsys.openXml.pptx.editor 成员列表 # 有限 PPTX 编辑；按真实页序与关系定位，不改源件、不重建全包。 ### fsys.openXml.pptx.editor.open() # [返回对象:openXmlPptxEditorObject](#openXmlPptxEditorObject) ### fsys.openXml.pptx.editor.open(path,options) # 返回编辑会话；Transitional/Strict 的文本/页序可处理；宏只保留不执行。输入含包数字签名时拒绝；读取限额同 open。失败 null,err。 ## openXmlPptxEditorObject 成员列表 # ### openXmlPptxEditorObject.changedParts() # 返回显式改动部件名称数组（包含已删除部件）。 ### openXmlPptxEditorObject.close() # 关闭包句柄，可以重复调用。 ### openXmlPptxEditorObject.copySlide(slideIndex,insertAt) # 同文稿复制一页；insertAt 为复制后的1-based位置，默认紧接原页。返回新页 index,id,partName,relationshipId。独立复制备注/图片/常见图表及工作簿；共享原版式/母版；自链接指向副本，其他跳页仍指原目标。未知依赖拒绝，失败不部分修改。不支持跨文稿/用户母版导入。 ### openXmlPptxEditorObject.deleteSlide(slideIndex,options) # 删除单页，等同 deleteSlides([slideIndex],options)。 ### openXmlPptxEditorObject.deleteSlides(indices,options) # 原子删除当前页号数组；默认拒绝其他页指向被删页的链接，options.links=remove 才移除相应点击/悬停链接。返回删除页数。删除页/备注/关系，安全处理自定义放映与节；不全包清理无引用媒体/图表。未知入站引用拒绝，不留下悬空关系。 ### openXmlPptxEditorObject.getTable(slideIndex,target) # target 为表格形状 id 或唯一名称；返回 id,name,rows,merges,rowCount,columnCount,columnWidths,rowHeights。rows 为物理网格文字，合并覆盖格保留位置；尺寸 point。 ### openXmlPptxEditorObject.listShapes(slideIndex) # 返回 id,name,kind,text,hasText,paragraphCount；分组递归、非视觉排序。段落数仅统计形状自身文字，不合并表格/子形状。 ### openXmlPptxEditorObject.listSlides() # 按实际页序返回 index,id,partName,relationshipId 数组。 ### openXmlPptxEditorObject.mainPart # 主文档部件名。 ### openXmlPptxEditorObject.mergeTableCells(slideIndex,target,range,options) # range={row,column,rowSpan,colSpan}；横向/纵向/矩形合并，不能重叠已有合并。默认拒绝覆盖非空格，options.content=append 时按行优先追加段落并保留格式；行高/列宽与表格尺寸不变。不自动缩字/拆分。 ### openXmlPptxEditorObject.path # 源文件路径。 ### openXmlPptxEditorObject.reorderSlides(order) # 全部页号排列，仅修改 sldIdLst，不删页或清理未知部件。 ### openXmlPptxEditorObject.replaceImage(slideIndex,target,dataOrPath) # target 为图片 id/唯一名称；替换其现有媒体部件，只接受同类型 PNG/JPEG。共享该媒体部件的其他图片也会改变，不静默克隆；成功返回 partName,sharedPart。 ### openXmlPptxEditorObject.replaceText(search,replacement,options) # 大小写敏感字面替换，跨同一段落相邻 a:r/a:t；替换文本继承首个命中运行格式。不跨段落/软换行/域，不改变图片/图表/母版文字。options.slides 为页号数组，includeNotes 默认 false。返回替换次数（0 合法），失败 null,err；不接受 CR/LF。 ### openXmlPptxEditorObject.save(outputPath,options) # 默认不覆盖的另存，禁止覆盖源件；未修改部件解压字节保持不变。成功返回完整路径，失败 null,err。 ### openXmlPptxEditorObject.setAnimations(slideIndex,effects,replaceExisting=false) # 设置整页已支持动画，支持 byParagraph/paragraph（0.9.0+）；已有时间轴默认拒绝；显式 true 才完整替换。 [] 可清空。仅 Transitional，不合并复杂/未知动画。 ### openXmlPptxEditorObject.setTableCell(slideIndex,target,row,column,value) # 填写一个逻辑格；行列从1开始，null为跳过，空串清空；返回写入数（0合法）。 ### openXmlPptxEditorObject.setTableCells(slideIndex,target,values,options) # 保持表格样式/尺寸填充矩形二维数据；options.row/column 默认1。null 跳过，空串清空，0/false保留。文字继承原格首段/首运行格式；替换域和运行链接，不保留旧数据链接；支持 CR/LF 与 VT 软换行。合并覆盖格仅允许空值。返回写入逻辑格数，失败 null,err。 ### openXmlPptxEditorObject.setTransition(slideIndex,options,replaceExisting=false) # 设置已支持切换，含 Morph 与 fade 回退（0.9.0+）；已有切换默认拒绝，显式 true 完整替换；null 清空。仅 Transitional。