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

interface XStorageBasedLibraryContainer
Base Interfaces
XStorageBasedLibraryContainerXPersistentLibraryContainer
   ┣ ::com::sun::star::util::XModifiable
   ┃ ┗ ::com::sun::star::util::XModifyBroadcasterXLibraryContainer2XLibraryContainer
         ┗ ::com::sun::star::container::XNameAccess
            ┗ ::com::sun::star::container::XElementAccess

XPersistentLibraryContainer

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 container is not automatically associated with the new root storage. Instead, you need to manually set the RootStorage 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 behavior.

Top of Page