Sancho at 17:04, 2 September 2011

2011-09-02T17:04:56Z

Sancho: Основной текст

2011-09-02T11:20:31Z

Основной текст

New page

<section begin=title /><noinclude>{{DISPLAYTITLE:</noinclude>Universal Network Objects (UNO)<noinclude>}}</noinclude><section end=title />{{BreadCrumbL10n}}

{{Documentation/BASICGuideTOC
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=EN/documentation/basic_guide/api_intro
|NextPage=EN/documentation/basic_guide/properties_and_methods_(api)
|api=block
}}

{{OOo}} provides a programming interface in the form of the Universal Network Objects (UNO). This is an object-oriented programming interface which {{OOo}} sub-divides into various objects which for their part ensure program-controlled access to the Office package.

Since {{OOo}} Basic is a procedural programming language, several linguistic constructs have had to be added to it which enable the use of UNO.

To use a Universal Network Object in {{OOo}} Basic, you will need a variable declaration for the associated object. The declaration is made using the <tt>Dim</tt> instruction (see [[EN/documentation/basic_guide/language|The Language of {{OOo}} Basic]]). The <tt>Object</tt> type designation should be used to declare an object variable:

<source lang="oobas">
Dim Obj As Object
</source>

The call declares an object variable named <tt>Obj</tt>.

The object variable created must then be initialized so that it can be used. This can be done using the <tt>createUnoService</tt> function:

<source lang="oobas">
Obj = createUnoService("com.sun.star.frame.Desktop")
</source>

This call assigns to the <tt>Obj</tt> variable a reference to the newly created object. <tt>com.sun.star.frame.Desktop</tt> resembles an object type; however in UNO terminology it is called a service rather than a type. In accordance with UNO philosophy, an Obj is described as a reference to an object which supports the <idl>com.sun.star.frame.Desktop</idl> service. The service term used in {{OOo}} Basic therefore corresponds to the type and class terms used in other programming languages.

There is, however, one main difference: a Universal Network Object may support several services at the same time. Some UNO services in turn support other services so that, through one object, you are provided with a whole range of services. For example, that the aforementioned object, which is based on the <idl>com.sun.star.frame.Desktop</idl> service, can also include other services for loading documents and for ending the program.

{{VBAnote|Whereas the structure of an object in VBA is defined by the class to which it belongs, in {{OOo}} Basic the structure is defined through the services which it supports. A VBA object is always assigned to precisely one single class. A {{OOo}} Basic object can, however, support several services.}}

{{PDL1}}

@@ Line 5: / Line 5: @@
 |ShowPrevPage=block
 |PrevPage=EN/documentation/basic_guide/api_intro
-|NextPage=EN/documentation/basic_guide/properties_and_methods_(api)
+|NextPage=EN/documentation/basic_guide/properties_and_methods_api
 |api=block
 }}

EN/documentation/basic guide/uno - Revision history

Sancho at 17:04, 2 September 2011

Sancho: Основной текст