INTEGRATION: CWS ab31 (1.1.2); FILE ADDED

2006/12/07 07:42:44 ab 1.1.2.3: #i71410# Changes in naming and comments
2006/11/24 07:27:42 ab 1.1.2.2: #i71410# Design changes
2006/11/10 12:39:04 ab 1.1.2.1: #i71410# Interface for String Resource component

1 files changed, 97 insertions, 0 deletions

diff --git a/offapi/com/sun/star/resource/XStringResourceWithStorage.idl b/offapi/com/sun/star/resource/XStringResourceWithStorage.idl
new file mode 100644
index 000000000000..73a5688b6f44
--- /dev/null
+++ b/offapi/com/sun/star/resource/XStringResourceWithStorage.idl
@@ -0,0 +1,97 @@
+/*************************************************************************
+ *
+ *  OpenOffice.org - a multi-platform office productivity suite
+ *
+ *  $RCSfile: XStringResourceWithStorage.idl,v $
+ *
+ *  $Revision: 1.2 $
+ *
+ *  last change: $Author: hr $ $Date: 2007-01-02 15:44:40 $
+ *
+ *  The Contents of this file are made available subject to
+ *  the terms of GNU Lesser General Public License Version 2.1.
+ *
+ *
+ *    GNU Lesser General Public License Version 2.1
+ *    =============================================
+ *    Copyright 2005 by Sun Microsystems, Inc.
+ *    901 San Antonio Road, Palo Alto, CA 94303, USA
+ *
+ *    This library is free software; you can redistribute it and/or
+ *    modify it under the terms of the GNU Lesser General Public
+ *    License version 2.1, as published by the Free Software Foundation.
+ *
+ *    This library is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *    Lesser General Public License for more details.
+ *
+ *    You should have received a copy of the GNU Lesser General Public
+ *    License along with this library; if not, write to the Free Software
+ *    Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+ *    MA  02111-1307  USA
+ *
+ ************************************************************************/
+#ifndef __com_sun_star_resource_XStringResourceWithStorage_idl__
+#define __com_sun_star_resource_XStringResourceWithStorage_idl__
+
+#ifndef __com_sun_star_resource_XStringResourcePersistance_idl__
+#include <com/sun/star/resource/XStringResourcePersistance.idl>
+#endif
+
+
+//=============================================================================
+
+module com { module sun { module star { module resource {
+
+//=============================================================================
+/**
+    Extends <type>XStringResourcePersistance</type> by methods to handle an
+    associated <type scope="com::sun::star::embed">XStorage</type> instance.
+
+    @see <type>XStringResourcePersistance</type>.
+*/
+interface XStringResourceWithStorage: com::sun::star::resource::XStringResourcePersistance
+{
+    /**
+        Stores all string table data to a storage and associates this storage
+        to this instance as if <member>setStorage</member> was called with
+        this storage. The modified state will be unmodified after the call.
+
+        This method can throw all exceptions thrown by the methods of
+        <type scope="com::sun::star::embed">XStorage</type>
+    */
+    void storeAsStorage( [in] ::com::sun::star::embed::XStorage Storage )
+        raises( com::sun::star::uno::Exception );
+
+
+    /**
+        Associates a storage to the StringResourceWithStorage instance
+        which is used on subsequent calls of <member>store</member>.
+
+        @param Storage
+            the storage to be associated to the StringResourceManager
+
+        <p>
+        This call has to be used carefully as it removes the storage
+        previously connected to the StringResourceWithStorage. It may
+        force the implementation to reload data from the previous storage
+        before releasing it. The StringResourceManager will be modified
+        after calling this method as the data isn't stored to the new
+        storage yet. <member>storeAsStorage</member> should be prefered
+        as it directly stores the data to the new storage and afterwards
+        this storage is in sync with the resource data.
+        </p>
+
+        @throws <type scope="com::sun::star::lang">IllegalArgumentException</type>
+            if a null interface is passed as Storage
+    */
+    void setStorage( [in] ::com::sun::star::embed::XStorage Storage )
+        raises( ::com::sun::star::lang::IllegalArgumentException );
+};
+
+//=============================================================================
+
+}; }; }; };
+
+#endif