Difference between revisions of "Documentation/BASIC Guide/UNO Tools"

From Apache OpenOffice Wiki
Jump to: navigation, search
(FINAL VERSION FOR L10N)
Line 42: Line 42:
 
More information about the available services, and their interfaces, methods and properties can be found in the [http://api.openoffice.org/docs/common/ref/com/sun/star/module-ix.html reference for the {{OOo}} API].
 
More information about the available services, and their interfaces, methods and properties can be found in the [http://api.openoffice.org/docs/common/ref/com/sun/star/module-ix.html reference for the {{OOo}} API].
  
 +
{{InterWiki Languages BasicGuide|articletitle=BASIC Guide/UNO Tools}}
 
{{PDL1}}
 
{{PDL1}}

Revision as of 12:07, 20 October 2008


The question remains as to which objects — or services if we are going to remain with UNO terminology — support which properties, methods and interfaces and how these can be determined. In addition to this guide, you can get more information about objects from the following sources: the supportsService method, the debug methods as well as the Developer's Guide, and the API reference.

The supportsService Method

A number of UNO objects support the supportsService method, with which you can establish whether an object supports a particular service. The following call, for example, determines whether the TextElement object supports the com.sun.star.text.Paragraph service.

Ok = TextElement.supportsService("com.sun.star.text.Paragraph")

Debug Properties

Every UNO object in Apache OpenOffice Basic knows what properties, methods and interfaces it already contains. It provides properties that return these in the form of a list. The corresponding properties are:

DBG_properties
returns a string containing all properties of an object
DBG_methods
returns a string containing all methods of an object
DBG_supportedInterfaces
returns a string containing all interfaces which support an object.

The following program code shows how DBG_properties and DBG_methods can be used in real-life applications. It first creates the com.sun.star.frame.Desktop service and then displays the supported properties and methods in message boxes.

Dim Obj As Object
Obj = createUnoService("com.sun.star.frame.Desktop")
 
MsgBox Obj.DBG_Properties
MsgBox Obj.DBG_methods

When using DBG_properties, note that the function returns all properties that one particular service can theoretically support. No assurances are, however, provided for whether these can also be used by the object in question. Before calling up properties, you must therefore use the IsEmpty function to check whether this is actually available.

API Reference

More information about the available services, and their interfaces, methods and properties can be found in the reference for the Apache OpenOffice API.


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