OpenOffice.org BASIC Guide - OpenOffice.org wiki

The StarDesktop
The FileProperties array has two elements, one for each option used. The Filtername property defines
whether OpenOffice.org uses a OpenOffice.org Calc text filter to open files. The FilterOptions property
contains the description of the syntax of the csv file.
Creating New Documents
OpenOffice.org automatically creates a new document if the document specified in the URL is a template.
Alternatively, if only an empty document without any adaptation is needed, a private:factory URL can be
specified:
Dim Dummy()
Dim Url As String
Dim Doc As Object
Url = "private:factory/swriter"
Doc = StarDesktop.loadComponentFromURL(Url, "_blank", 0, Dummy())
The call creates an empty OpenOffice.org writer document.
Document Objects
The loadComponentFromURL function introduced in the previous section returns a document object. This
supports the com.sun.star.document.OfficeDocument service, which in turn provides two central interfaces:
The com.sun.star.frame.XStorable interface, which is responsible for saving documents.
The com.sun.star.view.XPrintable interface, which contains the methods for printing documents.
Saving and Exporting Documents
OpenOffice.org documents are saved directly through the document object. The store method of the
com.sun.star.frame.XStorable interface is available for this purpose:
Doc.store()
This call functions provided that the document has already been assigned a memory space. This is not the case for
new documents. In this instance, the storeAsURL method is used. This method is also defined in
com.sun.star.frame.XStorable and can be used to define the location of the document:
Dim URL As String
Dim Dummy()
Url = "file:///C:/test3.odt"
Doc.storeAsURL(URL, Dummy())
In addition to the preceding methods, com.sun.star.frame.XStorable also provides some help methods which are
useful when saving documents. These are:
hasLocation()
specifies whether the document has already been assigned a URL.
isReadonly()
specifies whether a document has read-only protection.
isModified()
specifies whether a document has been modified since it was last saved.
The code for saving a document can be extended by these options so that the document is only saved if the object
has actually been modified and the file name is only queried if it is actually needed:
If (Doc.isModified) Then
If (Doc.hasLocation And (Not Doc.isReadOnly)) Then
Doc.store()
Else
Doc.storeAsURL(URL, Dummy())
Chapter 5 · Working with Documents 63