(incubating) | The Free and Open Productivity Suite

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.
Overview Module Use Devguide Index
Methods' Summary Attributes' Summary Methods' Details Attributes' Details

:: com :: sun :: star :: script ::

unpublished interface XStorageBasedLibraryContainer
Base Interfaces
XStorageBasedLibraryContainer
┗ XPersistentLibraryContainer
   ┣ ::com::sun::star::util::XModifiable
   ┃ ┗ ::com::sun::star::util::XModifyBroadcaster
   ┗ XLibraryContainer2
      ┗ XLibraryContainer
         ┗ ::com::sun::star::container::XNameAccess
            ┗ ::com::sun::star::container::XElementAccess
XPersistentLibraryContainer
(referenced interface's summary:)
describes a container of script libraries which is persistent.
Usage Restrictions
not published
Description
is the interface for an XLibraryContainer which can be made persistent in an ::com::sun::star::embed::XStorage.

A persistent library container is associated with a root storage. The container is responsible for a particular sub storage of the root storage, the container storage.

Since
OOo 2.3
Methods' Summary
storeLibrariesToStorage stores the libraries to a storage other than the current container storage  
Attributes' Summary
RootStorage denotes the root storage associated with the container.  
Methods' Details
storeLibrariesToStorage
void
storeLibrariesToStorage( [in] ::com::sun::star::embed::XStorage  RootStorage )
raises( ::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::lang::WrappedTargetException );
Description
stores the libraries to a storage other than the current container storage

Note that the library continer is not automatically associated with the new root storage. Instead, you need to manually set the ::RootStroage attribute afterwards. This separation allows for Save-To as well Save-As operations.

Parameter RootStorage
denotes the root storage into which the libraries should be written, which must not be NULL.
Note that the actual libraries are written into a sub storage of this root storage, as usual.
Throws
::com::sun::star::lang::IllegalArgumentException if the RootStorage parameter is NULL, or equals RootStorage.
Throws
::com::sun::star::lang::WrappedTargetException if an error occurs during storing.
Attributes' Details
RootStorage
::com::sun::star::embed::XStorage RootStorage
set raises (::com::sun::star::lang::IllegalArgumentException);
Description
denotes the root storage associated with the container.

Effectively, this attribute is a typed version of XPersistentLibraryContainer::RootLocation, it's guaranteed that at every time, XPersistentLibraryContainer::RootLocation and RootStorage have the same value.

You should only set this attribute to a new value if you previously called storeLibrariesToStorage with the same storage. Setting this attribute to a storage into which the container has not been stored previously might result in unexpected behaviour.
Top of Page

Copyright © 1995, 2010, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Apache OpenOffice is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Copyright & License
Apache and the Apache feather logos are trademarks of The Apache Software Foundation. OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.