1d1766043SAndrew Rist/************************************************************** 2cdf0e10cSrcweir * 3d1766043SAndrew Rist * Licensed to the Apache Software Foundation (ASF) under one 4d1766043SAndrew Rist * or more contributor license agreements. See the NOTICE file 5d1766043SAndrew Rist * distributed with this work for additional information 6d1766043SAndrew Rist * regarding copyright ownership. The ASF licenses this file 7d1766043SAndrew Rist * to you under the Apache License, Version 2.0 (the 8d1766043SAndrew Rist * "License"); you may not use this file except in compliance 9d1766043SAndrew Rist * with the License. You may obtain a copy of the License at 10d1766043SAndrew Rist * 11d1766043SAndrew Rist * http://www.apache.org/licenses/LICENSE-2.0 12d1766043SAndrew Rist * 13d1766043SAndrew Rist * Unless required by applicable law or agreed to in writing, 14d1766043SAndrew Rist * software distributed under the License is distributed on an 15d1766043SAndrew Rist * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16d1766043SAndrew Rist * KIND, either express or implied. See the License for the 17d1766043SAndrew Rist * specific language governing permissions and limitations 18d1766043SAndrew Rist * under the License. 19d1766043SAndrew Rist * 20d1766043SAndrew Rist *************************************************************/ 21d1766043SAndrew Rist 22d1766043SAndrew Rist 23cdf0e10cSrcweir 24cdf0e10cSrcweir#ifndef __com_sun_star_ui_XUIConfigurationStorage_idl__ 25cdf0e10cSrcweir#define __com_sun_star_ui_XUIConfigurationStorage_idl__ 26cdf0e10cSrcweir 27cdf0e10cSrcweir#ifndef __com_sun_star_embed_XStorage_idl__ 28cdf0e10cSrcweir#include <com/sun/star/embed/XStorage.idl> 29cdf0e10cSrcweir#endif 30cdf0e10cSrcweir 31cdf0e10cSrcweir//============================================================================= 32cdf0e10cSrcweir 33cdf0e10cSrcweirmodule com { module sun { module star { module ui { 34cdf0e10cSrcweir 35cdf0e10cSrcweir//============================================================================= 36cdf0e10cSrcweir 37cdf0e10cSrcweir/** supplies functions to change or get information about the storage 38cdf0e10cSrcweir of a user interface configuration manager. 39cdf0e10cSrcweir 40*f431c806SJürgen Schmidt @since OpenOffice 2.0 41cdf0e10cSrcweir*/ 42cdf0e10cSrcweir 43cdf0e10cSrcweirinterface XUIConfigurationStorage : ::com::sun::star::uno::XInterface 44cdf0e10cSrcweir{ 45cdf0e10cSrcweir /** connects a storage to the user interface configuration manager 46cdf0e10cSrcweir which is used on subsequent calls of <member>load</member> and 47cdf0e10cSrcweir <member>store</member>. 48cdf0e10cSrcweir 49cdf0e10cSrcweir @param Storage 50cdf0e10cSrcweir all configuration data is loaded/stored from/into this storage. 51cdf0e10cSrcweir If the storage is in read/write mode <member>load</member> 52cdf0e10cSrcweir and <member>store</member> can be used otherwise only 53cdf0e10cSrcweir <member>load</member> is possible. 54cdf0e10cSrcweir 55cdf0e10cSrcweir <p> 56cdf0e10cSrcweir This call needs careful usage as data loss can occur. If the 57cdf0e10cSrcweir implementation has modified data and a new storage is set the 58cdf0e10cSrcweir implementation is not allowed to write back the data to the old 59cdf0e10cSrcweir storage. This must be done explicitly with <member>store</member>. 60cdf0e10cSrcweir In general a user interface configuration manager instance is 61cdf0e10cSrcweir created and initialize by the document model or the module user 62cdf0e10cSrcweir interface configuration supplier. Normally there is no need to 63cdf0e10cSrcweir set a storage for a user interface configuration manager. If a 64cdf0e10cSrcweir copy of the configuration data to another storage should be made, 65cdf0e10cSrcweir use <member>storeToStorage</member>. 66cdf0e10cSrcweir </p> 67cdf0e10cSrcweir */ 68cdf0e10cSrcweir void setStorage( [in] ::com::sun::star::embed::XStorage Storage ); 69cdf0e10cSrcweir 70cdf0e10cSrcweir /** checks if an instance has already a storage to load/store its data. 71cdf0e10cSrcweir 72cdf0e10cSrcweir @return 73cdf0e10cSrcweir <TRUE/> if the instance has a storage otherwise <FALSE/>. 74cdf0e10cSrcweir */ 75cdf0e10cSrcweir boolean hasStorage(); 76cdf0e10cSrcweir}; 77cdf0e10cSrcweir 78cdf0e10cSrcweir//============================================================================= 79cdf0e10cSrcweir 80cdf0e10cSrcweir}; }; }; }; 81cdf0e10cSrcweir 82cdf0e10cSrcweir#endif 83