manages one or more complete sets of hierarchy data and serves as a factory
for objects that provide access to a subset of the data.
Note: This is an abstract service. This means, that there should
never be implementations that can be instanciated using the service name
com.sun.star.ucb.HierarchyDataSource. Each implementation must
provide its own service name that can be used to create instances of that
service implementation. Important for those service specifications is also
to specify which of the optional parts are supported by the implementation.
The arguments passed to
in parameter aArguments specify the view of the data that
should be created. That is, they determine the subset of elements that
can be accessed starting from the returned object. Each element of the
argument sequence should be a
::com::sun::star::beans::PropertyValue, so that the
parameters can be identified by name rather than by position.
With both of the standard service specifiers above, an implementation
must accept a property named nodepath of type
string. This property must contain the absolute path to an
element of the data. The view that is selected consists of the named
element and all its decendants. A path consists of segments that are
separated by a single slash ('/'). There is neither a leading nor a
trailing slash allowed. The root of the hierarchy data always
has an empty path. Refer to HierarchyDataReadAccess for
more informtion on hierarchical names.
Other arguments can be used to control the behavior of the view.
These are different for different implementations. Whether and how they
are used may also depend on the configuration store and configuration
that were selected when the provider was created.
Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation.
The Apache feather logo is a trademark of The Apache Software Foundation.
Other names appearing on the site may be trademarks of their respective owners.