/*************************************************************************
*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* Copyright 2000, 2010 Oracle and/or its affiliates.
*
* OpenOffice.org - a multi-platform office productivity suite
*
* This file is part of OpenOffice.org.
*
* OpenOffice.org is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3
* only, as published by the Free Software Foundation.
*
* OpenOffice.org is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License version 3 for more details
* (a copy is included in the LICENSE file that accompanied this code).
*
* You should have received a copy of the GNU Lesser General Public License
* version 3 along with OpenOffice.org. If not, see
* An implementation is usually obtained from a
Some arguments for
The parameter aServiceSpecifier passed to
Using the first of these service specifiers requests a read-only view of
the configuration.
The object that is created implements service Using the second form requests an updatable view of the configuration.
The object that is created should implement service
The arguments passed to
What combinations of arguments are supported depends on the service name.
With both of the standard service-specifiers above, an implementation must
accept a single argument named 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.
An implementation must ignore unknown arguments. Some parameters that are commonly supported are: Example: In the hierarchy
"Locale"
and "EnableAsync"
.
"com.sun.star.configuration.ConfigurationAccess"
and
"com.sun.star.configuration.ConfigurationUpdateAccess"
.
If the root element of the view is marked read-only (as indicated
by nodepath
of type
"nodepath"
: "depth"
: "locale"
:
A - B1 - C1
|
- B2 - C2 (localized: de, en, fr, ..)
| |
| - C3 - D1
| | |
| | - D2 - E1
| |
| - C4 - D3 - E2 - F1
| | |
| | - F2
| |
| - C5
|
- B3
|
- B4 - C6 - D4 - E3
selecting a view with nodepath = "/A/B2"
,
depth = 2
and locale = <Locale for en_US>
would result in the tree fragment
(A-) B2 - C2 (en)
|
- C3 - D1
| |
| - D2 (..)
|
- C4 - D3 (..)
|
- C5
"enableasync"
: This parameter was formerly called "lazywrite"
.
The old name should still be supported for compatibility.
"nocache"
: This parameter is not supported by all implementations and may be silently ignored !
The owner of the provider may dispose of this object
using
Views created by the provider generally refer to data that is managed by the provider. Therefore, disposing of the provider will cause all objects belonging to these views to be disposed of as well. This does not apply to snapshot views that have their own copy of the data, if available.
*/ interface com::sun::star::lang::XComponent; }; //============================================================================= }; }; }; }; #endif