The com::sun::star::container::XNameContainer
and com::sun::star::container::XNameReplace
interfaces can be used to manage the item groups. It is possible to
insert, remove, and replace item groups.
The method com::sun::star::container::XNameReplace::replaceByName()
can be used to replace the item
names in an existing group with a new collection of item names. An
implementation should support the following data types:
- an empty `any` to remove all items and leave the
group empty. The group can be filled later with new item names.
- a `string[]` containing all item names that will
be part of the group.
- an object supporting com::sun::star::container::XIndexAccess
containing elements that provide an item name per element via the
interface com::sun::star::container::XNamed,
for example an instance of DataPilotFieldGroup.
The method com::sun::star::container::XNameContainer::insertByName()
can be used to insert a new
field group with the passed collection of item names. An
implementation should support the same data types as described above
for the method
com::sun::star::container::XNameReplace::replaceByName().
The method com::sun::star::container::XNameContainer::removeByName()
can be used to remove an existing field group.