1*b1cdbd2cSJim Jagielski/************************************************************** 2*b1cdbd2cSJim Jagielski * 3*b1cdbd2cSJim Jagielski * Licensed to the Apache Software Foundation (ASF) under one 4*b1cdbd2cSJim Jagielski * or more contributor license agreements. See the NOTICE file 5*b1cdbd2cSJim Jagielski * distributed with this work for additional information 6*b1cdbd2cSJim Jagielski * regarding copyright ownership. The ASF licenses this file 7*b1cdbd2cSJim Jagielski * to you under the Apache License, Version 2.0 (the 8*b1cdbd2cSJim Jagielski * "License"); you may not use this file except in compliance 9*b1cdbd2cSJim Jagielski * with the License. You may obtain a copy of the License at 10*b1cdbd2cSJim Jagielski * 11*b1cdbd2cSJim Jagielski * http://www.apache.org/licenses/LICENSE-2.0 12*b1cdbd2cSJim Jagielski * 13*b1cdbd2cSJim Jagielski * Unless required by applicable law or agreed to in writing, 14*b1cdbd2cSJim Jagielski * software distributed under the License is distributed on an 15*b1cdbd2cSJim Jagielski * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16*b1cdbd2cSJim Jagielski * KIND, either express or implied. See the License for the 17*b1cdbd2cSJim Jagielski * specific language governing permissions and limitations 18*b1cdbd2cSJim Jagielski * under the License. 19*b1cdbd2cSJim Jagielski * 20*b1cdbd2cSJim Jagielski *************************************************************/ 21*b1cdbd2cSJim Jagielski 22*b1cdbd2cSJim Jagielski 23*b1cdbd2cSJim Jagielski#ifndef __com_sun_star_configuration_GroupUpdate_idl__ 24*b1cdbd2cSJim Jagielski#define __com_sun_star_configuration_GroupUpdate_idl__ 25*b1cdbd2cSJim Jagielski 26*b1cdbd2cSJim Jagielski#ifndef __com_sun_star_configuration_GroupAccess_idl__ 27*b1cdbd2cSJim Jagielski#include <com/sun/star/configuration/GroupAccess.idl> 28*b1cdbd2cSJim Jagielski#endif 29*b1cdbd2cSJim Jagielski 30*b1cdbd2cSJim Jagielski#ifndef __com_sun_star_container_XNameReplace_idl__ 31*b1cdbd2cSJim Jagielski#include <com/sun/star/container/XNameReplace.idl> 32*b1cdbd2cSJim Jagielski#endif 33*b1cdbd2cSJim Jagielski 34*b1cdbd2cSJim Jagielski//============================================================================= 35*b1cdbd2cSJim Jagielski 36*b1cdbd2cSJim Jagielskimodule com { module sun { module star { module configuration { 37*b1cdbd2cSJim Jagielski 38*b1cdbd2cSJim Jagielski//============================================================================= 39*b1cdbd2cSJim Jagielski/** provides write access to a predefined heterogeneous group of values 40*b1cdbd2cSJim Jagielski and nested trees as part of a hierarchy. 41*b1cdbd2cSJim Jagielski 42*b1cdbd2cSJim Jagielski <p>This service extends <type>GroupAccess</type> to support 43*b1cdbd2cSJim Jagielski modifying values. 44*b1cdbd2cSJim Jagielski </p> 45*b1cdbd2cSJim Jagielski*/ 46*b1cdbd2cSJim Jagielskipublished service GroupUpdate 47*b1cdbd2cSJim Jagielski{ 48*b1cdbd2cSJim Jagielski/** is the basic service providing read access to a group element of the 49*b1cdbd2cSJim Jagielski hierarchy. 50*b1cdbd2cSJim Jagielski 51*b1cdbd2cSJim Jagielski <p>Any child and descendant objects support modifying access as well, 52*b1cdbd2cSJim Jagielski unless they represent a read-only tree element as indicated by 53*b1cdbd2cSJim Jagielski <const scope="com::sun::star::beans">PropertyAttribute::READONLY</const>. 54*b1cdbd2cSJim Jagielski </p> 55*b1cdbd2cSJim Jagielski*/ 56*b1cdbd2cSJim Jagielski service GroupAccess; 57*b1cdbd2cSJim Jagielski 58*b1cdbd2cSJim Jagielski/** allows replacing values. 59*b1cdbd2cSJim Jagielski 60*b1cdbd2cSJim Jagielski <p>This service extends the interface 61*b1cdbd2cSJim Jagielski <type scope="com::sun::star::container">XNameAccess</type> supported 62*b1cdbd2cSJim Jagielski by service <type>GroupAccess</type> to allow changing values. 63*b1cdbd2cSJim Jagielski This strongly overlaps with functionality available through 64*b1cdbd2cSJim Jagielski <type>PropertyHierarchy</type> (from <type>GroupAccess</type>), so that 65*b1cdbd2cSJim Jagielski <code>xGroup.setPropertyValue( aName, aValue )</code> is equivalent to 66*b1cdbd2cSJim Jagielski <code>xGroup.replaceByName( aName, aValue )</code>. 67*b1cdbd2cSJim Jagielski </p> 68*b1cdbd2cSJim Jagielski 69*b1cdbd2cSJim Jagielski <p>Changes can be observed by registering a listener with interface 70*b1cdbd2cSJim Jagielski <type scope="com::sun::star::beans">XPropertySet</type> or 71*b1cdbd2cSJim Jagielski <type scope="com::sun::star::beans">XMultiPropertySet</type>. 72*b1cdbd2cSJim Jagielski </p> 73*b1cdbd2cSJim Jagielski 74*b1cdbd2cSJim Jagielski <p>Elements of this group may be replaced only if they are of simple type. 75*b1cdbd2cSJim Jagielski The type returned by 76*b1cdbd2cSJim Jagielski <member scope="com::sun::star::container">XElementAccess::getElementType()</member> 77*b1cdbd2cSJim Jagielski must not be an interface type. Replacing whole subtrees is not supported. 78*b1cdbd2cSJim Jagielski </p> 79*b1cdbd2cSJim Jagielski*/ 80*b1cdbd2cSJim Jagielski interface com::sun::star::container::XNameReplace; 81*b1cdbd2cSJim Jagielski 82*b1cdbd2cSJim Jagielski}; 83*b1cdbd2cSJim Jagielski 84*b1cdbd2cSJim Jagielski//============================================================================= 85*b1cdbd2cSJim Jagielski 86*b1cdbd2cSJim Jagielski}; }; }; }; 87*b1cdbd2cSJim Jagielski 88*b1cdbd2cSJim Jagielski#endif 89*b1cdbd2cSJim Jagielski 90