service GroupUpdate in module com::sun::star::configuration::

(Global Index)

Syntax

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