如何在 OpenOffice.org 中获取对象

From Apache OpenOffice Wiki
Jump to: navigation, search




我们的上下文中的对象是一个软件工件,具有您可调用的方法。使用 OpenOffice.org 完成某些操作时需要对象。但从哪里获得这些对象呢?


新对象

通常情况下,新对象或第一次访问所需的对象是由 StarSuite 中的服务管理器创建的。在 FirstLoadComponent 示例中,远程服务管理器创建远程 Desktop 对象,该对象用于处理 OpenOffice.org 中的应用程序窗口和已加载的文档:

  Object desktop = xRemoteServiceManager.createInstanceWithContext(
                   "com.sun.star.frame.Desktop", xRemoteContext);


文档对象

文档对象是指使用 OpenOffice.org 打开的文件。它们由 Desktop 对象的 loadComponentFromURL() 方法所创建。


由其他对象提供的对象

对象可以分发其他对象。这分为两种情况:

  • 有些属性被设计为是提供该属性的对象的完整部分,这种属性可以通过 OpenOffice.org API 中的 get 方法来获得。从 get 方法获得对象是很普遍的。例如,getSheets() 是每个 Calc 文档所必需的,getText() 是每个 Writer 文档所必需的,而 getDrawpages() 是每个 Draw 文档所必需的。加载文档后,这些方法用于获得相应文档的 Sheets、Text 和 Drawpages 对象。对象专用的 get 方法对于获得对象是一项重要的技术。
  • 未作为对象体系结构的组成部分的功能通过一组通用方法来访问。在 OpenOffice.org API 中,这些功能称为属性,可以使用一般方法,例如 getPropertyValue(String propertyName),来访问这些功能。在某些情况下,将作为对象提供此类非组成部分的功能,因此方法 getPropertyValue() 可以是对象的另一个源。例如,电子表格文档的页面样式具有 "RightPageHeaderContent" 和 "LeftPageHeaderContent" 属性,这些属性中含有电子表格文档页眉区域的对象。一般的 getPropertyValue() 方法有时可以提供您所需的对象。


对象集

对象可以是相似对象集中的元素。在对象集中,要访问某个对象,必须知道如何从对象集中获得 特定元素OpenOffice.org API 允许通过四种途径提供对象集中的元素。前三种途径都是通过带有元素 访问方法(这些方法允许按名称、索引或枚举进行访问)的对象。第四种途径是通过不带访问方 法但可以直接用作数组的元素序列。稍后将讨论如何使用这些元素集。

对象设计器基于对象的特定条件来确定提供哪一种途径,例如它的远程执行情况如何或哪些访问 方法最适用于实现。

Content on this page is licensed under the Public Documentation License (PDL).
Personal tools
In other languages