# autos.skills.powerPoint 库模块帮助文档 ## autos.skills.powerPoint 成员列表 # PowerPoint/WPS 自动化；PPTX 读取与资源导出统一复用 fsys.openXml。不需要安装 Office 的入口：listPptxEntries,listPptxMedia,extractTextFromPptx,extractPptxMedia。 ### autos.skills.powerPoint.addBlankSlide(presentation,index) # 添加空白页；index 默认在末尾。 ### autos.skills.powerPoint.addTextBox(slide,text,left=60,top=60,width=600,height=80,options) # 添加文本框，坐标单位为 point；options 可设置字体、颜色与对齐。 ### autos.skills.powerPoint.addTitleSlide(presentation,title,subtitle,index) # 添加含标题与副标题的页面。 ### autos.skills.powerPoint.closePresentation(presentation,saveChanges=false) # 关闭文稿；可先保存。 ### autos.skills.powerPoint.createPresentation(startIfMissing=true,visible=true) # 通过 Office/WPS 创建演示文稿。 ### autos.skills.powerPoint.exportAsPdf(presentation,path,overwrite=true) # 通过 Office/WPS 导出 PDF。 ### autos.skills.powerPoint.exportSlidesAsImages(presentation,dir,format="png",width=0,height=0) # 通过 Office/WPS 导出各页图片。 ### autos.skills.powerPoint.extractPptxMedia(path,outputDir,overwrite=true,options) # 统一调用 fsys.openXml.pptx.extractMedia，返回本次已导出的文件数组。旧入口默认允许覆盖；overwrite=false 跳过已有文件。同名平铺冲突报错。 CRC、长度、限额或写入失败返回 null,err,partial，不把半成品当成功；partial.files 为已提交文件。仅复制原始字节，不执行或转码。options 可指定读取限额。 ### autos.skills.powerPoint.extractTextFromPptx() # [返回对象:openXmlPresentationObject](#openXmlPresentationObject) ### autos.skills.powerPoint.extractTextFromPptx(path,includeNotes=true,options) # 统一调用 fsys.openXml.pptx.read；按实际页序读取正文、基本表格与备注。旧字段保留；notes 逐页对齐，noteCount 为实际含备注部件的页面数；增加 pages,warnings。 ### autos.skills.powerPoint.getActivePresentation(startIfMissing=false) # 获取活动演示文稿 COM 对象。 ### autos.skills.powerPoint.getActivePresentationInfo(startIfMissing=false) # 获取活动演示文稿信息。 ### autos.skills.powerPoint.getApp(startIfMissing=false,visible=true) # 连接或启动 Office/WPS，返回 Application COM 对象；失败返回 null,err。 ### autos.skills.powerPoint.getAppInfo(startIfMissing=false) # 返回应用名称、版本、文稿数与活动文稿名。 ### autos.skills.powerPoint.getPresentationInfo(presentation) # 返回 name,fullName,path,slideCount,saved。 ### autos.skills.powerPoint.isRunning() # 检查 PowerPoint/WPS 是否已运行。 ### autos.skills.powerPoint.listPptxEntries(path,pattern,options) # 使用 fsys.openXml.pptx 列举真实 ZIP 条目，包含目录。保留 path,isDir,size,formattedSize；增加 name,compressedSize,contentType；pattern 为 aardio 模式串。 options 可传 fsys.openXml 读取限额；并非整包内容校验。 ### autos.skills.powerPoint.listPptxMedia(path,options) # 列出标准 ppt/media/ 及主部件同级 media/ 下的文件，含子目录；不含目录项。保留 path,name,ext,size,isDir,formattedSize；增加 partName,contentType,compressedSize。不是按页引用分析，不保证发现任意路径的媒体。 ### autos.skills.powerPoint.openPresentation(path,startIfMissing=true,withWindow=true,readOnly=false) # 通过 Office/WPS 打开演示文稿。 ### autos.skills.powerPoint.saveAs(presentation,path,format,overwrite=true) # 通过 Office/WPS 另存文稿；format 为名称或数值。 ### autos.skills.powerPoint.version # 技能包版本。