1*cdf0e10cSrcweir/************************************************************************* 2*cdf0e10cSrcweir * 3*cdf0e10cSrcweir * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4*cdf0e10cSrcweir * 5*cdf0e10cSrcweir * Copyright 2000, 2010 Oracle and/or its affiliates. 6*cdf0e10cSrcweir * 7*cdf0e10cSrcweir * OpenOffice.org - a multi-platform office productivity suite 8*cdf0e10cSrcweir * 9*cdf0e10cSrcweir * This file is part of OpenOffice.org. 10*cdf0e10cSrcweir * 11*cdf0e10cSrcweir * OpenOffice.org is free software: you can redistribute it and/or modify 12*cdf0e10cSrcweir * it under the terms of the GNU Lesser General Public License version 3 13*cdf0e10cSrcweir * only, as published by the Free Software Foundation. 14*cdf0e10cSrcweir * 15*cdf0e10cSrcweir * OpenOffice.org is distributed in the hope that it will be useful, 16*cdf0e10cSrcweir * but WITHOUT ANY WARRANTY; without even the implied warranty of 17*cdf0e10cSrcweir * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 18*cdf0e10cSrcweir * GNU Lesser General Public License version 3 for more details 19*cdf0e10cSrcweir * (a copy is included in the LICENSE file that accompanied this code). 20*cdf0e10cSrcweir * 21*cdf0e10cSrcweir * You should have received a copy of the GNU Lesser General Public License 22*cdf0e10cSrcweir * version 3 along with OpenOffice.org. If not, see 23*cdf0e10cSrcweir * <http://www.openoffice.org/license.html> 24*cdf0e10cSrcweir * for a copy of the LGPLv3 License. 25*cdf0e10cSrcweir * 26*cdf0e10cSrcweir ************************************************************************/ 27*cdf0e10cSrcweir#ifndef __com_sun_star_configuration_ConfigurationRegistry_idl__ 28*cdf0e10cSrcweir#define __com_sun_star_configuration_ConfigurationRegistry_idl__ 29*cdf0e10cSrcweir 30*cdf0e10cSrcweir//============================================================================= 31*cdf0e10cSrcweir 32*cdf0e10cSrcweir#ifndef __com_sun_star_registry_XSimpleRegistry_idl__ 33*cdf0e10cSrcweir#include <com/sun/star/registry/XSimpleRegistry.idl> 34*cdf0e10cSrcweir#endif 35*cdf0e10cSrcweir#ifndef __com_sun_star_util_XFlushable_idl__ 36*cdf0e10cSrcweir#include <com/sun/star/util/XFlushable.idl> 37*cdf0e10cSrcweir#endif 38*cdf0e10cSrcweir 39*cdf0e10cSrcweirmodule com { module sun { module star { module configuration { 40*cdf0e10cSrcweir 41*cdf0e10cSrcweir//============================================================================= 42*cdf0e10cSrcweir 43*cdf0e10cSrcweir 44*cdf0e10cSrcweir/* provides access to a configuration tree as a registry. 45*cdf0e10cSrcweir 46*cdf0e10cSrcweir <p>This service is deprecated, 47*cdf0e10cSrcweir <type scope="com.sun.star.configuration">ConfigurationProvider</type> should 48*cdf0e10cSrcweir be used instead.</p> 49*cdf0e10cSrcweir 50*cdf0e10cSrcweir <p> Using the <type scope="com::sun::star::registry">XSimpleRegistry</type> 51*cdf0e10cSrcweir interface, the service can be bound to a subtree within the 52*cdf0e10cSrcweir configuration tree, as provided by an 53*cdf0e10cSrcweir <type scope="com.sun.star.configuration">ConfigurationProvider</type> 54*cdf0e10cSrcweir service, which must be accessible from the service factory you use for the 55*cdf0e10cSrcweir creation of this service. 56*cdf0e10cSrcweir </p> 57*cdf0e10cSrcweir <p> There are some restrictions when accessing a configuration tree using a registry. 58*cdf0e10cSrcweir Most of them are implications of the fact that a configuration tree is very static in 59*cdf0e10cSrcweir it's structure. Removal and addition of sub nodes is allowed only for special 60*cdf0e10cSrcweir nodes, and even then the new elements have to comply to a given scheme (which is some 61*cdf0e10cSrcweir kind of attribute of the container node). So for instance the 62*cdf0e10cSrcweir <member scope="com.sun.star.registry">XRegistryKey::createKey()</member> method is not allowed 63*cdf0e10cSrcweir for some nodes. 64*cdf0e10cSrcweir </p><p> 65*cdf0e10cSrcweir Thus anybody using this service is strongly advised to read and understand the specification 66*cdf0e10cSrcweir of an configuration provider (<type scope="com.sun.star.configuration">ConfigurationProvider</type>) 67*cdf0e10cSrcweir and all of it's aspects. 68*cdf0e10cSrcweir </p> 69*cdf0e10cSrcweir 70*cdf0e10cSrcweir @author Frank Schoenheit 71*cdf0e10cSrcweir @version 1.0 2000/07/06 72*cdf0e10cSrcweir*/ 73*cdf0e10cSrcweir 74*cdf0e10cSrcweirpublished service ConfigurationRegistry 75*cdf0e10cSrcweir{ 76*cdf0e10cSrcweir /** controls the binding of the object to a configuration sub tree. 77*cdf0e10cSrcweir <p><member scope="com::sun::star::registry">XSimpleRegistry::open()</member> 78*cdf0e10cSrcweir is used to open a special subtree within the configuration tree. 79*cdf0e10cSrcweir </p> 80*cdf0e10cSrcweir <p>The parameters of this method control the location of the root of the to-be-opened 81*cdf0e10cSrcweir configuration node and the access mode (read only or updatable). 82*cdf0e10cSrcweir </p> 83*cdf0e10cSrcweir */ 84*cdf0e10cSrcweir interface com::sun::star::registry::XSimpleRegistry; 85*cdf0e10cSrcweir 86*cdf0e10cSrcweir /** is used to commit changes to the configuration. 87*cdf0e10cSrcweir <p>As specified for the 88*cdf0e10cSrcweir <type scope="com::sun::star::configuration">ConfigurationUpdateAccess</type> 89*cdf0e10cSrcweir service, all changes made to an configuration subtree have to be commited 90*cdf0e10cSrcweir before they become persistent. 91*cdf0e10cSrcweir To do this for a configuration accessed as a registry, call 92*cdf0e10cSrcweir <method scope="com::sun::star::util">XFlushable::flush</method>. 93*cdf0e10cSrcweir </p> 94*cdf0e10cSrcweir <p><strong>Warning:</strong><em>Changes that are not flushed will be 95*cdf0e10cSrcweir lost.</em> 96*cdf0e10cSrcweir </p> 97*cdf0e10cSrcweir */ 98*cdf0e10cSrcweir interface com::sun::star::util::XFlushable; 99*cdf0e10cSrcweir}; 100*cdf0e10cSrcweir 101*cdf0e10cSrcweir 102*cdf0e10cSrcweir//============================================================================= 103*cdf0e10cSrcweir 104*cdf0e10cSrcweir}; }; }; }; 105*cdf0e10cSrcweir 106*cdf0e10cSrcweir 107*cdf0e10cSrcweir#endif 108*cdf0e10cSrcweir 109