:: com :: sun :: star :: registry ::
|
service NestedRegistry |
- Description
- supports a shared view on two different registries. The registry
files will be opened in two different modes, registry1 will be opened with read/write
rights and registry2 will be opened read-only.
In the context of this service, the functions
open , close ,
and destroy from XSimpleRegistry are not supported and
throw an exception if they are used.
- Functions of XSimpleRegistry:
- getURL
- returns the name of registry1.
- isValid
- checks if registry1 is valid. If the interface is not NULL
then registry1 should always be valid.
- isReadOnly
- checks if registry1 has write protection.
- mergeKey
- merges all information from the specified registry in registry1.
- getRootKey
- returns a virtual rootkey of both registries.
- Functions of XRegistryKey:
- openKey
- returns a virtual key which is specified in registy1 or registry2.
- deleteKey
- deletes the key only if it is present in registry1.
- setLongValue, setAsciiValue, setStringValue, setBinaryValue
- sets the value at the specified key in registry1.
- getLongValue, getAsciiValue, getStringValue, getBinaryValue
- returns the value at the specified key in registry1, or if
the value is not present in registry1, it will return the value of registry2.
- openKeys
- returns a sequence of all subkeys in both registries.
- getKeyNames
- returns a sequence with the names of all subkeys in both
registries.
-
Note: all write functions only work on registry1.
How to initialize the registries:
Use a sequence of XSimpleRegistry with two elements. The first element must be
the registry which is opened with read/write rights and the second element must be
the read-only one.
Two different ways are possible:
- use XMultiServiceFactory::createInstanceWithArguments() to
create an instance of this service where the value of the any parameter must be the sequence with
the two open registries.
- use the initialize function of the ::com::sun::star::lang::XInitialization interface where the value of the
any parameter must be the sequence with the two open registries.
Guarantees:
|
Exported Interfaces - Summary |
XSimpleRegistry |
- (referenced entity's summary:)
- allows access to a registry (a persistent data source).
The data is stored in a hierarchical key structure beginning with a root key.
Each key can store a value and can have multiple subkeys.
|
::com::sun::star::lang::XInitialization |
- (referenced entity's summary:)
- initializes an object directly after its creation.
|
Exported Interfaces - Details |
XSimpleRegistry
- (referenced entity's summary:)
- allows access to a registry (a persistent data source).
The data is stored in a hierarchical key structure beginning with a root key.
Each key can store a value and can have multiple subkeys.
|
|
::com::sun::star::lang::XInitialization
- (referenced entity's summary:)
- initializes an object directly after its creation.
|
|
Top of Page
Copyright © 2000, 2012 LibreOffice contributors and/or their affiliates. All rights reserved.
LibreOffice was created by The Document Foundation, based on OpenOffice.org, which is Copyright 2000, 2010 Oracle and/or its affiliates.
The Document Foundation acknowledges all community members, please find more info at our website.
Privacy Policy | Impressum (Legal Info) | Copyright information: The source code of LibreOffice is licensed under the GNU Lesser General Public License (LGPLv3). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.