GB/T34997-2017
中文办公软件网页应用编程接口
Chineseofficesoftware—APIforWebapplication
- 中国标准分类号（CCS）L76
- 国际标准分类号（ICS）35.240.20
- 实施日期2018-05-01
- 文件格式PDF
- 文本页数36页
- 文件大小1.62M
以图片形式预览中文办公软件网页应用编程接口
中文办公软件网页应用编程接口
国家标准 GB/T34997一2017 中文办公软件网页应用编程接口 Chineseoftieesoftware一APIforwebapplieationm 2017-11-01发布 2018-05-01实施 国家质量监督检验检疫总局 发布 国家标准化管理委员会国家标准
GB/34997一2017 目 次 前言 引言 范围 2 规范性引用文件 术语和定义 接口描述 4.1插件初始化 4.2文件接口 4.3界面控制接口 4.4查找替换接口 4.5 书签接口 13 4.6 文档编辑接口 l6 4.7页面设置接口 4.8表格接口 18 4.9图片接口 20 4.10文本框接口 21 4.11插人内容接口 21 4.12修订和审批接口 23 4.13自定义域处理接口 26 4.14基础监听接口 29 附录A规范性附录事件监听的消息名称表 31 参考文献 32
GB/34997一2017 前 言 本标准按照GB/T1.1一2009给出的规则起草
请注意本文件的某些内容可能涉及专利
本文件的发布机构不承担识别这些专利的责任 本标准由全国信息技术标准化委员会(S.AC/TC28)提出并归口
本标准起草单位:电子技术标准化研究院、中标软件有限公司、无锡永中软件有限公司、珠海金 山软件有限公司、北京信息科技大学等
本标准主要起草人;方春燕、张展新,吴新松、李宁、丁伟、王耀,刘瑜、王剑,李幸苗宗利、柳杨、 詹欣坤、田英爱
GB/T34997一2017 引 言 GB/T21026《中文办公软件应用编程接口规范》定义了与中文办公软件文档格式(简称“标文通” UoF)相适应的中文办公软件应用编程接口,用于读写“标文通”文档
在中文办公软件集成应用过程 中,办公软件需要为基于浏览器的网页应用提供统一的接口,实现对办公软件的操作
本标准以java 语言对接口进行描述,C十十语言可以参考实现
IN
GB/34997一2017 中文办公软件网页应用编程接口 范围 本标准规定了中文办公软件的网页应用编程接口,包括文件接口、界面控制接口、查找替换接口、书 签接口、文档编辑接口、页面设置接口、表格接口、图片接口、文本框接口,插人内容接口、修订和审批接 口、自定义域处理接口和基础监听接口等接口定义 本标准适用于中文办公软件产品文字处理组件和网页集成应用的开发和测试
规范性引用文件 下列文件对于本文件的应用是必不可少的
凡是注日期的引用文件,仅注日期的版本适用于本文 件
凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件
GB/T20916中文办公软件文档格式规范 术语和定义 下列术语和定义适用于本文件
3.1 接口定义语言interlacedefinition language 用于描述对象实现所提供的,客户端对象所调用的服务接口的描述语言
接口描述 4.1插件初始化 功能说明 初始化插件
接口原型 objeetinit(stringtagID，stringwidth，stringheight 参数说明(3个参数). 参数1:tagI插件所处网页标签的id位置; 参数2;width插件宽度,单位像素; 参数3;height插件高度,单位像素
返回值说明: 成功则返回初始化后的插件对象;失败则返回nul 备注 agD所对应的标签的innerHTML内容替换为插件;width和height遵循html规范的要求
本接口仅用于打开单个文件
GB/T34997一2017 4.2文件接口 4.2.1创建空文件 功能说明 创建空文件
接口原型 booleancreateDocument(stringtype 参数说明(1个参数): 参数1:type文件类型,uot表示符合GB/T20916的文字处理文档
返回值说明: rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 4.2.2打开本地文档 功能说明: 打开本地文件
接口原型 booleanopenDoeument(stringfileName，booleanreadOnly 参数说明(2个参数): 参数1:;fileName本地文件的全路径,包括扩展名 参数2;readOnly为true时表示按只读打开,否则按可编辑打开
返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 如果扩展名是文档模板,如为“uott”,则按模板创建符合GB/T20916的新文档
4.2.3打开远程文档 功能说明: 打开远程文件
接口原型: booleanopenDocumentRemote(stringURL，booleanreadO)nly 参数说明(2个参数). 参数1URL远程文件的URL全路径,包括扩展名; 参数2;readOnly为true时表示按只读打开,否则按可编辑打开
返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现 备注 如果扩展名是文档模板,如“uott”,则按模板创建一新文件
4.2.4以监听模式打开文档 功能说明
GB/T34997一2017 true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.2.8打印 功能说明 不调对话框打印当前文件
接口原型 boolean prin 参数说明:无 返回值说明: true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 当未设置默认的本地打印机或无法直接打印时,弹出打印对话框
4.2.9调用打印对话框 功能说明 调用打印对话框
接口原型 booleanshowPrintDialog( 参数说明:无
返回值说明: rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.2.10打印预览 功能说明: 打印预览功能
接口原型 booleanprintPreview( 参数说明;无
返回值说明 true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.2.11打印设置 功能说明: 设定内容打印设置
接口原型: boolean printSetting(intnPrint) 参数说明(1个参数):
GB/34997一2017 参数1;nPrint打印设置参数,为以下取值的和
1表示页面背景,2表示图片和对象,4表示 隐藏的文字,8表示文字占位符,16表示表单控件
返回值说明 e表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
true 备注 无
4.2.12打印/不打印修订文字 功能说明 按照参数要求直接打印
接口原型 bool leanprintRevision(in intenable 参数说明(1个参数). 参数1:enable为0表示打印修订状态;为1表示打印原始状态(修订前);为2表示打印最终 状态(修订后. 返回值说明 true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.2.13关闭 功能说明 关闭文档
接口原型 booleanclose( 参数说明:无
返回值说明: true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.2.14以监听模式关闭文档 功能说明 以监听模式关闭文档,该丽数仅适用于插件且弹出式(非嵌人式)窗口模式 接口原型 booleaneloseFilewithCloseListener() 参数说明;无 返回值说明 true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
GB/T34997一2017 4.3界面控制接口 4.3.1显示/隐藏工具菜单 功能说明 显示或隐藏全部工具菜单
接口原型: booleansetToolbarAlIVisible(booleanenable 参数说明(1个参数): 参数l:enable为true表示显示,为false表示不显示 返回值说明 true 表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现 备注 无
4.3.2显示/隐藏指定工具菜单 功能说明 显示或隐藏指定工具菜单
接口原型 booleansetToolbarPartVisible(inttoolbarNum,booleanenable 参数说明(2个参数). 参数1:toolbarNum工具栏编号,编号含义见表1
表1工具栏编号及含义 工具栏编号 工具栏名称 01 开始 0101 文字式样 0102 段落式样 插人 02 0201 表格 0202 图片 0203 形状 0204 文本框 0205 域 0206 页眉页脚 自定义域 0207 页面布局 03 0301 页边距 0302 纸张 0303 版式
GB/34997一2017 表1(续 工具栏编号 工具栏名称 0304 文档网格 0305 分栏 0306 背景 页面边框 0307 文字环绕 0308 0309 组合 04 引用 0401 目录 0402 索引 0403 脚注 尾注 0404 0405 引用 交 叉 05 审阅 0501 批注 0502 修订 06 视图 0601 页面视图 全屏 0602 大纲 0603 0604 文档结构图 0605 显示比例 参数2;enable为true表示显示,为false表示不显示 返回值说明 表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
true 备注: 无
4.3.3设置为只读 功能说明 动态设置文档为只读或恢复可编辑 接口原型 booleanenableProtect(booleanenable) 参数说明(1个参数) 参数l;enable为true表示不可编辑,false表示可编辑
返回值说明 表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
true
GB/T34997一2017 备注 无
4.3.4获取文档是否只读状态 功能说明 判断当前文档是否是只读状态
接口原型 booleanisReadOnly( 参数说明;无
返回值说明 表示文档只读;false表示文档可编辑
true 备注 无
4.3.5设置文档是否被修改状态 功能说明 设置当前文档是否被修改的状态
接口原型 booleansetModified(bModified 参数说明(1个参数). 参数1:bModified文件是否被修改,true表示已被修改,false表示未被修改
返回值说明: rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无 4.3.6获取当前文档是否被修改状态 功能说明: 判断当前文档是否被修改
接口原型 booleanisModifed(O) 参数说明;无
返回值说明 rue文档已被修改,false文档未被修改 备注 无
4.3.7光标定位文档头部 功能说明: 光标定位到文档头部
接口原型: voidcursorToDocStart( 参数说明:无
GB/34997一2017 返回值说明: rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注: 无
4.3.8光标定位文档尾部 功能说明 光标定位到文档尾部
接口原型 cursorToDocEnd( 参数说明:无 返回值说明 表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现. true 备注 无
4.3.9光标定位到指定的自定义域 功能说明 光标定位到文档尾部
接口原型 cursorToDocumentFieldstringid 参数说明 参数1;id自定义域标识符
返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.3.10光标前进一格 功能说明: 光标前进一格,即右移一格
接口原型 booleannmoveRight(G 参数说明:无
返回值说明: true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注: 无
4.3.11光标退格 功能说明 光标退格,即左移一格
接口原型
GB/T34997一2017 booleanmoveLeft(O 参数说明:无
返回值说明: rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
43.12光标上移一行 功能说明 光标上移一行
接口原型 booleanmoveUp(O 参数说明:无
返回值说明 true表示接口调用成功,功能能够实现;lalse表示接口调用失败,功能未能实现
备注 无
4.3.13光标下移一行 功能说明: 光标下移一行
接口原型: booleanmoveDown( 参数说明;无
返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无 4.3.14禁止内容复制 功能说明: 启用或禁止复制
接口原型 booleanenableCopy(booleanenable) 参数说明(1个参数): 参数l:enable为true表示允许复制,为false表示不允许复制
返回值说明: true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 同时设置菜单、工具栏、快捷键和右键的功能
4.3.15禁止内容剪切 功能说明 10
GB/34997一2017 启用或禁止剪切
接口原型 booleanenableCut(booleanenable' 参数说明(1个参数): 参数l;enable为true表示允许剪切,为false表示不允许剪切
返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 同时设置菜单、工具栏、快捷键和右键的功能
4.3.16开启/停止修订 功能说明 开启或停止修订
接口原型 booleanenableRevision(booleanenable) 参数说明(1个参数): 参数l;enable为true表示开启修订,为false表示停止修订 返回值说明: rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注: 无
4.3.17设置鼠标操作属性 功能说明 是否可用鼠标的各项操作
该功能作用于当前文档
接口原型 booleanenableMouseHandle(intbuttonType,booleanenable) 参数说明(2个参数). 参数1;buttonType鼠标键的标识,同时按下则数值相加
1表示左键,2表示右键,4表示 中键
参数2;Enable是否可用,true表示可用,false表示禁用
返回值说明 true表示设置成功;false表示设置失败
备注: 无
4.4查找替换接口 4,4.1查找替换所有文本 功能说明 用指定的内容替换文档中所有指定的文字
接口原型 txtl， txt2 intfindAndReplaceText(string strng 11
GB/T34997一2017 参数说明(2个参数): 参数l:txtl需要查找的文字 参数2;:txt2用于替换的文字
返回值说明 函数返回值说明表示搜索替换的位置个数;文档为只读状态查找替换失败返回值说明为o 备注 无
4.4.2查找替换第一处文本 功能说明 用指定的内容替换文档中第一处出现的指定文字
接口原型 intfindAndReplaceFirstText(stringtxtl,stringtxt2) 参数说明2个参数): 参数l:txtl需要查找的文字; 参数2:txt2用于替换的文字
返回值说明 函数返回值说明表示搜索替换的位置个数;文档为只读状态查找替换失败返回值说明为o
备注 无 4.4.3显示查找对话框 功能说明: 调用查找替换对话框
接口原型: booleanshowSearchDalog(O) 参数说明;无
返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无 4.4.4查找文本 功能说明 查找文本内容
如果查找成功,将查找到的内容选中
接口原型 booleansearchText(stringsText,booleanbForward,stringtype 参数说明(2个参数): 参数l;sText要查找的文本内容 参数2;bForward查找方向,true表示查询方向从光标当前位置向后查找直到文档结尾,再 从文档开头向后查找到光标位置;false表示查询方向从光标当前位置向前查找直到文档开 头,再从文档结尾向前查找到光标位置; 参数3:typefull表示全字匹配;part表示部分匹配
12
GB/34997一2017 返回值说明: rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注: 无
4.4.5获取文档全部文本 功能说明 获取当前文档中全部文本内容
接口原型 trimggetDoeumentTextO 参数说明;无
返回值说明 当前打开文档中全部文本内容
备注 无
4.5书签接口 4.5.1在光标位置创建书签 功能说明 在光标选择的位置创建书签
接口原型 voidcreateBookmarkAtSelection(stringname 参数说明(1个参数). 参数1;name书签名称
返回值说明: alse表示如果文档为只读状态返回或者书签名称重复,创建书签失败;true表示创建书签 成功 备注 无
4.5.2光标跳至书签位置 功能说明 光标跳至指定书签的位置
接口原型 voidcursorToBookmark(stringbookmarkName 参数说明(1个参数). 参数1:bookmarkName书签名称
返回值说明: 书签的文本内容
备注: 无
13
GB/T34997一2017 4.5.3替换书签名称 功能说明 替换书签名称
接口原型 oldName， wdName boolean replaceBookmarkName e(string stringne 参数说明(2个参数): 参数l:oldName旧书签名; 参数2;newdName 新书签名
返回值说明: true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.5.4删除书签 功能说明 删除书签
接口原型 booleandeleteBookmark(stringname) 参数说明(1个参数). 参数1:name书签名
返回值说明: rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无 4.5.5替换书签内容 功能说明: 替换书签内容
接口原型 booleanreplaceBookmarkText(stringreplaceText) 参数说明(1个参数): 参数1:;replaeeText替换书签的内容
返回值说明 true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.5.6按书签名称查找 功能说明 按书签名称查找书签
接口原型 booleanfindBookmark(s stringname) 14
GB/34997一2017 参数说明(1个参数): 参数1;name书签名称
返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.5.7获取书签文本内容 功能说明 获取书签文本内容
接口原型 tringgetBhokmarkTesxstringname) 参数说明(1个参数 参数1;name书签名称
返回值说明 书签文本内容
备注: 无
4.5.8获取书签个数 功能说明 获取全文书签个数
接口原型 intcountBookmark( 参数说明;无
返回值说明 书签个数
备注 无 4.5.9获取书签列表 功能说明 获取所有书签的名称
接口原型: tAllBookmarkName(O arrayget 参数说明;无
返回值说明 全部书签名称的字符串列表
备注 无
15
GB/T34997一2017 4.6文档编辑接口 4.6.1图片插入到文档当前位置 功能说明: 在当前光标位置嵌人式,用户可调大小
接口原型 tPicet eFile booleaninser cture(stringpicture 参数说明(1个参数): 参数1;pictureFile本地图片用文件名,远程图片用URL
返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 用于公文正文插图
4.6.2本地图片插入到文档指定位置 功能说明: 在指定坐标位置插人指定大小的图片,用户可调大小
接口原型 reFle left，inttop，intwidh，intheight booleaninsertPicture(stringpicturG ，int 参数说明(5个参数): 参数1:pietureFile本地图片用文件名,远程图片用URL; 参数2:left相对于页面左上角的横坐标,单位为毫米(mm); 参数3:top相对于页面左上角的纵坐标,单位为毫米(nm mm; 参数4width图片宽度,单位为毫米(mm); 参数5;height图片高度,单位为毫米(mm)
返回值说明 rue表示接口调用成功,功能能够实现;alse表示接口调用失败,功能未能实现
备注 可用于插人二维码
4.6.3提取全文文本 功能说明: 返回全文的无格式文本
接口原型 tringgetTex( 参数说明;无 返回值说明 全文文本的字符串
备注 不含格式控制符 16
GB/34997一2017 4.6.4设置段落首行缩进 功能说明 设置光标所选段落的首行缩进
接口原型 voidsetFirstLinelndent(floatlinelndent 参数说明(1个参数) 参数1:linelndent缩进值
返回值说明: true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.6.5设置段落间距 功能说明 设置光标所选内容所在段的段间距
接口原型 voidsetPar g(floatparagraphSpacing rnemphsp Da Og 参数说明(1个参数. 参数l:paragraphSpacing段间距大小,单位为行距的倍数
返回值说明 rue表示接口调用成功,功能能够实现;talse表示接口调用失败,功能未能实现
备注: 无
4.7页面设置接口 4.7.1设置页面显示比例 功能说明 设置页面显示比例
接口原型 voidzoom(stringzoomValue 参数说明(1个参数). 参数1;zoomValue页面显示比例的值
返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注: 无
4.7.2获取当前页面比例 功能说明: 获取页面显示比例的值
接口原型 17
GB/T34997一2017 StringgetZoomValue( 参数说明:无
返回值说明: 返回页面显示比例值
备注 无
4.8表格接口 4.8.1设置单元格保护属性 功能说明: 对指定表格的指定单元格设置保护或取消保护操作
接口原型 booleansetCelProtected(stringtableName,intcolumnCount,introwCount,booleanisPro tected 参数说明(4个参数): 参数l:tableName表格名称; 参数2:rowCount单元格所在表格的行数 参数3;columnCount单元格所在表格的列数; -参数4:isProtected保护/取消保护指定单元格， true 表示保护指定单元格,false表示取消保 护指定单元格
返回值说明 如果文档为只读状态返回值说明false;设置成功返回true 备注 无
4.8.2光标定位单元格 功能说明 光标跳至指定表格指定单元格
接口原型 voidceursorToCel(stringtableName,intcolumnCount,introwCount) 参数说明(3个参数): 参数1;tableName表格名称; 参数2;rowCount单元格所在表格行号; 参数3:columnCount单元格所在表格列号
返回值说明: 操作成功返回true;操作失败返回false 备注 无
4.8.3在鼠标位置插入表格 功能说明: 在鼠标选择的位置插人表格
18
GB/34997一2017 接口原型 voidinsertTableAtSeleetion(stringtableName,intcolumnCount,introwCount 参数说明(3个参数): 参数1;tableName表格名称; 参数2:columnCount表格的列数; 参数3;rowCount表格的行数
返回值说明 如果文档为只读状态返回false,插人表格失败;插人表格成功返回true 备注 无
4.8.4调用表格对话框 功能说明 调用插人表格对话框 接口原型 voidinsertTableDialog(O 参数说明;无 返回值说明 如果文档为只读状态返回false,弹出插人表格对话框失败;弹出插人表格对话框成功返回 true
备注 无
4.8.5删除指定表格 功能说明 删除指定名称的表格
接口原型 voidremmoveTable(stringtableName) 参数说明(1个参数). 参数1:tableName表格名称
返回值说明: 删除表格成功返回true;删除表格失败返回false
备注 无
4.8.6设置表格的行高 功能说明 设置表格的行高
接口原型 doubleheight) boolean.sectRowHeghr(strimngtableNa ame，intnum， 参数说明(3个参数): 参数l;tableName表格名称; 参数2;num表格行数,从1开始; 19
GB/T34997一2017 参数3;height行高度,单位为毫米(mm) 返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.8.7设置表格的列宽 功能说明: 设置表格的行高
接口原型 booleansetColumnWidthstringtableName，intnum，doublewidth 参数说明(3个参数). -参数l:tableName表格名称; 表格列数,从1开始 参数2:num 参数3:height列宽度,单位为毫米(mm)
返回值说明: true 表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现 备注 无
4.9图片接口 4.9.1在光标位置插入图片 功能说明: 在光标所在位置插人图片
接口原型 voidinsertlmageAtSeleetion(stringURL.,floatwidth,floatheigh) 参数说明(3个参数): 参数1:URL图片的存放路径; 参数2:width图片宽度,单位为毫米(mm); 参数3;height图片高度,单位为毫米(mm)
返回值说明: 如果文档为只读状态返回null,插人图片失败;插人图片成功返回一个图片对象
备注 无 4.9.2调用插入图片对话框 功能说明 调用“插人图片”对话框
接口原型 booleaninsertlmageDialog(O 参数说明:无 返回值说明 20
GB/34997一2017 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.10文本框接口 4.10.1光标定位文本框 功能说明 光标定位指定文本框
接口原型 booleancursorToTextFrame(stringframeName) 参数说明(1个参数): 参数1:frameName文本框名称
返回值说明 操作成功返回true.,操作失败返回false. 备注: 无
4.10.2设置文本框文字方向 功能说明 设置文本框文字方向
接口原型 voidsetTextFrameDirection(booleantextDirection 参数说明(1个参数). 参数1;textDireetion文本框的文字方向,landscape表示横向portrait表示纵向
返回值说明: 操作成功返回true,操作失败返回false 备注 无
4.11插入内容接口 4.11.1光标位置插入文本 功能说明: 在光标所在位置插人文本内容
接口原型 ooleaninsertTex(strngtitle) 参数说明(1个参数): 参数l:title插人的内容
返回值说明: true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
21
GB/T34997一2017 4.11.2插入文档页码 功能说明: 在文档中插人页码
接口原型: booleaninsertPageNumber( 参数说明;无
返回值说明 true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.11.3插入页眉 功能说明 插人页眉 接口原型: booleaninsertPageHeader( 参数说明:无
返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.11.4插入页脚 功能说明: 插人页脚
接口原型 booleaninsertPageFooter( 参数说明;无
返回值说明 true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.11.5光标位置插入时间 功能说明: 在光标所在位置插人时间
接口原型 booleaninsertTime(datesFormat 参数说明1个参数): 参数l:sFormat时间格式,示例见表2 22
GB/T34997一2017 接口原型 booleanenableRevisionAcceptCommand(booleanenable 参数说明(1个参数): 参数1eanable为true表示启用接受修订按钮,为alee表示禁用接受修订按钮
返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现 备注 无
4.12.2禁用/启用工具栏中拒绝修订按钮 功能说明 禁用或启用工具栏中拒绝修订按钮
接口原型 booleanenableRevisionRejectCommand(booleanenable 参数说明(1个参数) 为tre表示启用拒绝修订按钮,为alee表示禁用拒绝修订按镇. 参数1:enable 返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无 4.12.3显示修订文字的状态 功能说明: 显示修订文字的状态
接口原型: booleanshowRevision(intenable) 参数说明(1个参数): 参数1:enable为0表示显示修订状态;为1表示显示原始状态(修订前);为2表示显示最终 状态(修订后). 返回值说明: rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.12.4设置审批用批注或修订的用户名 功能说明 设置审批用批注或修订的用户名
接口原型 booleansetUserName(stringuserName 参数说明(1个参数): 参数1userNa Name为要使用的用户名
返回值说明: true表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
24
GB/34997一2017 备注: -般通过设置办公软件当前的用户名
4.12.5获取审批用批注或修订的用户名 功能说明 获取审批用批注或修订的用户名
接口原型 tringeUeNameO 参数说明:无
返回值说明 当前的用户名
备注 -般获取办公软件当前的用户名
4.12.6按用户接受批注或修订 功能说明 根据指定作者筛选修订,并接受或拒绝其修订
接口原型 voidfflterCertainAuthor(stringauthor,booleanbAccept) 参数说明(2个参数). 参数1:author指定修订的作者; 参数2;bAccept接受或拒绝标志位,true表示接受,false表示拒绝
返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.12.7获取修订状态 功能说明: 获取当前文档的修订状态
接口原型 booleangetRecensionStatus(O 参数说明;无
返回值说明 rue表示文档为开启修订状态;false表示文档为关闭修订状态
备注 无
4.12.8获取所有修订内容 功能说明 获取文档中所有修订内容 接口原型 etAllRevisions( stringget 25
GB/T34997一2017 参数说明:无
返回值说明 为文档中所有修订内容,包括:修订内容,用户名称和修订时间
备注 无
4.12.9接受所有修订 功能说明: 接受所有修订者的修订内容
接口原型 DtAllCh6 booleanaccept hanges(O 参数说明:无
返回值说明 rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现 备注 无
4.12.10拒绝所有修订 功能说明: 拒绝所有修订者的修订内容
接口原型 voidrejectAlChanges( 参数说明:无
返回值说明 true表示接口调用成功,功能能够实现;lalse表示接口调用失败,功能未能实现
备注 无 4.13自定义域处理接口 4.13.1增加自定义域 功能说明 在光标当前位置增加自定义域
接口原型 ooleanimserDocumentrFied(stringid 参数说明1个参数): 参数1:id自定义域ID. 返回值说明: rue表示接口调用成功,功能能够实现;false表示接口调用失败,功能未能实现
备注 无
4.13.2修改自定义域内容 功能说明 26
了解中文办公软件网页应用编程接口GB/T34997-2017
随着互联网技术的不断发展，网页应用已经成为我们日常生活和工作中不可或缺的一部分。而对于中文办公软件的开发者来说，如何在网页应用中实现各种功能呢？这时候就需要用到中文办公软件网页应用编程接口GB/T34997-2017了。下面我们就来详细介绍一下这个标准。
中文办公软件网页应用编程接口GB/T34997-2017介绍
中文办公软件网页应用编程接口GB/T34997-2017是由国家标准化管理委员会发布的中文办公软件标准之一。该标准规定了中文办公软件的网页应用编程接口格式和规范，包括接口命名、参数说明、返回值等内容。
该标准适用于基于中文办公软件的网页应用开发，例如针对WPS、金山等中文办公软件的网页插件或扩展程序。通过遵守该标准，开发者可以更方便地实现中文办公软件的各种功能，提高应用的丰富性和用户体验。
中文办公软件网页应用编程接口GB/T34997-2017的应用
中文办公软件网页应用编程接口GB/T34997-2017的发布，为中文办公软件的网页应用开发提供了一套通用的规范，从而使得各家厂商之间的兼容性更加稳定。同时，也为开发者提供了一个统一的接口标准，使得其能够更加便捷的进行网页应用开发工作。
近年来，随着中文办公软件在国内市场的不断普及，越来越多的企业开始将其应用于日常生产工作中。与此同时，中文办公软件网页应用的需求也呈现出不断增长的趋势。可以预见，未来中文办公软件网页应用的开发和应用前景将会越来越广阔。
结论
中文办公软件网页应用编程接口GB/T34997-2017是中文办公软件领域的一项重要标准。其发布为中文办公软件的网页应用开发提供了一套通用的规范，从而使得各家厂商之间的兼容性更加稳定，同时也为开发者提供了一个统一的接口标准，使得其能够更加便捷的进行网页应用开发工作。
相信随着技术的不断进步和标准的完善，中文办公软件网页应用的开发和应用前景将会越来越广阔。
