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.