如何在 OpenOffice.org 中获取对象

From Apache OpenOffice Wiki
Jump to: navigation, search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.




我们的上下文中的对象是一个软件工件,具有您可调用的方法。使用 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