DB65T 3937-2016 维吾尔、哈萨克文办公软件应用编程接口规范

维吾尔、哈萨克文办公软件应用编程接口规范SpecificationforUyghurandKazakhofficesoftwa2016-10-30实施2016-10-30实施新疆维吾尔自治区质量技术监督局发布1前言 12术语和定义 13约定 24接口描述 2附录A(资料性附录)维吾尔文、哈萨克文办公软件应用编程接口IDL 78参考文献 本标准依据GB/T1.1-2009《标准化工作导则第一部分：标准的结构和编写》的要求制定。本标准由新疆维吾尔自治区民族语言文字工作委员会提出。本标准由新疆维吾尔自治区经济和信息化委员会归口。本标准起草单位：新疆维吾尔自治区标准化研究院、中科院新疆理化技术研究所、新疆西北星信息技术有限责任公司、新疆维吾尔自治区民族语言文字工作委员会、中标软件有限公司。艾尼瓦尔、乔崇坤。具备文字处理、电子表格和演示文稿等功能的办公软件是目前使用最为广泛的应用软件之一。为了规范和推动办公软件的发展，我国制定了若干相关的国家标准和行业标准，包括：GB/T20916-2007《中文办公软件文档格式规范》、GB/T21026-2007《中文办公软件应《中文办公软件用户界面要求》等。上述标准的制定主要面向汉文、英文等从左向右书写的语言文字。然而，现行维吾尔文和现行哈萨克文是从右向左书写的文字，与汉文和英文等文字具有显著区别，故上述标准不能满足研发维吾尔、哈萨克文办公软件的需要。本标准以GB/T21026-2007为基础，针对现行维吾尔、现行哈萨克文处理的特殊要求进行了修改和扩充。本标准旨在为维吾尔文、哈萨克文办公软件的二次开发制定一个统一的开发接口，达到平台无关、语言无关、产品无关，利于产品的移植和软件重用，提高二次开发的效率，便于与其他应用系统集成。本标准适用于维吾尔文、哈萨克文办公软件产品的开发人员、文档格式的使用人员和其他相关的研究开本标准制定的API主要针对维吾尔文、哈萨克文办公软件的文档格式(UOF)提供基本的访问和修改功能。未来版本将逐步规范其他方面的接口。对于本标准未作规定的内容二次开发厂商可以根据需要自行扩充实现。DB65/T3937—2016本标准规定了维吾尔文、哈萨克文办公软件应用编程接口(API)的术语和定义，约定、接口描述的要求。本标准适用于维吾尔文、哈萨克文办公软件产品的开发。2术语和定义下列术语和定义适用于本文件。可复用的软件组成成份，可被用来构造其他软件。它可以是被封装的对象类、类树、一些功能模块、软件框架、软件构架(或体系结构)、文档、分析件、设计模式等。对象object对象是面向对象程序设计语言中类的实例化。对象所提供的一系列操作(方法)和属性。接口定义语言interfacedefinitionlanguage用于描述对象实现所提供的，客户端对象所调用的服务接口的描述语言。孤行orphan单独打印在一页顶部的某段的最后一行。寡行widow单独打印在一页底部的某段的第一行。]2——API采用对象管理组织(ObjectManagementGroup,OMG)IDL(接口定义语言)3.0进行描述(见参考文献CommonObjectRequestBrokerArchitecture,CoreSpecification(Version3.0.3),ObjectManagementGroup,Inc,March200定的API(见参考文献DocumentObjectModel(DOM)Level3CoreSpecification(Version1.0),W3CProposed——充分尊重用户的使用习惯，接近现有主流办公软件产品的API体系；——仅规范接口，不规定实现相关的内容；——接口命名以字母“I”开始。所有名称采用LCC命名方式，尽量简洁直观。本标准共规定了10个接口模块，每个模块定义相关的数据类型和接口，见表1。23图形相关接口模块66电子表格处理相关接口模块880注：全部接口的IDL定义参见附录A。4.2基础接口模块uof_base定义常用的数据类型和基础接口，这些接口大部分被其他接口继承。34.2.1.1继承4.2.1.2属性——voidclear()anygetItemByIndex(inunsignedlongindex)raises(uof_err::UanyinsertItemBefore(inanynraises(uof_err::UOFExcepraises(uof_err::UOFExcepnewItem为新插入的单元booleanremoveItem(inunsignedlongindex)raises(uof_err::UOFException)4返回：成功为true,否则为false。anyappendItem(inanyn4.2.2所有UOF元素的基元素接口IElement4.2.2.1继承4.2.2.2属性定义：readonlyattrib4.2.2.3方法说明：获取属性“attrList”的值，即列出元素允许的属性序列，用于4.3应用相关的接口模块uof_app不能同时出现两个字处理应用),另外，字处理、表处理和演示文稿处理等组件各自能够打开多个文档。4.3.1数据类型定义4.3.2组件接口的基接口IAppBase4.3.2.1继承4.3.2.2属性5说明：区别组件的类型标识。参见appType的定义。4.3.2.3方法IDocumentopenDocument(inDOMStringurl)raises(uof_err:说明：打开url标识的文档。参数：url为打开文档的标识。返回：文档对象。voidsaveDocument(inDOMStringurl)raises(uof_err::说明：保存文档。参数：url为要保存文档的标识。返回：无。voidsaveAsDocument(inDOMStringurl)raises(uof_err:说明：文档“另存为”新的文档。参数：url为要保存文档的标识。返回：无。booleandeleteDocument()raises(uof_err::UOFException)说明：物理删除当前的文档。参数：无。返回：成功为true,否则为false。说明：获得同一应用的所有文档。参数：无。返回：文档对象集合。IDocumentgetActiveDocum说明：获得当前文档。参数：无。返回：文档对象。voidactivateDocument(inIDocumentdocument)说明：将文档置成当前文档。参数：document为要置成当前文档的文档。返回：无。说明：关闭组件。参数：document为要置成当前文档的文档。返回：无。4.3.3.1继承无。4.3.3.2属性6无。4.3.3.3方法说明：创建几个主要组件之一。参数：type为组件类型名，参见appType的定义。说明：定位几个主要组件的其中一个。参数：type为需要定位的组件类型名，参见appType的定义。4.4图形相关接口模块uof_shape定义与图像相关的接口，如点、线、框等常用图形4.4.1.1继承无。4.4.1.2属性说明：点的Y坐标。无。4.4.2点集合IPointSet4.4.2.1继承uof_base::IContaine4.4.2.2属性无。4.4.3边框IBox74.4.3.1继承4.4.3.2属性说明：边框的左上角位置。说明：边框的高度。说明：边框的宽度。4.4.3.3方法无。4.4.4自选图形的基础接口IShape4.4.4.1继承4.4.4.2属性说明：控制点。说明：图形，如“圆”、“矩形”等等。名称：name说明：图形的名称。说明：生成图形的软件名称与版本。说明：图形的边框。名称：keyPoints1)带文字的图形使用uof_text::TShape8定义：attributeI说明：线式样(包括颜色、线型、虚实、粗细等)。定义：attributeIArrowStylee9定义：attributeSVGEl说明：激活指定的shape对象。4.4.5图表接口IChart4.4.5.1继承4.4.5.2属性定义：attributeDOMStringc无。4.4.6图表集合IChartSet4.4.6.1继承4.4.6.2属性无。4.5格式相关接口模块(uof_format)定义与通用格式相关的接口，如线型、填充、渐变、颜色、线和边框式样、字体、句和段落式样、4.5.1式样基础接口IStyleBase4.5.1.1继承无。4.5.1.2属性定义：attributeIStyleB说明：红色成分。说明：绿色成分。说明：蓝色成分。说明：α通道。说明：线型。为枚举类型，取值可为：说明：线宽度。说明：颜色。说明：长度。定义：attributebooleanisWithShadow说明：是否有阴影。4.5.3.3方法4.5.4箭头式样IArrowStyle4.5.4.1继承4.5.4.2属性名称：style说明：箭头种类。说明：箭头大小。4.5.5边框式样IBorderStyle4.5.5.1继承4.5.5.2属性说明：上边线。说明：下边线。定义：attributeILineStyl说明：左边线。说明：右边线。定义：attributeILineStyleTL2BR说明：左上至右下对角线。定义：attributeILineStyleTR2BL说明：右上至左下对角线。4.5.5.3方法4.5.6边距IMargin4.5.6.1继承4.5.6.2属性名称：top说明：上边距。名称：bottom说明：下边距。说明：右边距。4.5.6.3方法4.4.7字体IFontStyle4.4.7.1继承4.4.7.2属性说明：字号。名称：familyName定义：attributeDOMStringfamilyName说明：字体族。4.4.7.3方法4.5.8字体集iFontStyleSet4.5.8.1继承Uof_base::IContainer,uof_base::IE4.5.8.2属性4.5.8.3方法IFontStylegetFontByID(inDOMStringidentifier)IFontStylegetFontByN4.5.9超级链接IHyperlink4.5.9.1继承4.5.9.2属性定义：attributeDOMString定义：attributeDOMString4.5.10链接集IHyperlinkSet4.5.10.1继承IStyleBase,uof_base::4.5.10.2属性4.5.10.3方法IHyperlinkgetHyperlink(inDOM4.5.11自动编号式样IAutoNumStyle4.5.11.1继承IStyleBase,uof_base::4.5.11.2属性定义：attributeNumberS4.5.12自动编号式样集IAutoNumStyleSet4.5.12.1继承4.5.12.2属性4.5.12.3方法IAutoNumStylegetAutoNumStyleByID(inDOMStringidentifier)IAutoNumStylegetAutoNumStyleBy4.5.13字下划线式样IUnderlineStyle4.5.13.1继承4.5.13.2属性4.5.14着重号式样IEmphasisStyle4.5.14.1继承4.5.14.2属性4.5.15.1继承IStyleBase,uof_base:4.5.15.2属性：定义：attributeIColor定义：attributeIUnderlineStyleunde定义：attributeIEmp说明：字符对齐网格。4.5.15.3方法4.5.16句式样集ITextRunStyleSet4.5.16.1继承4.5.16.2属性4.5.16.3方法ITextRunStylegetTextRunStyleByID(inDOMStringideITextRunStylegetTextRunStyleByName(inDOM4.5.17段落式样IParagraphStyle4.5.17.1继承IStyleBase,uof_base:4.5.17.2属性定义：attributeDOMStringtextAlignment定义：attributefloatbeforeSpacing定义：attributeIAutoNumStyleau定义：attributeunsignedshor定义：attributebooleanisSamePageWithNext定义：attributeboolean定义：attributeIBorderStyle定义：attributebooleanisSuppress定义：attributeboo定义：attributeboolean定义：attributebooleanisAllowKazakhSyllableBreak定义：attributebooleani定义：attributebo定义：attributeboolean名称：isWestUighurChar定义：attributebooleanisWestUighur定义：attributebooleanisWestKazakhCharAu4.5.18段落式样集IParagraphStyleSet4.5.18.1继承4.5.18.2属性4.5.18.3方法IParagraphStylegetParagraphStyleByID(inIParagraphStylegetParagraphStyleByName(inDOMString4.5.19文字表式样ITextTableStyle4.5.19.1继承IStyleBase,uof_base:4.5.19.2属性定义：attributeIMargint名称：cellMargin名称：isAutoFit定义：attributeboolean定义：attributefloatcellSpac定义：attributeunsi定义：attributebooleanrowsCount4.5.20文字表式样集ITextTableStyleSet4.5.20.1继承4.5.20.2属性4.5.20.3方法ITextTableStylegetTextTableStyleByID(inITextTableStylegetTextTableStyleByName(inDOMStringname)4.5.21单元格式样ITextTabl4.5.21.1继承IStyleBase,uof_base:4.5.21.2属性说明：包含指定单元格的表格列数。说明：包含指定单元格的表格行数。4.5.21.3方法4.5.22单元格式样集ITextTableCelIStyleSet4.5.22.1继承4.5.22.1属性4.5.22.3方法ITextTableCel1StylegetTextTableCel1StyleB参数：identifier为单元格式样的标识符。ITextTableCellStylegetTextTableCellStyleByName(in说明：根据名称获得单元格式样。4.5.23.1继承4.5.23.2属性定义：attributeIAutoNum说明：自动编号集。定义：attributeITextRunStyleSet说明：段落式样集。定义：attributeITextTableSt说明：文字表式样集。说明：单元格式样集。4.5.24填充式样基础接口1FilIStyle说明：填充式样名称。说明：填充颜色。说明：填充类型。为枚举值，取值可为：NONE无填充说明：种子X-位置。说明：种子Y-位置。4.5.26纹理填充IPictureFiHIStyle4.5.26.1继承4.5.26.2属性4.5.27图案填充IHatchFilIStyle4.5.27.1继承4.5.27.2属性4.5.27.3方法4.5.28修订显示式样ITrackChangeStyle4.5.28.1继承4.5.28.2属性DB65/T3937—2定义：attributeunsignedshortdeletedTextMarkTy定义：attributeIColorchangedTextMarkCol定义：attributeunsignedshortcha定义：attributeIColorins4.5.28.3方法4.6文档通用处理接口模块(uof_doc)式样集、式样、用户等文档属性。4.6.1基本区域IRange用于选取一个文档的部分。一般应使用uof_text中定义的IRange。4.6.1.1继承4.6.1.2属性定义：readonlyattribut4.6.1.3方法4.6.2书签IBookmark4.6.2.1继承4.6.2.2属性说明：名称(ID类型)。说明：区域引用(用于文本)。说明：区域(用于电子表格)。4.6.2.3方法4.6.3书签集IBookmarkSet4.6.3.1继承4.6.3.2属性4.6.3.3方法4.6.4对象集10bjSet4.6.4.1继承uof_base::IContainer,uof_base::IEl4.6.4.2属性4.6.4.3方法4.6.5.1继承DB65/T3937—20164.6.5.2属性名称：path说明：文件路径。名称：name说明：文档名称。说明：标题。名称：subject说明：主题。说明：创建者。说明：作者。说明：最后作者。说明：摘要。说明：创建日期。名称：editTimes说明：编辑次数。说明：编辑时间。名称：createApplication定义：readonlyattributeDOMStringcreateApplication说明：创建应用程序。说明：分类。名称：model说明：文档模板。名称：keywords定义：attributeDOMStringListkey说明：关键字集。定义：attributeDOMStringListuserdefined说明：用户自定义元数据集。定义：attributeDOMStringcompanyName说明：公司名称。名称：manager说明：经理名称。名称：pages定义：readonlyattributeDOMStringpages说明：页数。定义：readonlyattributeDOMStringnumOfWords说明：字数。名称：numOfWestChars定义：readonlyattributeDOMStringnumOfWestChars说明：英文字符数。定义：readonlyattributeDOMStringnumOfChineseChars说明：中文字符数。定义：readonlyattributeDOMStringnumOfUighurChars说明：维吾尔文字符数。定义：readonlyattributeDMStringnumOfKazakhChars说明：哈萨克文字符数。名称：numOfLines定义：readonlyattributeDOMStringnumOfLines说明：行数。定义：readonlyattributeDOMStringnumOfParagraphs定义：readonlyattributeDOMStringnumOfObjs定义：attributeIBookmarkSetbookmarks说明：书签集(spreadsheet中不用)。定义：attributeIHyperlinkSethyperlinks4.6.5.3方法voidsave(inDOMStringurl)raises(uof_err::UOFException)参数：url为文档标识。voidsaveAs(inD0MStringurl)raises(uof_err::UOFException)说明：文档“另存为”。参数：url为文档标识。DB65/T3937--2016返回：无。说明：打印文档参数：无。返回：无。说明：文档是否为当前文档。参数：无。返回：如为true则是当前文档，否则不是。4.6.6文档集合IDocumentSet4.6.6.1继承4.6.6.2属性4.6.6.3方法说明：获得文档集合中的文档数。参数：无。返回：文档的数目。IDocumentgetDocumentByIndex(inunsignedlonginde说明：通过序号获得文档。参数：index为索引号。返回：文档对象。IDocumentgetDocumentByName(in说明：通过名称获得文档。参数：name为文档名称。返回：文档对象。voidcloseDocuments()说明：关闭所有文档。参数：无。返回：无。voidsaveDocuments()raises(uof_err::UOFException)说明：保存所有文档。参数：无。返回：无。voidaddDocument(inIDocumentducument)说明：添加文档到集合中。4.7字处理相关的接口模块(uof_text)定义与文字处理相关的接口，如获得指定的章节、插入(删除)文字，格式化字体，格式化段落4.7.1文字处理应用1TextApp4.7.1.1继承4.7.1.2属性4.7.1.3方法4.7.2.2属性定义：attributebo说明：是否全屏显示。4.7.3带文字的区域IRange4.7.3.2属性DB65/T3937--20164.7.3.3方法说明：复制一个文字区域。参数：无。返回：区域对象。说明：剪切。参数：无。返回：无。说明：粘贴。参数：无。返回：无。voidsetParagraphStyle(inIParagraphStylepStyle)说明：设置缺省段落式样。参数：pStyle为段落式样。返回：无。voidsetTextRunStyle(inITextRunStyletrStyle)说明：设置缺省句式样。参数：trStyle为句式样。返回：无。booleanclearFormat()raises(uof_err::UOFException)说明：清除格式。参数：无。返回：成功返回true;失败返回false。booleandelete()raises(uof_err::UOFExc说明：清除内容。参数：无。返回：成功返回true;失败返回false。voidinsertComment(inDOMStringcomment)raises(uof_err:说明：插入批注。参数：comment为插入的批注。返回：无。voidsetHyperLink(inIHyperLinklink)raises(uof_err::UOFExceptio说明：设置超链接。参数：link为超级链接对象。返回：无。voidinsertBookmark(inIBookmarkbookmark)raises(uof_err::UOFException)说明：插入书签。参数：bookmark为插入的书签。返回：无。voidgetFirstStyle(outITextRunStyletrSty说明：获得首式样(用于格式刷)。参数：trStyle为获得的句式样；pStyle为获得的段落式样。返回：无。voidinsertTextRun(inITextRuntextRun)raises说明：插入文字。参数：textRun为插入的文字。返回：无。voidinsertTable(inITextTabletable)raises(uof_err::UOFExcep说明：插入表格。参数：table为插入的表格。返回：无。ITextTablegetTableAfterParagraph(in说明：得到特定段落之后的表格。参数：offset为指定段落的偏移量。返回：文字表对象。ITextTablegetTableBeforeParagraph(in说明：得到特定段落之前的表格。参数：offset为指定段落的偏移量。返回：文字表对象。voiddeleteTableAfterParagraph(inunsignedlongoffset)raises(uof_err::UOFExcept说明：删除特定段落之后的表格。参数：offset为指定段落的偏移量。返回：无。voiddeleteTableBeforeParagraph(inunsignedlonraises(uof_err::UOFExcept说明：删除特定段落之前的表格。参数：offset为指定段落的偏移量。返回：无。4.7.4.2属性说明：层次，例如：第1.2.3.4节，则为“1234”。4.7.5所有内容的基础接口IContentBase4.7.5.1继承4.7.5.2属性定义：attributeunsignedlongc说明：获取上一层的内容，例如本段所属的节。参数：无。返回：内容对象。说明：获得前面出现的兄弟内容，例如本段前的段。返回：内容对象。IContentBaseSetgetSiblingsAfter()说明：获得后面出现的兄弟内容，例如本段后的段。参数：无。返回：内容对象。IContentBasegetChild(inunsigned说明：获得特定位置的下一层的内容，例如本节下面的某一段落。参数：index为下一层的内容的位置。返回：内容对象。IContentBaseSet说明：获得下一层的所有内容，例如本节下面的所有段落。参数：无。返回：内容对象。IContentBaseinsertChild(inIContentBasecontent,inunsignedlonraises(uof_err::UOFExcept说明：插入特定位置的下一层的内容，例如本节下面的某一段落。参数：content为插入的内容；index为插入位置。返回：内容对象。IContentBaseappendChild(inIContentBasecontent)raises(uof_err::UOFException)说明：添加下一层的内容，例如在本节最后添加某一段落。参数：content为添加的内容。返回：内容对象。voiddeleteChild(inunsignedlongindex)raises(uof_err:说明：删除特定位置的下一层的内容，例如本节下面的某一段落。参数：index为下层内容的位置。返回：无。voiddeleteChildren()raises(uof_err::UOFException)说明：删除下一层的所有内容，例如本节下面的所有段落。参数：无。返回：无。说明：定位本部分内容起始位置对应的逻辑章节。参数：无。4.7.6基内容集合IContentBaseS4.7.6.1继承4.7.6.2属性4.7.6.3方法4.7.7.2属性4.7.8.2属性4.7.8.3方法4.7.9.1继承4.7.9.2属性说明：编号方式(连续编号、节编号、页编号等4.7.10.1继承4.7.10.2属性说明：编号方式(连续编号、节编号、页编号)。4.7.11.1继承4.7.11.2属性4.7.12.2属性4.7.13网格设置IGridSetting4.7.13.1继承4.7.13.2属性4.7.14.1继承4.7.14.2属性：4.7.14.3方法4.7.15.1继承4.7.15.2属性4.7.15.3方法4.7.16分栏设置IColumnSetting4.7.16.2属性无4.7.17边框IBorder4.7.17.1继承4.7.17.2属性4.7.17.3方法4.7.18页面设置IPageSetting4.7.18.1继承4.7.18.2属性名称：isOddEvenDiff定义：attributefloa定义：attributebooleanDB65/T3937—2016说明：尾注设置。定义：attributeIPageNumber说明：页码设置。说明：行号设置。说明：网格设置。说明：垂直对齐方式。说明：文字排列方向。说明：分栏设置。4.7.19节ISection4.7.19.2属性说明：节类型。为枚举类型，取值可为：说明：首页页眉。4.7.19.3方法4.7.20.1继承4.7.21.1继承说明：段落式样(引用式样)。说明：段落属性(实际式样)。4.7.22.1继承4.7.23句ITextRun说明：句式样(引用式样)。说明：句属性(实际式样)。4.7.23.3方法4.7.24句子集合ITextRuns4.7.24.1继承4.7.24.2属性4.7.24.3方法4.7.25文字表单元格ITextTableCell4.7.25.1继承uof_base::IContentB4.7.25.2属性定义：attributeITextTableCe说明：单元格式样。5.voidSplit(inunsignedlongnumRows,inu4.7.26文字表单元格区域ITextTableCellRange4.7.26.1继承4.7.26.2属性说明：起始行。说明：起始列。名称：endRow说明：结束行。名称：endColumn说明：结束列。4.7.26.3方法4.7.27.1继承uof_base::IContentB4.7.27.2属性名称：tableStyle定义attributeITextTableStyletableStyle说明：文字表式样(引用式样)。定义attributeITextTableStyletableProperty说明：文字表属性(实际式样)。名称：isRepeatHeader定义：attributebooloeani说明：是否表头重复。4.7.27.3方法ITextTableCellgetTextTableCell(inunsignedlongrow,inun说明：获得单元格。参数：row为单元格所在行；column为单元格所在列。返回：单元格对象。voidmerge(inunsignedlongstartRow,iinunsignedlongendRow,inunsignraises(uof_err::UOFExcept说明：合并单元格。startColumn为开始列；endColumn为结束列。返回：无。voidsplit(inbooleanisMerge,inunsignedlongrows,inunsignedlinunsignedlongstainunsignedlongendRow,inunsignedlongendColumn)raise说明：拆分单元格。isMerge为是否先合并再拆分；返回：无。voidinsertRowBefore(inlongrow,inraises(uof_err::UOFExcept说明：在指定行前插入行。参数：row为插入行的前一行位置；cells为要插入的单元格区域。返回：无。voidinsertRowAfter(inlongrow,inITextTableCel1Ranraises(uof_err::UOFExcept说明：在指定行后插入行。参数：row为插入行的后一行位置：cells为要插入的单元格区域。返回：无。voidinsertColumnBefore(inlongcolumn,inITextTableCraises(uof_err::UOFExcept说明：在指定列前插入列。参数：column为插入列的前一列位置；cells为要插入的单元格区域。返回：无。voidinsertColumnAfter(inlongcolumn,inITextTableCellRanraises(uof_err::UOFExcept说明：在指定列后插入列。参数：column为插入列的后一列位置；cells为要插入的单元格区域。返回：无。voiddeleteRow(inlongrow)raises(uof_err::UOFException)说明：删除行。参数：row为删除的行号。返回：无。voiddeleteCol(inlongcolumn)raises(uof_err::UOFException)返回：无。voiddeleteCell(inlongrow,inlongc返回：无。4.7.28表格集合ITextTableSet4.7.28.1继承4.7.28.2属性4.7.28.3方法4.7.29带文字的图形IShape4.7.29.1继承uof_shape::IShape,IContent4.7.29.2属性4.7.30.1继承4.7.30.2属性4.7.30.3方法4.7.31.2属性4.7.31.3方法IStyleSetge说明：获得文档中的式样表(集合)。4.8电子表格处理相关的接口模块(uof_spreadsheet)定义与电子表格处理相关的接口，如：工作表、单元格、单元格区域、数据有效性条件等接口。4.B.1.1继承4.8.1.2属性4.8.1.3方法4.8.2单元格内容ICe!Data单元格内容接口，该接口封装了单元格中的内容，用于对单元格内容的操4.8.2.1继承4.8.2.2属性4.8.3数据有效性条件IValidCondition4.8.3.1继承4.8.3.2属性定义：attributeboolean定义：attributeDOMStringinputTitle名称：inputMessage定义：attributeDOMStringin名称：errorMessage定义：attributeDOMStringerrorMessage名称：isShowInput定义：attributebooleanisShowInput名称：isShowError定义：attributeboolean说明：当输入内容不符合校验时，是否弹出警告对话框。4.8.4单元格ICell4.8.4.1继承4.8.4.2属性定义：attributeIValidConditionvoidclear(inCel1ClearTypetype)4.8.5.1继承4.8.5.2属性4.8.5.3方法voidsetBorderStyle(inIBorderStyleborderStyle)voidsetFil1Style(inIFillStylefill1StyvoidsetFontStyle(inIFontStylefoICellgetCellByAddress(inDOMStringaddrICellgetCellByRC(inunsignedlonraises(uof_err::UOFExcep4.8.6筛选条件信息IFilt4.8.6.1继承4.8.6.2属性定义：attributeDOMString定义：attributeDOMString定义：attributebooleanisRe4.8.7单元格名称IName4.8.7.1继承4.8.7.2属性说明：名称对应的单元格(或单元格区域)的地址。4.8.8单元格名称集合INameSet单元格的名称集合，该接口封装了名称(IName)的集合。4.8.8.1继承4.8.8.2属性4.8.8.3方法工作簿接口，该接口封装了工作簿的一些属性和操作，如插入/删除单元格、插入图表和图片等。4.8.9.1继承4.8.9.2属性4.8.9.3方法ICel1RangegetRangeByAICel1RangegetRangeByRC(inunsignedlongstinunsignedlongendRow,inunsignedlong说明：通过行列获得指定的区域。startRow为指定区域的起始行号；startColumn为指定区域的起始列号；endRow为指定区域的中止行号；endColumn为指定区域的中止列号。返回：区域对象。ICellgetCel1ByAddress(inDOMStringaddress说明：通过地址获得指定的单元格。参数：address指定单元格的地址。返回：单元格对象。ICellgetCel1ByRC(inunsignedlongrow,inuraises(uof_err::UOFExcept说明：通过行列获得指定的单元格。row为单元格的行号；column为单元格的列号。返回：单元格对象。说明：获得工作簿中的自选图形集合。参数：无。返回：工作簿中的自选图形集合。说明：获得工作簿中的图表集合。参数：无。返回：工作簿中的图表集合。voidinsertCell(inunraises(uof_err::UOFExcept说明：在工作簿的指定行列插入单元格。row为插入单元格的行号；column为插入单元格的列号。返回：无。raises(uof_err::UOFExcept说明：删除工作簿指定行列的单元格。voidinsertRow(inunsignedlongindex)raises(uvoiddeleteRow(inunsignedlongindex)raises(uof_err:UOFException)voidinsertColumn(inunsignedlongindex)raises(uof_err::UOFException)voiddeleteColumn(inunsignedlongindex)raises(uof_er4.8.10.1继承4.8.10.2属性4.8.10.3方法4.8.11电子表格处理文档ISpreadsheetDoc电子表格处理文档接口，该接口封装了对电子表格文档的一些操作，如添加4.8.11.1继承4.8.11.2属性4.8.11.3方法IStyleSetgeIWorksheetSetgetWorksheets()IWorksheetgetWorksheet(inDOMvoidappendWorksheetvoidremoveWorksheet(inDOMStringname)IWorksheetinsertWorksheet(inD0MStringname,inunsignedraises(uof_err::UOFExcep4.9演示文稿处理相关的接口模块(uof_presentation)定义与演示文稿处理相关的接口，如插入(删除)幻灯片，放映等。4.9.1.1继承4.9.1.2属性4.9.1.3方法4.9.2配色方案IColorScheme4.9.2.1继承4.9.2.2属性说明：标识符。说明：名称。名称：background定义：attributeIColorbackground说明：背景色。说明：文本、线条颜色。名称：shadow说明：阴影颜色。说明：标题颜色。说明：填充颜色。说明：强调色。说明：超级链接色。4.9.3配色方案集合IColorSchemeSet4.9.3.1继承4.9.3.2属性4.9.3.3方法4.9.4幻灯片切换1Transition4.9.4.1继承4.9.4.2属性4.9.5幻灯片ISlide4.9.5.1继承4.9.5.2属性名称：colorScheme定义：attributeDOMStringcolorScheme说明：配色方案。名称：layout说明：布局。说明：备注。名称：isShow说明：是否显示。名称：showDuration说明：放映时间。说明：幻灯片切换效果。4.9.5.3方法说明：获得幻灯片中的自选图形集合。参数：无。返回：图形集合。说明：获得幻灯片中的自选图表集合。参数：无。返回：图表集合。voidinsertTextTable(inunsignedlongrow,inunsignedlongcoluraises(uof_err::UOFExcept说明：插入表格。参数：row为表格的行数，column为表格的列数。返回：无。ITextTables说明：获取所有表格。参数：无。返回：表格集合。DB65/T3937—20164.9.6幻灯片集合接口ISlideSet4.9.6.2属性voidsetMaster(inD0MStringdefaultMaster)raises(uof_err::UOFException)说明：设置缺省母版。参数：defaultMaster为默认母板。返回：无。voidsetColorScheme(inDOMStringcolorScheme)r说明：设置缺省配色方案。参数：colorScheme为默认配色方案。返回：无。voidsetTransition(inITransitiontrans)raises(uof_err::UOFException)说明：设置幻灯片集切换效果。参数：trans为默认切换效果。返回：无。4.9.7幻灯片放映设置ISHideShowSetting4.9.7.2属性说明：是否全屏放映。定义：attributebooleanisRepeatShow说明：是否循环放映。定义：attributebooleanisShowBG说明：是否播放背景音乐。说明：放映间隔。名称：isManually定义：attributeboo4.9.8演示文稿处理文档IPresentationDoc4.9.8.1继承4.9.8.2属性4.9.8.3方法返回：幻灯片集合。说明：获得所有母版。参数：无。返回：母板名列表。说明：获得缺省母版。参数：无。返回：母板名。voidsetDefaultMaster(inDOMString说明：设置缺省母版。参数：defMaster为缺省母版名。返回：无。DOMStringListgetColorSchemes()说明：获得所有配色方案。参数：无。返回：配色方案列表。0MStringgetDefaultCol说明：获得缺省配色方案。参数：无。返回：默认的配色方案。voidsetDefaultColorScheme(inDOMStringdefClrScheme)说明：设置缺省配色方案。参数：defClrScheme为配色方案名。返回：无。4.10存储管理接口模块(uof_pack)定义与UOF文档物理存储相关的接口，如文档的压缩/解压、查询打包信息、获取文件片断、维护打包内容和事件回调等。4.10.1数据类型定义定义为：typedefsequence<string>StringList;4.10.1.2同名文件处理方式NameCollisionMode为枚举类型，取值可为：OVERRIDE存储时覆盖同名文件NO_0VERRIDE存储时如果存在同名文件则不存储该文件CHANGE_FILE_NAME将后存储的文件自动更名PROMPT_USER提示用户(此时通过回调接口提示用户)4.10.1.3路径存储方式PathSaveMode为枚举类型，取值可为：4.10.1.5正在进行的操作类型OperationType4.10.1.6包初始化方式PacklnitModeOPEN_PACK打开一个已经存在的UOF包4.10.2解包时的参数设置IUnpackSetting4.10.2.1继承4.10.2.2属性定义：attributeb示将文件解包到同一个目录下(不保持原来的目录结构)。定义：attributeNameCo4.10.2.3方法4.10.3打包(压缩》时参数设置IPackSetting4.10.3.2属性4.10.4.2属性无。4.10.4.3方法unsignedlonggetOriginalSize()说明：获取文件的原始大小。参数：无。返回：文件原始大小。unsignedlonggetCompress说明：获取文件压缩(打包)后的大小。参数：无。返回：文件压缩(打包)后的大小。说明：获取文件名。参数：无。返回：文件名。说明：获取文件的注释。参数：无。返回：文件的注释。4.10.5将要操作的文件列表IFilesToProcess4.10.5.1继承无。4.10.5.2属性无。4.10.5.3方法longaddFileIntoList(instringurl,inEFileType说明：将需要打包的文件形成一个列表。url为需要打包的文件名。如果不是合法文件，打包模块回产生一个错误，打包模块不负债验证文件的合法性；fileType为需要打包的文件的类型(该参数只有在接口用于压缩时有效),参见FileType类型的定义；comment为需要打包的文件的注释(该参数只有在接口用于压缩时有效);返回：0表示成功，非0表示失败，具体值代表了错误类型。longdeleteFileFromList(inst说明：从需要打包的文件列表中删除一个文件(即执行了该操作后，该文件不会包含在打包后的文件中)。返回：0表示成功，非0表示失败，具体值代表了错误类型。4.10.6回调函数参数ICallbackData4.10.6.1继承4.10.6.2属性定义：readonlyattributestringcu定义：readonlyattributeunsignedlongallCompressedS定义：readonlyattributeunsignedlongcurrentFileSize定义：readonlyattribute定义：readonlyattributeunsignedlong4.10.6.3方法4.10.7回调接口ICalIBack4.10.7.1继承4.10.7.2属性4.10.7.3方法longcallbackFunction(inICallbackDat返回：如正常显示进度返回0,非0为用户应答值。4.10.8压缩应用IPackApp4.10.8.1继承4.10.8.2属性4.10.8.3方法inIPackSettingpackSetti说明：向UOF包中添加文件(使用该函数的前提条件是该接口已经初始化)。返回：0表示成功，非0表示失败，具体值代表了错误码。longaddFilesToPack(inDOMStringxmlToPack,inDOMStringuserXmlTinStringListexternalFilesToPacinDOMStringcomment,inICallbackcallba说明：向UOF包中添加文件(使用该函数的前提条件是该接口已经初始化)。userXmlToPack为需要添加到UOF包中的用户XML文件；返回：0表示成功，非0表示失败，具体值代表了错误码。longdeleteFileListFromPack(inIFilesToProcesslist,inbooleani返回：0表示成功，非0表示失败，具体值代表了错误码。longdeleteFilesFromPack(inbooleanisDelXml,inbooleanisDelUserXminStringListexternalFilesToDel,inbooleanisD返回：0表示成功，非0表示失败，具体值代表了错误码。longunpackFileList(inIFilesToProcesslist,inIUnpackSettingunpackSetting,返回：0表示成功，非0表示失败，具体值代表了错误码。longunpackFiles(inStringListfiles,inIUnpackSettingunpackSet说明：从UOF包中获取一个或者多个文件。返回：0表示成功，非0表示失败，具体值代表了错误码。longgetXml(inoutstringur1,outunsignedlonginICal1Backcallurl为解压路径，返回时表示XML文档存储的实际路径(全路径);返回：0表示成功，非0表示失败，具体值代表了错误码。longgetUserXinl(inoutstringurl,outunsigoutunsignedlongendPos,inICal1Backcal1url为解压路径，返回时表示XML文档存储的实际路径(全路径);返回：0表示成功，非0表示失败，具体值代表了错误码。IFileInfolocateFirsXML文件节点(如果有的话)。IFileInfonextFile返回：如果存在下一个节点则返回这个节点，如果不存在则返回NULL。IFileInfogetX返回：如果不存在UOFXML文件返回NULL,如果存在则返回该节点。IFileInfogetUserXmlFileInflonginit(inDOMStringurl,inPackInitModeinitMode,inb参数：url为UOF包的绝对路径名；initMode为初始化包的方式；不提示用户直接操作；callback为回调接口。返回：0表示成功，非0表示失败，具体值代表了错误码。4.11异常模块(uof_err)说明：越界。定义：constunsignedlong说明：非法参数。说明：无效的文件路径。定义：constunsignedlong说明：访问被拒绝。定义：constunsignedlongOUT说明：空间不足。定义：constunsignedlongUNKNOWN说明：未知错误。//数据类型定义typedefdom::DOMStringDOMString;typedefdom::DOMStringListDOMStringList;typedefdom::ElementElement;//本模块定义的接口//基本容器接口//容器单元数量readonlyattributeunsignedlongc//清空容器//初始化，加入一个单元anyinitialize(inanynewI//获取单元anygetItemByIndex(inunsignedlongindbooleanremoveItem(inunsignedlongindex)raises(uof_err::UOFException);anyappendItem(inanynreadonlyattributeDOMStringlocID;//应用相关接口//数据类型定义typedefuof_doc::IDocumentIDocument;typedefuof_doc::IDocumentSetIDocumentSet;interfaceIApplicatio//组件标识//文字处理//电子表格处理//演示文稿处理//假定字处理、表处理和演示文稿处理等同属一个桌面应用//主要组件在一个桌面应用中各自只能启动一个(即不能同时出现两个字处理组件)//组件各自能够打开多个文档(Document)//应用接口的基接口interfaceIAppBase:DOMImplementation{//区别组件的名称readonlyattributeDOMStringname;//区别组件的类型标识//createDocument()在XMLDOM中己定义，此处不再定义IDocumentopenDocument(inDOMStringurl)raises(uof_err::UOvoidsaveDocument(inDOMStringurl)raises(uof_err::UOFException);voidsaveAsDocument(inDOMStringurl)raises(uof_err::UOFExce//物理删除文档，部分应用支持此功能booleandeleteDocunent()raises(uof_err::UOFException);//获得该应用的所有文档IDocumentSetgetDocuments();//获得当前文档IDocumentgetActiveDoc//将文档置成当前文档voidactivateDocument(inIDocum//关闭组件，需要分别关闭所有文档//桌面应用接口//创建主要组件之一。//定位主要