|
LibreOfficeDev
LibreOfficeDev 25.8 SDK API Reference
|
offers a simple way to store a component to a URL. More...
import"XStorable.idl";
Public Member Functions | |
| boolean | hasLocation () |
| The object may know the location because it was loaded from there, or because it is stored there. More... | |
| string | getLocation () |
| After XStorable::storeAsURL() it returns the URL the object was stored to. More... | |
| boolean | isReadonly () |
| It is not possible to call XStorable::store() successfully when the data store is read-only. More... | |
| void | store () raises ( com::sun::star::io::IOException ) |
| stores the data to the URL from which it was loaded. More... | |
| void | storeAsURL ([in] string sURL, [in] sequence< com::sun::star::beans::PropertyValue > lArguments) raises ( com::sun::star::io::IOException ) |
| stores the object's persistent data to a URL and makes this URL the new location of the object. More... | |
| void | storeToURL ([in] string sURL, [in] sequence< com::sun::star::beans::PropertyValue > lArguments) raises ( com::sun::star::io::IOException ) |
| stores the object's persistent data to a URL and continues to be a representation of the old URL. More... | |
Public Member Functions inherited from XInterface | |
| any | queryInterface ([in] type aType) |
| queries for a new interface to an existing UNO object. More... | |
| void | acquire () |
| increases the reference counter by one. More... | |
| void | release () |
| decreases the reference counter by one. More... | |
offers a simple way to store a component to a URL.
It is usually only useful for two cases:
| string getLocation | ( | ) |
After XStorable::storeAsURL() it returns the URL the object was stored to.
| boolean hasLocation | ( | ) |
The object may know the location because it was loaded from there, or because it is stored there.
TRUE if the object knows a location where it is persistent FALSE otherwise | boolean isReadonly | ( | ) |
It is not possible to call XStorable::store() successfully when the data store is read-only.
TRUE if the data store is readonly or opened readonly FALSE otherwise | void store | ( | ) | ||
| raises | ( | com::sun::star::io::IOException | ||
| ) | ||||
stores the data to the URL from which it was loaded.
Only objects which know their locations can be stored.
| com::sun::star::io::IOException | if an IO error occurred during save operation (may the location is unknown) |
| void storeAsURL | ( | [in] string | sURL, |
| [in] sequence< com::sun::star::beans::PropertyValue > | lArguments | ||
| ) | |||
| raises | ( | com::sun::star::io::IOException | |
| ) | |||
stores the object's persistent data to a URL and makes this URL the new location of the object.
This is the normal behavior for UI's "save-as" feature.
The change of the location makes it necessary to store the document in a format that the object can load. For this reason the implementation of XStorable::storeAsURL() will throw an exception if a pure export filter is used, it will accept only combined import/export filters. For such filters the method XStorable::storeToURL() must be used that does not change the location of the object.
| sURL | specifies the new location of this component |
| lArguments | optional parameters for saving (see com::sun::star::document::MediaDescriptor for further details) |
| com::sun::star::io::IOException | if an IO error occurred during save operation (may the location is unknown) |
| void storeToURL | ( | [in] string | sURL, |
| [in] sequence< com::sun::star::beans::PropertyValue > | lArguments | ||
| ) | |||
| raises | ( | com::sun::star::io::IOException | |
| ) | |||
stores the object's persistent data to a URL and continues to be a representation of the old URL.
This is the normal behavior for UI's export feature.
This method accepts all kinds of export filters, not only combined import/export filters because it implements an exporting capability, not a persistence capability.
| com::sun::star::io::IOException | if an IO error occurred during save operation (may the location is unknown) |
| sURL | specifies the location where to store the object |
| lArguments | optional parameters for saving (see com::sun::star::document::MediaDescriptor for further details) |
1.8.14