service GroupUpdate in module com::sun::star::configuration:: |
service GroupUpdate;
provides write access to a predefined heterogeneous group of values and nested trees as part of a (by name) hierarchy.
Allows replacing values with new values.
This service extends GroupAccess to support modifying values.
Included Services |
is the basic service providing read access to a group element of the hierarchy.
Any child and descendant objects support modifying access as well, unless they represent a read-only tree element as indicated by PropertyAttribute::READONLY .
Exported Interfaces |
allows replacing values.
This service extends the interface
XNameAccess supported
by service GroupAccess to allow changing values.
This strongly overlaps with functionality available through
PropertyHierarchy (from GroupAccess ), so that
xGroup.setPropertyValue( aName, aValue )
is equivalent to
xGroup.replaceByName( aName, aValue )
.
Changes can be observed by registering a listener with interface XPropertySet or XMultiPropertySet .
Elements of this group may be replaced only if they are of simple type. The type returned by XElementAccess::getElementType is not an interface type. Replacing whole subtrees is not supported.
Copyright 2002 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, CA 94303 USA.