xref: /trunk/main/framework/inc/services/layoutmanager.hxx (revision 45c5a00162811bd03b87fcb4fe9996782f2b59ec)
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 
24 #ifndef __FRAMEWORK_SERVICES_LAYOUTMANAGER_HXX_
25 #define __FRAMEWORK_SERVICES_LAYOUTMANAGER_HXX_
26 
27 /** Attention: stl headers must(!) be included at first. Otherwise it can make trouble
28                with solaris headers ...
29 */
30 #include <vector>
31 
32 //_________________________________________________________________________________________________________________
33 //  my own includes
34 //_________________________________________________________________________________________________________________
35 #include <threadhelp/threadhelpbase.hxx>
36 #include <threadhelp/resetableguard.hxx>
37 #include <threadhelp/writeguard.hxx>
38 #include <threadhelp/readguard.hxx>
39 #include <macros/generic.hxx>
40 #include <macros/xinterface.hxx>
41 #include <macros/xtypeprovider.hxx>
42 #include <macros/xserviceinfo.hxx>
43 #include <stdtypes.h>
44 #include <properties.h>
45 #include <stdtypes.h>
46 #include <uielement/menubarmanager.hxx>
47 #include <uiconfiguration/windowstateconfiguration.hxx>
48 #include <framework/addonsoptions.hxx>
49 #include <uielement/panelwindow.hxx>
50 #include <uielement/uielement.hxx>
51 #include <helper/ilayoutnotifications.hxx>
52 
53 //_________________________________________________________________________________________________________________
54 //  interface includes
55 //_________________________________________________________________________________________________________________
56 #include <com/sun/star/lang/XServiceInfo.hpp>
57 #include <com/sun/star/lang/XTypeProvider.hpp>
58 #include <com/sun/star/frame/XLayoutManager.hpp>
59 #include <com/sun/star/ui/XUIConfigurationManager.hpp>
60 #include <com/sun/star/ui/XUIConfiguration.hpp>
61 #include <com/sun/star/frame/XModuleManager.hpp>
62 #include <com/sun/star/frame/XFrameActionListener.hpp>
63 #include <com/sun/star/awt/XWindowListener.hpp>
64 #include <com/sun/star/util/XURLTransformer.hpp>
65 #include <com/sun/star/ui/XUIElementFactory.hpp>
66 #include <com/sun/star/frame/XInplaceLayout.hpp>
67 #include <com/sun/star/ui/DockingArea.hpp>
68 #include <com/sun/star/awt/XTopWindow2.hpp>
69 #include <com/sun/star/awt/XDockableWindow.hpp>
70 #include <com/sun/star/awt/XDockableWindowListener.hpp>
71 #include <com/sun/star/frame/XMenuBarMergingAcceptor.hpp>
72 #include <com/sun/star/frame/XLayoutManagerEventBroadcaster.hpp>
73 
74 //_________________________________________________________________________________________________________________
75 //  other includes
76 //_________________________________________________________________________________________________________________
77 #include <cppuhelper/propshlp.hxx>
78 #include <cppuhelper/implbase8.hxx>
79 #include <cppuhelper/interfacecontainer.hxx>
80 #include <comphelper/propertycontainer.hxx>
81 #include <tools/wintypes.hxx>
82 #include <svtools/miscopt.hxx>
83 #include <vcl/toolbox.hxx>
84 #include <vcl/timer.hxx>
85 
86 class MenuBar;
87 namespace framework
88 {
89     class ToolbarLayoutManager;
90     class PanelManager;
91     class GlobalSettings;
92     typedef ::cppu::WeakImplHelper8 <   ::com::sun::star::lang::XServiceInfo
93                                     ,   ::com::sun::star::frame::XLayoutManager
94                                     ,   ::com::sun::star::awt::XWindowListener
95                                     ,   ::com::sun::star::frame::XFrameActionListener
96                                     ,   ::com::sun::star::ui::XUIConfigurationListener
97                                     ,   ::com::sun::star::frame::XInplaceLayout
98                                     ,   ::com::sun::star::frame::XMenuBarMergingAcceptor
99                                     ,   ::com::sun::star::frame::XLayoutManagerEventBroadcaster
100                                     >   LayoutManager_Base;
101     typedef ::comphelper::OPropertyContainer    LayoutManager_PBase;
102     class LayoutManager : public  LayoutManager_Base                    ,
103                           // base classes
104                           // Order is necessary for right initialization!
105                           private ThreadHelpBase                        ,   // Struct for right initialization of mutex member! Must be first of baseclasses.
106                           public  ::cppu::OBroadcastHelper              ,
107                           public  ILayoutNotifications                  ,
108                           public  LayoutManager_PBase
109     {
110         public:
111             enum { DOCKINGAREAS_COUNT = 4 };
112 
113             LayoutManager( const com::sun::star::uno::Reference< com::sun::star::lang::XMultiServiceFactory >& rSMGR );
114             virtual ~LayoutManager();
115 
116             /** declaration of XInterface, XTypeProvider, XServiceInfo */
117             FWK_DECLARE_XINTERFACE
118             FWK_DECLARE_XTYPEPROVIDER
119             DECLARE_XSERVICEINFO
120 
121             //---------------------------------------------------------------------------------------------------------
122             // XLayoutManager
123             //---------------------------------------------------------------------------------------------------------
124             virtual void SAL_CALL attachFrame( const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XFrame >& Frame );
125             virtual void SAL_CALL reset();
126             virtual ::com::sun::star::awt::Rectangle SAL_CALL getCurrentDockingArea(  );
127             virtual ::com::sun::star::uno::Reference< ::com::sun::star::ui::XDockingAreaAcceptor > SAL_CALL getDockingAreaAcceptor();
128             virtual void SAL_CALL setDockingAreaAcceptor( const ::com::sun::star::uno::Reference< ::com::sun::star::ui::XDockingAreaAcceptor >& xDockingAreaAcceptor );
129             virtual void SAL_CALL createElement( const ::rtl::OUString& aName );
130             virtual void SAL_CALL destroyElement( const ::rtl::OUString& aName );
131             virtual ::sal_Bool SAL_CALL requestElement( const ::rtl::OUString& ResourceURL );
132             virtual ::com::sun::star::uno::Reference< ::com::sun::star::ui::XUIElement > SAL_CALL getElement( const ::rtl::OUString& aName );
133             virtual ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Reference< ::com::sun::star::ui::XUIElement > > SAL_CALL getElements(  );
134             virtual sal_Bool SAL_CALL showElement( const ::rtl::OUString& aName );
135             virtual sal_Bool SAL_CALL hideElement( const ::rtl::OUString& aName );
136             virtual sal_Bool SAL_CALL dockWindow( const ::rtl::OUString& aName, ::com::sun::star::ui::DockingArea DockingArea, const ::com::sun::star::awt::Point& Pos );
137             virtual ::sal_Bool SAL_CALL dockAllWindows( ::sal_Int16 nElementType );
138             virtual sal_Bool SAL_CALL floatWindow( const ::rtl::OUString& aName );
139             virtual ::sal_Bool SAL_CALL lockWindow( const ::rtl::OUString& ResourceURL );
140             virtual ::sal_Bool SAL_CALL unlockWindow( const ::rtl::OUString& ResourceURL );
141             virtual void SAL_CALL setElementSize( const ::rtl::OUString& aName, const ::com::sun::star::awt::Size& aSize );
142             virtual void SAL_CALL setElementPos( const ::rtl::OUString& aName, const ::com::sun::star::awt::Point& aPos );
143             virtual void SAL_CALL setElementPosSize( const ::rtl::OUString& aName, const ::com::sun::star::awt::Point& aPos, const ::com::sun::star::awt::Size& aSize );
144             virtual sal_Bool SAL_CALL isElementVisible( const ::rtl::OUString& aName );
145             virtual sal_Bool SAL_CALL isElementFloating( const ::rtl::OUString& aName );
146             virtual sal_Bool SAL_CALL isElementDocked( const ::rtl::OUString& aName );
147             virtual ::sal_Bool SAL_CALL isElementLocked( const ::rtl::OUString& ResourceURL );
148             virtual ::com::sun::star::awt::Size SAL_CALL getElementSize( const ::rtl::OUString& aName );
149             virtual ::com::sun::star::awt::Point SAL_CALL getElementPos( const ::rtl::OUString& aName );
150             virtual void SAL_CALL lock(  );
151             virtual void SAL_CALL unlock(  );
152             virtual void SAL_CALL doLayout(  );
153             virtual void SAL_CALL setVisible( sal_Bool bVisible );
154             virtual sal_Bool SAL_CALL isVisible();
155 
156             //---------------------------------------------------------------------------------------------------------
157             //  XInplaceLayout
158             //---------------------------------------------------------------------------------------------------------
159             virtual void SAL_CALL setInplaceMenuBar( sal_Int64 pInplaceMenuBarPointer );
160             virtual void SAL_CALL resetInplaceMenuBar(  );
161 
162             //---------------------------------------------------------------------------------------------------------
163             // XMenuBarMergingAcceptor
164             //---------------------------------------------------------------------------------------------------------
165             virtual sal_Bool SAL_CALL setMergedMenuBar( const ::com::sun::star::uno::Reference< ::com::sun::star::container::XIndexAccess >& xMergedMenuBar );
166             virtual void SAL_CALL removeMergedMenuBar(  );
167 
168             //---------------------------------------------------------------------------------------------------------
169             //  XWindowListener
170             //---------------------------------------------------------------------------------------------------------
171             virtual void SAL_CALL windowResized( const css::awt::WindowEvent& aEvent );
172             virtual void SAL_CALL windowMoved( const css::awt::WindowEvent& aEvent );
173             virtual void SAL_CALL windowShown( const css::lang::EventObject& aEvent );
174             virtual void SAL_CALL windowHidden( const css::lang::EventObject& aEvent );
175 
176             //---------------------------------------------------------------------------------------------------------
177             //   XFrameActionListener
178             //---------------------------------------------------------------------------------------------------------
179             virtual void SAL_CALL frameAction( const css::frame::FrameActionEvent& aEvent );
180 
181             //---------------------------------------------------------------------------------------------------------
182             //  XEventListener
183             //---------------------------------------------------------------------------------------------------------
184             using cppu::OPropertySetHelper::disposing;
185             virtual void SAL_CALL disposing( const css::lang::EventObject& aEvent );
186 
187             //---------------------------------------------------------------------------------------------------------
188             //  XUIConfigurationListener
189             //---------------------------------------------------------------------------------------------------------
190             virtual void SAL_CALL elementInserted( const ::com::sun::star::ui::ConfigurationEvent& Event );
191             virtual void SAL_CALL elementRemoved( const ::com::sun::star::ui::ConfigurationEvent& Event );
192             virtual void SAL_CALL elementReplaced( const ::com::sun::star::ui::ConfigurationEvent& Event );
193 
194             //---------------------------------------------------------------------------------------------------------
195             //  XLayoutManagerEventBroadcaster
196             //---------------------------------------------------------------------------------------------------------
197             virtual void SAL_CALL addLayoutManagerEventListener( const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XLayoutManagerListener >& aLayoutManagerListener );
198             virtual void SAL_CALL removeLayoutManagerEventListener( const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XLayoutManagerListener >& aLayoutManagerListener );
199 
200             DECL_LINK( MenuBarClose, MenuBar * );
201             DECL_LINK( WindowEventListener, VclSimpleEvent* );
202 
203             //---------------------------------------------------------------------------------------------------------
204             //  ILayoutNotifications
205             //---------------------------------------------------------------------------------------------------------
206             virtual void requestLayout( Hint eHint );
207 
208         protected:
209             DECL_LINK( AsyncLayoutHdl, Timer * );
210 
211         private:
212             //---------------------------------------------------------------------------------------------------------
213             //  helper
214             //---------------------------------------------------------------------------------------------------------
215 
216             //---------------------------------------------------------------------------------------------------------
217             //  menu bar
218             //---------------------------------------------------------------------------------------------------------
219             void impl_clearUpMenuBar();
220             void implts_reset( sal_Bool bAttach );
221             void implts_setMenuBarCloser(sal_Bool bCloserState);
222             void implts_updateMenuBarClose();
223             sal_Bool implts_resetMenuBar();
224 
225             //---------------------------------------------------------------------------------------------------------
226             //  locking
227             //---------------------------------------------------------------------------------------------------------
228             void implts_lock();
229             sal_Bool implts_unlock();
230 
231             //---------------------------------------------------------------------------------------------------------
232             //  query
233             //---------------------------------------------------------------------------------------------------------
234             ::com::sun::star::uno::Reference< ::com::sun::star::ui::XUIElement > implts_findElement( const rtl::OUString& aName );
235             UIElement& impl_findElement( const rtl::OUString& aName );
236 
237             void implts_writeNewStateData( const rtl::OUString aName, const ::com::sun::star::uno::Reference< com::sun::star::awt::XWindow >& xWindow );
238             sal_Bool implts_readWindowStateData( const rtl::OUString& rName, UIElement& rElementData );
239             void implts_writeWindowStateData( const rtl::OUString& rName, const UIElement& rElementData );
240             void implts_setElementData( UIElement& rUIElement, const ::com::sun::star::uno::Reference< ::com::sun::star::awt::XDockableWindow >& rDockWindow );
241             void implts_sortUIElements();
242             void implts_destroyElements();
243             void implts_toggleFloatingUIElementsVisibility( sal_Bool bActive );
244             void implts_reparentChildWindows();
245             ::com::sun::star::uno::Reference< ::com::sun::star::ui::XUIElement > implts_createDockingWindow( const ::rtl::OUString& aElementName );
246 
247             sal_Bool implts_isEmbeddedLayoutManager() const;
248             sal_Int16 implts_getCurrentSymbolsSize();
249             sal_Int16 implts_getCurrentSymbolsStyle();
250             ::com::sun::star::uno::Reference< ::com::sun::star::ui::XUIElement > implts_createElement( const rtl::OUString& aName );
251 
252             // layouting methods
253             sal_Bool implts_resizeContainerWindow( const ::com::sun::star::awt::Size& rContainerSize, const ::com::sun::star::awt::Point& rComponentPos );
254             ::Size  implts_getTopBottomDockingAreaSizes();
255             ::Size  implts_getContainerWindowOutputSize();
256 
257             void implts_setDockingAreaWindowSizes( const css::awt::Rectangle& rBorderSpace );
258             ::com::sun::star::awt::Rectangle implts_calcDockingAreaSizes();
259             sal_Bool implts_doLayout( sal_Bool bForceRequestBorderSpace, sal_Bool bOuterResize );
260             void implts_doLayout_notify( sal_Bool bOuterResize );
261 
262             // internal methods to control status/progress bar
263             ::Size      implts_getStatusBarSize();
264             void        implts_destroyStatusBar();
265             void        implts_createStatusBar( const rtl::OUString& rStatusBarName );
266             void        implts_createProgressBar();
267             void        implts_destroyProgressBar();
268             void        implts_setStatusBarPosSize( const ::Point& rPos, const ::Size& rSize );
269             sal_Bool    implts_showStatusBar( sal_Bool bStoreState=sal_False );
270             sal_Bool    implts_hideStatusBar( sal_Bool bStoreState=sal_False );
271             void        implts_readStatusBarState( const rtl::OUString& rStatusBarName );
272             sal_Bool    implts_showProgressBar();
273             sal_Bool    implts_hideProgressBar();
274             void        implts_backupProgressBarWrapper();
275             void        implts_setOffset( const sal_Int32 nBottomOffset );
276 
277             void    implts_setInplaceMenuBar(
278                         const ::com::sun::star::uno::Reference< ::com::sun::star::container::XIndexAccess >& xMergedMenuBar );
279             void    implts_resetInplaceMenuBar();
280 
281             void    implts_setVisibleState( sal_Bool bShow );
282             void    implts_updateUIElementsVisibleState( sal_Bool bShow );
283             void    implts_setCurrentUIVisibility( sal_Bool bShow );
284             void    implts_notifyListeners( short nEvent, ::com::sun::star::uno::Any aInfoParam );
285 
286             DECL_LINK( OptionsChanged, void* );
287             DECL_LINK( SettingsChanged, void* );
288 
289             //---------------------------------------------------------------------------------------------------------
290             //  OPropertySetHelper
291             //---------------------------------------------------------------------------------------------------------
292             virtual sal_Bool                                            SAL_CALL convertFastPropertyValue        ( com::sun::star::uno::Any&        aConvertedValue ,
293                                                                                                                 com::sun::star::uno::Any&        aOldValue       ,
294                                                                                                                 sal_Int32                        nHandle         ,
295                                                                                                                 const com::sun::star::uno::Any&  aValue          );
296             virtual void                                                SAL_CALL setFastPropertyValue_NoBroadcast( sal_Int32                        nHandle         ,
297                                                                                                                 const com::sun::star::uno::Any&  aValue          );
298             using cppu::OPropertySetHelper::getFastPropertyValue;
299             virtual void                                                SAL_CALL getFastPropertyValue( com::sun::star::uno::Any&    aValue          ,
300                                                                                                     sal_Int32                    nHandle         ) const;
301             virtual ::cppu::IPropertyArrayHelper&                       SAL_CALL getInfoHelper();
302             virtual ::com::sun::star::uno::Reference< com::sun::star::beans::XPropertySetInfo > SAL_CALL getPropertySetInfo();
303 
304             css::uno::Reference< css::lang::XMultiServiceFactory >                      m_xSMGR; /** reference to factory, which has created this instance. */
305             css::uno::Reference< css::util::XURLTransformer >                           m_xURLTransformer;
306             css::uno::Reference< css::container::XIndexAccess >                         m_xDisplayAccess;
307             css::uno::Reference< css::frame::XFrame >                                   m_xFrame;
308             css::uno::Reference< ::com::sun::star::ui::XUIConfigurationManager >        m_xModuleCfgMgr;
309             css::uno::Reference< ::com::sun::star::ui::XUIConfigurationManager >        m_xDocCfgMgr;
310             css::uno::WeakReference< css::frame::XModel >                               m_xModel;
311             css::uno::Reference< css::awt::XWindow >                                    m_xContainerWindow;
312             css::uno::Reference< css::awt::XTopWindow2 >                                m_xContainerTopWindow;
313             sal_Int32                                                                   m_nLockCount;
314             bool                                                                        m_bActive;
315             bool                                                                        m_bInplaceMenuSet;
316             bool                                                                        m_bDockingInProgress;
317             bool                                                                        m_bMenuVisible;
318             bool                                                                        m_bComponentAttached;
319             bool                                                                        m_bDoLayout;
320             bool                                                                        m_bVisible;
321             bool                                                                        m_bParentWindowVisible;
322             bool                                                                        m_bMustDoLayout;
323             bool                                                                        m_bAutomaticToolbars;
324             bool                                                                        m_bStoreWindowState;
325             bool                                                                        m_bHideCurrentUI;
326             bool                                                                        m_bGlobalSettings;
327             bool                                                                        m_bPreserveContentSize;
328             bool                                                                        m_bMenuBarCloser;
329             css::awt::Rectangle                                                         m_aDockingArea;
330             css::uno::Reference< ::com::sun::star::ui::XDockingAreaAcceptor >           m_xDockingAreaAcceptor;
331             css::uno::Reference< ::com::sun::star::lang::XComponent >                   m_xInplaceMenuBar;
332             MenuBarManager*                                                             m_pInplaceMenuBar;
333             css::uno::Reference< ::com::sun::star::ui::XUIElement >                     m_xMenuBar;
334             UIElement                                                                   m_aStatusBarElement;
335             UIElement                                                                   m_aProgressBarElement;
336             com::sun::star::uno::Reference< ::com::sun::star::ui::XUIElement >          m_xProgressBarBackup;
337             css::uno::Reference< ::com::sun::star::frame::XModuleManager >              m_xModuleManager;
338             css::uno::Reference< ::com::sun::star::ui::XUIElementFactory >              m_xUIElementFactoryManager;
339             css::uno::Reference< ::com::sun::star::container::XNameAccess >             m_xPersistentWindowState;
340             css::uno::Reference< ::com::sun::star::container::XNameAccess >             m_xPersistentWindowStateSupplier;
341             GlobalSettings*                                                             m_pGlobalSettings;
342             rtl::OUString                                                               m_aModuleIdentifier;
343             rtl::OUString                                                               m_aStatusBarAlias;
344             rtl::OUString                                                               m_aProgressBarAlias;
345             rtl::OUString                                                               m_aPropDocked;
346             rtl::OUString                                                               m_aPropVisible;
347             rtl::OUString                                                               m_aPropDockingArea;
348             rtl::OUString                                                               m_aPropDockPos;
349             rtl::OUString                                                               m_aPropPos;
350             rtl::OUString                                                               m_aPropSize;
351             rtl::OUString                                                               m_aPropUIName;
352             rtl::OUString                                                               m_aPropStyle;
353             rtl::OUString                                                               m_aPropLocked;
354             rtl::OUString                                                               m_aCustomizeCmd;
355             sal_Int16                                                                   m_eSymbolsSize;
356             sal_Int16                                                                   m_eSymbolsStyle;
357         Timer                                                                       m_aAsyncLayoutTimer;
358             ::cppu::OMultiTypeInterfaceContainerHelper                                  m_aListenerContainer; // container for ALL Listener
359             PanelManager*                                                               m_pPanelManager;
360             ToolbarLayoutManager*                                                       m_pToolbarManager;
361             css::uno::Reference< ::com::sun::star::ui::XUIConfigurationListener >       m_xToolbarManager;
362     };
363 
364 } // namespace framework
365 
366 #endif // __FRAMEWORK_SERVICES_LAYOUTMANAGER_HXX_
367