Top   Module   Use   Manual   Index 
 INCLUDED SERVICES | EXPORTED INTERFACES | PROPERTIES' SUMMARY | PROPERTIES' DETAILS 

com :: sun :: star :: configuration ::

service GroupUpdate

Description
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

com::sun::star::configuration::GroupAccess
Description
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

com::sun::star::container::XNameReplace
Description
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.


Top of Page