1/**************************************************************
2 *
3 * Licensed to the Apache Software Foundation (ASF) under one
4 * or more contributor license agreements.  See the NOTICE file
5 * distributed with this work for additional information
6 * regarding copyright ownership.  The ASF licenses this file
7 * to you under the Apache License, Version 2.0 (the
8 * "License"); you may not use this file except in compliance
9 * with the License.  You may obtain a copy of the License at
10 *
11 *   http://www.apache.org/licenses/LICENSE-2.0
12 *
13 * Unless required by applicable law or agreed to in writing,
14 * software distributed under the License is distributed on an
15 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16 * KIND, either express or implied.  See the License for the
17 * specific language governing permissions and limitations
18 * under the License.
19 *
20 *************************************************************/
21
22
23#ifndef __com_sun_star_configuration_PropertyHierarchy_idl__
24#define __com_sun_star_configuration_PropertyHierarchy_idl__
25
26#ifndef __com_sun_star_beans_XPropertySet_idl__
27#include <com/sun/star/beans/XPropertySet.idl>
28#endif
29
30#ifndef __com_sun_star_beans_XMultiPropertySet_idl__
31#include <com/sun/star/beans/XMultiPropertySet.idl>
32#endif
33
34#ifndef __com_sun_star_beans_XHierarchicalPropertySet_idl__
35#include <com/sun/star/beans/XHierarchicalPropertySet.idl>
36#endif
37
38#ifndef __com_sun_star_beans_XMultiHierarchicalPropertySet_idl__
39#include <com/sun/star/beans/XMultiHierarchicalPropertySet.idl>
40#endif
41
42//=============================================================================
43
44module com { module sun { module star { module configuration {
45
46//=============================================================================
47/** provides access to and information about properties and subproperties
48 of an implementation.
49
50 <p>Properties in a property set may be full-fledged objects that have
51 properties themselves (and so on recursively), thereby forming a hierarchy
52 of properties. This service describes such a hierarchy, and allows
53 direct access even to subproperties.
54 </p>
55
56 @see com::sun::star::beans::XProperty
57 Properties of an implementation that are objects themselves will often
58 implement <type scope="com::sun::star::beans">XProperty</type> to allow
59 direct access to information about the object.
60 If such objects have properties of their own, they should fully implement
61 <type>PropertyHierarchy</type> again.
62*/
63published service PropertyHierarchy
64{
65/** provides access to and information about the immediate properties of an implementation.
66*/
67	interface com::sun::star::beans::XPropertySet;
68
69/** provides access to and information about the immediate properties
70 of an implementation.
71
72 <p>This interface allows retrieving or setting multiple properties at once.
73 Accesses are guaranteed to occur as single atomic operations even if
74 multiple threads are accessing the object simultaneously.
75 </p>
76*/
77	interface com::sun::star::beans::XMultiPropertySet;
78
79/** provides access to and information about the whole hierarchy
80 of properties and subproperties of an implementation.
81*/
82	interface com::sun::star::beans::XHierarchicalPropertySet;
83
84/** provides access to and information about the whole hierarchy
85 of properties and subproperties of an implementation.
86
87 <p>This interface allows retrieving or setting multiple properties at once.
88 Accesses are guaranteed to occur as single atomic operations even if
89 multiple threads are accessing the object simultaneously.
90 </p>
91*/
92	interface com::sun::star::beans::XMultiHierarchicalPropertySet;
93
94};
95
96//=============================================================================
97
98}; }; }; };
99
100#endif
101