1 /*************************************************************************
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5 * Copyright 2008 by Sun Microsystems, Inc.
7 * OpenOffice.org - a multi-platform office productivity suite
9 * $RCSfile: ConfigurableUIElement.idl,v $
12 * This file is part of OpenOffice.org.
14 * OpenOffice.org is free software: you can redistribute it and/or modify
15 * it under the terms of the GNU Lesser General Public License version 3
16 * only, as published by the Free Software Foundation.
18 * OpenOffice.org is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU Lesser General Public License version 3 for more details
22 * (a copy is included in the LICENSE file that accompanied this code).
24 * You should have received a copy of the GNU Lesser General Public License
25 * version 3 along with OpenOffice.org. If not, see
26 * <http://www.openoffice.org/license.html>
27 * for a copy of the LGPLv3 License.
29 ************************************************************************/
31 #ifndef __com_sun_star_ui_ConfigurableUIElement_idl__
32 #define __com_sun_star_ui_ConfigurableUIElement_idl__
34 #ifndef __com_sun_star_ui_UIElement_idl__
35 #include
<com
/sun
/star
/ui
/UIElement.idl
>
38 #ifndef __com_sun_star_ui_XUIElementSettings_idl__
39 #include
<com
/sun
/star
/ui
/XUIElementSettings.idl
>
42 #ifndef __com_sun_star_beans_XPropertySet_idl__
43 #include
<com
/sun
/star
/beans
/XPropertySet.idl
>
46 #ifndef __com_sun_star_ui_UIElementType_idl__
47 #include
<com
/sun
/star
/ui
/UIElementType.idl
>
50 #ifndef __com_sun_star_ui_XUIConfigurationManager_idl__
51 #include
<com
/sun
/star
/ui
/XUIConfigurationManager.idl
>
54 #ifndef __com_sun_star_frame_XFrame_idl__
55 #include
<com
/sun
/star
/frame
/XFrame.idl
>
58 #ifndef __com_sun_star_lang_XInitialization_idl__
59 #include
<com
/sun
/star
/lang
/XInitialization.idl
>
62 //=============================================================================
64 module com
{ module sun
{ module star
{ module ui
{
66 //=============================================================================
68 /** specifies a configurable user interface element that supports persistence.
71 Configurable user interface elements are:
83 service ConfigurableUIElement
85 /** provides properties and functions to initialize and identify a user
89 A configurable user interface element must be initialized using
90 <member scope=com::sun::star::lang>XInitialization::initialize</member> before
91 it can be used. The following properties must be provided:
93 <li><b>ResourceURL</b><br>specifies the user interface name.</li>
94 <li><b>Frame</b><br>specifies to which frame instance the user interface belongs to.</li>
95 <li><b>ConfigurationSource</b><br>specifies to which configuration manager a user interface
96 element instance is bound to.</li>
100 A user interface element factory creates and initializes every user interface element
103 @see com::sun::star::ui::UIElementFactory
107 /** provides functions to retrieve and change the user interface element structure data and to
108 update its visible representation.
110 interface com
::sun
::star
::ui
::XUIElementSettings
;
112 /** specifies if the user interface element stores changes of its structure to its creator
113 source defined by the property <member>ConfigurationSource</member>. */
114 [property
] boolean Persistent
;
116 /** specifies the configuration source of this user interface element.
119 If the property <member>Persistent</member> is <TRUE/> changes on the structure of
120 the user interface element are written back to configuration source. When this property is
121 changed, afterwards <member>XUIElementSettings::updateSettings</member> must be called so
122 the user interface element tries to retrieve its settings from the new user interface
123 configuration manager.
126 [property
] com
::sun
::star
::ui
::XUIConfigurationManager ConfigurationSource
;