本标准规定了与中文办公软件文档格式UOF相适应的中文办公软件应用编程接口。 GB/T 21026-2007 中文办公软件应用编程接口规范 GB/T21026-2007 标准下载解压密码：www.bzxz.net

中文办公软件应用编程接口规范中国标雅出版杜
ICS 35. 240. 20
Ｌ 76
中华人民共和国国家标准
GB/T21026—2007
中文办公软件应用编程接口规范Specification for Chinese office software applicalionprogramming interface
2007-06-29发布
中华人民共和国国家质量监督检验检疫总局中国国家标准化管理委员会
2007-11-01实施
规范性引用文件
术语和定义
接口描述
基础接口模块
uof_base
应用相关接口模块
图形相关接口模块
uaf_app
uat_shape
uof_Format
格式相关接口模块
文档通用处理接口模块uof_doc
字处理关接口模块uol_text
电子表格处理相关接口模火uof_spreudsheet5.8
演示文稿处理相关的接口模块uof_prcscntation5.9
5.10存储管理接口模块uof_pack5.11异常处理模块uof_err...
附录A（资料性附录）
参考文献
中文办公软件应用编程接口IDI
GB/T 21026—2007
本标准附录A为资料性附录。
本标准由中华人民共和国信息产业部提出。GB/T21026-2007
本标推由中国电子技术标准化研究所归口。本标准的起草单位：中国电子技术标准化研究所、中国科学院软件研究所、北京信息工程学院，珠海金山软件股份公司，无镐永中科技有限公司、北京红旗中文武仟软件技术有限公司、北京九州软件有限公司、上海中标软件有限公司。本标准的主妻起草人：是志刚、李宁、丁蔚、陈建明、黄芳、王长胜、李健萍、成修治、赵菁华。GB/T 21026—2007
本标准规定了与GB/T2091《中文办公软件文档格式规范》相适应的中文办公软件应用编程接口(API).
本标准旨在为中文办公软件的二次开发制定一个统一的开发接国，达到平台无关、语言无关、产品无关，利于产品的移植和软件重用，提离二次开发的效，便丁与其他应用系统集成。本标推适用于中文办公软件产品的开发人员、文档格式的使用人员和其他相关的研究开发体。本标准制定的API主要针对中文办公软件的文档格式（UOF)提供基本的访问和修改功能。未来版本将逐步规范其他方面的接问。对于本标准末作规定的内容二次并发厂商可以根据需要自行扩充实现。
1范蘭
中文办公软件应用编程接口规范GB/T21026—2007
本标推规定丁与中文办公软件文档格式UoF(UnificdOfficeFormat)相适应的中文办公软件应用编程接口（API)。
本标准适用于中文办公软件产品的开发人员，文档格式的使用人员和其他相关的研究开发群体。2规范性引用文件
下列文件中的条款通过本标准的引用而成为本标难的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而.鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标谁。GB/T20916中文办公软件文档格式规范3术语和定义
下列术语和定义适用于本标准。3.1
组件componenl
可复用的软件组成成分，可被用来构造其他软件。它可以是被封的对象类、类树、一些功能模块、软件框架、软件构架（或体系结构）、文档、分析件、设计模式等。3.2下载标准就来标准下载网
接口interface
对象所提供的一系列操作（方法)和属性。3.3
接口定义语言interface definition language用于描述对象实现所提供的、客户端对象所调用的服务接口的描述语言。3.4
孤行orphar
单独打印在一页顶部的某段的最后一行。3.5
察行widow
单独打印在一页底部的某段的第一行。3.6
文挡对象模型
Mncunent Object Model
W3C制定的XML应用程序接口。它将XML文档表示成一个树形的结构。DOM规定了一系列编程指令，允许应用程序多次访问并操作文档树的组件。4约定
本标准遵循：
一API采用对象管理组织（ObjeceManagementGroup，OMG）IDL（接口定义语言）3.0进行描1
CB/T 21026—2007
述（见参考文献L1J)。
充分参考现有的API标准，特别是W3C制定的与XML相关的API，目前包括制定完成的或正在制定的.API(见参考文献[2])。充分尊重用户的使用习惯，接近现有主流办公软件产品的A你系。仅规范接口，不规定实现相关的内容。接口命名以字母\I\开始。所有名称采用1,CC命名方式,尽量简洁直观。5接口描述
5.1概述
本标准共规定了10个接口模块，癣个模块定义相关的数据类型接口，见表1。表1中文办公软件应用编程接口模块模块名称
uof hase
tuof_app
uol_shape
uul_furmat
ual_doe
uof_5preadlshee!
uof_presenLanten
uol_park
uof_crr
模块内容
基硼接口模块
盛用粘送换口携染
因彩妞美自榄垫
格式相美口教技
交档通用处理接口模
享处理相关接户模块
电子表塑塑润装格口模块
顾示文稍处理相关接口核块
存储管接口枢块
异常妞理模快
全部接口的IDL窕义参见附录A。5.2 基础接口模块 antjase
定义常用的数据类型和基础接口，这些口大部外被其独锈口继柔。5.2.1容器接口1Cantamer
继承无。
属性：
名称：court.
定义;tcadonly attribut insigred Jonig cuunt说明：容器单元数量。
方法；
void elear()
说明：清空容器。
参数无。
返回：无。
any initialize(in any newltem)说明：初始化，加人一个单元。参数：newIten为新入的单元。
返回：新加人的单元
定义接口数
any getItemByIndex(in unsigned long index) raises(uof_err: : UOFException)2
说明：获取一个单元。
参数：index为要获取单元的位置。返回:新加人的单无。
anyinsertltemBeforecin any newItem,inunsignel long index)raises(uof_crt: : UOFFxception)说明：在某个位整前插人新单元。参数：
ncwItem为新插人的单元：
index为要插人单元的位置，新单元赖插人此位置之前。返回：新插人的单元：
anyinscrtItetnAiterfinanynewltem,ininsigned longindex)raises(uof_err : ;UOFException)说明：在蒸个位假后插人新单元，返回所插人的对象。参数：
Itewhem为新插A的单元：
index为要插人单元的你置，新单元将人此位证之后。返间:赖插入的单元
CB/T 21026—2007
boolean reneoveitem(ir unsigned long inrlex)raisns(u-f_err::UOFExcepnion)说明：两除某个位留单元。
参数，hdex为要删除单元的统置。返：成功为true-否则为false.
any appouditem(in Any Eowlera)说明：在容器末尼润加一个单元参数：itewltem为乐留如的单元，返国，恭加的单元。
5.2.2所有UOF元累的基元素接口Jelemerrt
继承don：：日erment
属性：
名称：luc[D
定义:readonly atrfbute DOMString locD说明：语义标识符，于不佩语种翻译。方法：
DOMSuringTListgetAttribmuteList()说明：获取属性\attrist\的慎鼠烈出元素光许的厕性序列，用于不同语种翻译。参数：无。
返回：风性\attrList\的值。5.3应用相关接口模块unf_app
定义与办公软件应用相关的接口（如对桌面的操作），通过这里定义的接口，办公软件应用可以启动文字处理、电子表格处理和演示文稿处理等组件，并经切换。这里假定字处理、表处理和演示文稿处班等同厨一个桌面应用，且字处理、表处理和演示文稿处理等组件在一个桌面应用中各自只能启动一个（即不能同时出现两个字处理应用）。另外，字处理、表处理和演示文稿处理等组件各自能够打开多个文档。
GB/T 21026—2007
5. 3. 1数据类型定义
组件类型appTye为举类型，取值可为：TEXT_PROCESSOR 文字处理
SPREADSHEET_PROCESSOR 电于表格处理PRESENTATION_PROCESSOR演示文处理5.3.2组件接口的基接口1AppBase继承：dom:：DOMlmplcmcntation属性：
名称：name
定义:readonly attribute DOMString name说明：区别组件的名称。
名称：type
定义:readonly attrihute appType type说明：区别组件的类型标识。appype的定义见5.3.1。方法：
IDoculent upenDucument(in DOMString url) raistex(uof_err; : UOFExccption)说明:打开 url 标识的文档。
参数url为打开文档的标识。
返回：文档对象。
void saveDocuneni(in [DoMString url)Iaiscs(uof_err;;UOFExcepton)说明：保荐文档。
参数：ur!为耍保存文档的标识
返间：无。
void saveAstDocument(in DOMString url) aisestuof_err: :UOFException)说明：文档\另存为”新的文档。参数：url为要保存文挡的标识。返回无。
hoolean deleteDocumnent()raises(uof_err: : UOFException)说明：物理删除当前的文档。
参数：流。
返回：成功为 true，否则为 false。ILacumentSet getDocumcntst)
说明：获得同一应用的所有文档。参数：无。
返回文档对象集合。
IDacument getAetivelocumenr()说明：获得当前文悄。
参数：无。
返回：文档对象。
void aetivaleDoeument(in IDocurnent documeni)说明：將文档置成当前文档。
参数：dacurnen为要置成当前文档的文档。返回：无。
voirl close()
说明：关闭组件。
参数：dacument为要置成当前文档的文档。返回.无。
5.3.3桌面应用接口[Application继承：无。
腐性：无。
GB/T 21026—2007
方法：
IAppBase createApplicationCin appType type) raises(uof_crr: : UUFException)说明：创建几个主要组件之一
参数：type为组件类型名，applype的定义见5.3.1。返回;组件对象。
IAppBase locateApplication(in appType type) raises(uof_err : : UOFException)说明：定位几个主要组件的其中一个。参数：type为需要定位的组件类型名.aprType的定义见5.3.1返回:组件对象。
void closet
说明：关闭桌面应用。需分别关闭对应组件。参数·无。
返回无。
5.4图形相关接口模块uof_shape定义与图像相关的接口，如点，线框等常用图形和自定义图形以及图表。5.4. 1 点 Ipoint
继承:无，
属性：
名称：x
定义:attribute unsigned long x说明：点的 X 坐标。
名称：y
定义:attribute urnsigned long y说明：点的Y坐标。
方法，元。
5. 4.2 点集合 IPointSet
继承：uot_base：：IContainer.属性：无。
方法：无。
5.4.3边框1Box
继承无。
属性：
名称：position
定义,attribute IPoint position说明：边框的左上角位置。
GB/T 21026—2007
名称：height
定义：attribute unsigied longheight说明：边框的高度。
名称：width
定义:attrihute unsigned long widik说明：边框的宽度。
方法·无。
5. 4. 4自选图形的基础接口
继承：无。
属性：
名称:cantrolPoints
IShape\
定义:attribute IPuintsel ontralPoints说明：控制点。
名称：type
定义：attributeDOMBtring e
说明：图形，如”國”，“矩形\等等名称：name
定义:attribule DMString aama说明：图形的名將。
名称softwafe
定义:attribete DOMString toftere说明：生成龄形的软件名称享版牵。名称：box
定义:attribete IBox bux
说明：图形的边，
名称;keyPoints
定义: attribute IPeinta keyPoiats说明：关键点集合主期于多点控制的折线和曲绒等。名称：fill
定义：attributc IFillStyleHlStyle说明：填充属性。
名称：line
定义：attribute iLinestyle line说明：线式样（包括颜色，线型、虚实、粗细等）。名称：heginArrow
定义;attrihute lArrowStyle beginArrow说明：前端箭头。
名称,endArraw
带文字的图形使用 uo[ lexi::1Shepc定义：attrihuteIArrawStyleendArrow说明：后端箭头。
名称：wiclth
定义：attribute float width
说明：宽度。
名称：height
定义：attribute Eloat height说明：高度。
名称：rotationAngle
定义：attribute float rotationAngle说明旋转角度，
名称：xResi
定义 attribute flaat xResiae说明;X方向缩效尺度。
名你：yRaeiz
定义;attribate float yHedkza说翻;Y方向缩放尺度。
名称isKepRatio
定义：httribute booleaaiKeepRatlo说明额纵横比，
名称rorigScale
定义：altritutc float orlgSeala说明：相对康始比例。
名称：isprotett
定义：atttibuitc baoleaasProteet说明：保护符。
名称：objPositia理
定义：attribute DCMString objPosition说明：随动方式。
名称：isPrint
定义:allrilute boolean isPrint说明：打印对象。
名称：wehText
定义：attributeDOMStringwebText说明：web 文字。
名称：svgElement
定义：attributeSVGElcmentsvgElement说明：SVG图形，对于非预定义图形，采用SVG作为图形交换的格式。方法：
GB/T 21026--2007
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。