xref: /AOO41X/main/dbaccess/inc/genericcontroller.hxx (revision 2e2212a7c22e96cf6f6fab0dd042c34a45a64bd6)
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 DBAUI_GENERICCONTROLLER_HXX
25 #define DBAUI_GENERICCONTROLLER_HXX
26 
27 #include "AsyncronousLink.hxx"
28 #include "controllerframe.hxx"
29 #include "dbaccessdllapi.h"
30 #include "IController.hxx"
31 
32 /** === begin UNO includes === **/
33 #include <com/sun/star/container/XNameAccess.hpp>
34 #include <com/sun/star/frame/CommandGroup.hpp>
35 #include <com/sun/star/frame/XController2.hpp>
36 #include <com/sun/star/frame/XDispatch.hpp>
37 #include <com/sun/star/frame/XDispatchInformationProvider.hpp>
38 #include <com/sun/star/frame/XDispatchProviderInterceptor.hpp>
39 #include <com/sun/star/frame/XFrameActionListener.hpp>
40 #include <com/sun/star/frame/XTitle.hpp>
41 #include <com/sun/star/frame/XTitleChangeBroadcaster.hpp>
42 #include <com/sun/star/frame/XLayoutManager.hpp>
43 #include <com/sun/star/lang/XInitialization.hpp>
44 #include <com/sun/star/lang/XServiceInfo.hpp>
45 #include <com/sun/star/sdbc/XConnection.hpp>
46 #include <com/sun/star/sdbc/XDataSource.hpp>
47 #include <com/sun/star/uno/XComponentContext.hpp>
48 #include <com/sun/star/util/XModifyListener.hpp>
49 #include <com/sun/star/util/XURLTransformer.hpp>
50 #include <com/sun/star/lang/XMultiServiceFactory.hpp>
51 #include <com/sun/star/awt/XUserInputInterception.hpp>
52 /** === end UNO includes === **/
53 
54 #include <comphelper/broadcasthelper.hxx>
55 #include <comphelper/sharedmutex.hxx>
56 #include <comphelper/namedvaluecollection.hxx>
57 #include <comphelper/stl_types.hxx>
58 #include <connectivity/dbexception.hxx>
59 #include <cppuhelper/compbase11.hxx>
60 #include <cppuhelper/interfacecontainer.h>
61 
62 #include <boost/optional.hpp>
63 #include <sfx2/userinputinterception.hxx>
64 
65 namespace dbtools
66 {
67     class SQLExceptionInfo;
68 }
69 
70 class Window;
71 class VCLXWindow;
72 namespace dbaui
73 {
74     class ODataView;
75 
76     // ====================================================================
77     // = optional
78     // ====================================================================
79     /** convenience wrapper around boost::optional, allowing typed assignments
80     */
81     template < typename T >
82     class optional : public ::boost::optional< T >
83     {
84         typedef ::boost::optional< T >  base_type;
85 
86     public:
optional()87                  optional ( ) : base_type( ) { }
optional(T const & val)88         explicit optional ( T const& val ) : base_type( val ) { }
optional(optional const & rhs)89                  optional ( optional const& rhs ) : base_type( (base_type const&)rhs ) { }
90 
91     public:
operator =(T const & rhs)92         optional& operator= ( T const& rhs )
93         {
94             base_type::reset( rhs );
95             return *this;
96         }
operator =(optional<T> const & rhs)97         optional& operator= ( optional< T > const& rhs )
98         {
99             if ( rhs.is_initialized() )
100                 base_type::reset( rhs.get() );
101             else
102                 base_type::reset();
103             return *this;
104         }
105     };
106 
107     template< typename T >
operator >>=(const::com::sun::star::uno::Any & _any,optional<T> & _value)108     inline bool SAL_CALL operator >>= ( const ::com::sun::star::uno::Any & _any, optional< T >& _value )
109     {
110         _value.reset();  // de-init the optional value
111 
112         T directValue = T();
113         if ( _any >>= directValue )
114             _value.reset( directValue );
115 
116         return !!_value;
117     }
118 
119     // ====================================================================
120     // = FeatureState
121     // ====================================================================
122     /** describes the state of a feature
123 
124         In opposite to the FeatureStateEvent in css.frame, this one allows for multiple states to be specified at once.
125         With this, you can for instance specify that a toolbox item is checked, and has a certain title, at the same
126         time.
127     */
128     struct FeatureState
129     {
130         sal_Bool                    bEnabled;
131 
132         optional< bool >            bChecked;
133         optional< bool >            bInvisible;
134         ::com::sun::star::uno::Any  aValue;
135         optional< ::rtl::OUString > sTitle;
136 
FeatureStatedbaui::FeatureState137         FeatureState() : bEnabled(sal_False) { }
138     };
139 
140     // ====================================================================
141     // = helper
142     // ====================================================================
143 
144     // ....................................................................
145     struct ControllerFeature : public ::com::sun::star::frame::DispatchInformation
146     {
147         sal_uInt16 nFeatureId;
148     };
149 
150     // ....................................................................
151     typedef ::std::map  <   ::rtl::OUString
152                         ,   ControllerFeature
153                         ,   ::std::less< ::rtl::OUString >
154                         >   SupportedFeatures;
155 
156     // ....................................................................
157     struct CompareFeatureById : ::std::binary_function< SupportedFeatures::value_type, sal_Int32, bool >
158     {
159         // ................................................................
operator ()dbaui::CompareFeatureById160         inline bool operator()( const SupportedFeatures::value_type& _aType, const sal_Int32& _nId ) const
161         {
162             return !!( _nId == _aType.second.nFeatureId );
163         }
164     };
165 
166     // ....................................................................
167     struct FeatureListener
168     {
169         ::com::sun::star::uno::Reference< ::com::sun::star::frame::XStatusListener >
170                     xListener;
171         sal_Int32   nId;
172         sal_Bool    bForceBroadcast;
173     };
174 
175     // ....................................................................
176     typedef ::std::deque< FeatureListener > FeatureListeners;
177 
178     // ....................................................................
179     struct FindFeatureListener : ::std::binary_function< FeatureListener, ::com::sun::star::uno::Reference< ::com::sun::star::frame::XStatusListener >, bool >
180     {
181         // ................................................................
operator ()dbaui::FindFeatureListener182         inline bool operator()( const FeatureListener& lhs, const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XStatusListener >& rhs ) const
183         {
184             return !!( lhs.xListener == rhs );
185         }
186     };
187 
188     // ....................................................................
189     typedef ::comphelper::SharedMutexBase   OGenericUnoController_MBASE;
190 
191     typedef ::cppu::WeakComponentImplHelper11   <   ::com::sun::star::frame::XDispatch
192                                                 ,   ::com::sun::star::frame::XDispatchProviderInterceptor
193                                                 ,   ::com::sun::star::util::XModifyListener
194                                                 ,   ::com::sun::star::frame::XFrameActionListener
195                                                 ,   ::com::sun::star::lang::XInitialization
196                                                 ,   ::com::sun::star::lang::XServiceInfo
197                                                 ,   ::com::sun::star::frame::XDispatchInformationProvider
198                                                 ,   ::com::sun::star::frame::XController2
199                                                 ,   ::com::sun::star::frame::XTitle
200                                                 ,   ::com::sun::star::frame::XTitleChangeBroadcaster
201                                                 ,   ::com::sun::star::awt::XUserInputInterception
202                                                 >   OGenericUnoController_Base;
203 
204     struct OGenericUnoController_Data;
205     // ====================================================================
206     class DBACCESS_DLLPUBLIC OGenericUnoController
207                                 :public OGenericUnoController_MBASE
208                                 ,public OGenericUnoController_Base
209                                 ,public IController
210     {
211     private:
212         SupportedFeatures               m_aSupportedFeatures;
213         ::comphelper::NamedValueCollection
214                                         m_aInitParameters;
215 
216         ::std::auto_ptr< OGenericUnoController_Data >
217                                         m_pData;
218         ODataView*                      m_pView;                // our (VCL) "main window"
219 
220 #ifdef DBG_UTIL
221         bool                            m_bDescribingSupportedFeatures;
222 #endif
223 
224     protected:
225         // ----------------------------------------------------------------
226         // attributes
227         struct DispatchTarget
228         {
229             ::com::sun::star::util::URL                 aURL;
230             ::com::sun::star::uno::Reference< ::com::sun::star::frame::XStatusListener >    xListener;
231 
DispatchTargetdbaui::OGenericUnoController::DispatchTarget232             DispatchTarget() { }
DispatchTargetdbaui::OGenericUnoController::DispatchTarget233             DispatchTarget(const ::com::sun::star::util::URL& rURL, const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XStatusListener >  xRef) : aURL(rURL), xListener(xRef) { }
234         };
235 
236         DECLARE_STL_MAP( sal_uInt16, FeatureState, ::std::less< sal_uInt16 >, StateCache );
237         DECLARE_STL_VECTOR( DispatchTarget, Dispatch);
238 
239         FeatureListeners        m_aFeaturesToInvalidate;
240 
241         ::osl::Mutex            m_aFeatureMutex;        // locked when features are append to or remove from deque
242         StateCache              m_aStateCache;          // save the current status of feature state
243         Dispatch                m_arrStatusListener;    // all our listeners where we dispatch status changes
244         OAsyncronousLink        m_aAsyncInvalidateAll;
245         OAsyncronousLink        m_aAsyncCloseTask;      // called when a task shoud be closed
246 
247         ::com::sun::star::uno::Reference< ::com::sun::star::util::XURLTransformer >         m_xUrlTransformer;      // needed sometimes
248         ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >    m_xServiceFactory;
249         ControllerFrame                                                                     m_aCurrentFrame;
250         ::com::sun::star::uno::Reference< ::com::sun::star::frame::XDispatchProvider >      m_xSlaveDispatcher;     // for intercepting dispatches
251         ::com::sun::star::uno::Reference< ::com::sun::star::frame::XDispatchProvider >      m_xMasterDispatcher;    // dito
252         ::com::sun::star::uno::Reference< ::com::sun::star::container::XNameAccess >        m_xDatabaseContext;
253         ::com::sun::star::uno::Reference< ::com::sun::star::frame::XTitle >                 m_xTitleHelper;
254 
255         sal_Bool                m_bPreview;
256         sal_Bool                m_bReadOnly;
257 
258         sal_Bool                m_bCurrentlyModified    : 1;
259         sal_Bool                m_bExternalTitle : 1;
260 
261 
262 
263         // ----------------------------------------------------------------
264         // attribute access
getMutex() const265         ::osl::Mutex&               getMutex() const            { return OGenericUnoController_MBASE::getMutex(); }
getBroadcastHelper()266         ::cppu::OBroadcastHelper&   getBroadcastHelper()        { return OGenericUnoController_Base::rBHelper; }
267 
268         // ----------------------------------------------------------------
269         // methods
270         OGenericUnoController( const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >& _rM );
271         const ::comphelper::NamedValueCollection&
getInitParams() const272                                     getInitParams() const   { return m_aInitParameters; }
273 
274 
275         /** open the help agent for the given help id.
276             @param  _nHelpId
277                 The help id to dispatch.
278         */
279         void openHelpAgent( const rtl::OString& _sHelpId );
280 
281         /** open the help agent for the given help url.
282             @param  _pHelpStringURL
283                 The help url to dispatch.
284         */
285         void openHelpAgent( const rtl::OUString& _suHelpStringURL );
286 
287         /** opens the given Help URL in the help agent
288 
289             The URL does not need to be parsed already, it is passed through
290             XURLTransformer::parseStrict before it is used.
291         */
292         void openHelpAgent( const ::com::sun::star::util::URL& _rURL );
293 
294         // closes the task when possible
295         void closeTask();
296 
297         // if getMenu returns a non empty string than this will be dispatched at the frame
298         virtual void            loadMenu(const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XFrame >& _xFrame);
299 
300         /** called when our menu has been loaded into our frame, can be used to load sub toolbars
301 
302             @param _xLayoutManager
303                 The layout manager.
304         */
305         virtual void            onLoadedMenu(const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XLayoutManager >& _xLayoutManager);
306 
307         // all the features which should be handled by this class
308         virtual void            describeSupportedFeatures();
309 
310         // state of a feature. 'feature' may be the handle of a ::com::sun::star::util::URL somebody requested a dispatch interface for OR a toolbar slot.
311         virtual FeatureState    GetState(sal_uInt16 nId) const;
312         // execute a feature
313         virtual void            Execute(sal_uInt16 nId , const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue>& aArgs);
314 
315         /** describes a feature supported by the controller
316 
317             Must not be called outside <member>describeSupportedFeatures</member>.
318 
319             @param _pAsciiCommandURL
320                 the URL of the feature command
321             @param _nFeatureId
322                 the id of the feature. Later references to this feature usually happen by id, not by
323                 URL
324             @param _nCommandGroup
325                 the command group of the feature. This is important for configuring the controller UI
326                 by the user, see also <type scope="com::sun::star::frame">CommandGroup</type>.
327         */
328         void    implDescribeSupportedFeature(
329                     const sal_Char* _pAsciiCommandURL,
330                     sal_uInt16 _nFeatureId,
331                     sal_Int16 _nCommandGroup = ::com::sun::star::frame::CommandGroup::INTERNAL
332                 );
333 
334         /** returns <TRUE/> if the feature is supported, otherwise <FALSE/>
335             @param  _nId
336                 The ID of the feature.
337         */
338         sal_Bool isFeatureSupported( sal_Int32 _nId );
339 
340         // gets the URL which the given id is assigned to
341         ::com::sun::star::util::URL getURLForId(sal_Int32 _nId) const;
342 
343         /** determines whether the given feature ID denotes a user-defined feature
344 
345             @see IController::registerCommandURL
346         */
347         bool    isUserDefinedFeature( const sal_uInt16 nFeatureId ) const;
348 
349         /** determines whether the given feature URL denotes a user-defined feature
350 
351             @see IController::registerCommandURL
352         */
353         bool    isUserDefinedFeature( const ::rtl::OUString& _rFeatureURL ) const;
354 
355         // connect to a datasource
356         ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection > connect(
357             const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XDataSource>& _xDataSource,
358             ::dbtools::SQLExceptionInfo* _pErrorInfo
359         );
360 
361         // connect to a datasource
362         ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection > connect(
363             const ::rtl::OUString& _rsDataSourceName,
364             const ::rtl::OUString& _rContextInformation,
365             ::dbtools::SQLExceptionInfo* _pErrorInfo
366         );
367 
368         void startConnectionListening(const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection >& _rxConnection);
369         void stopConnectionListening(const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection >& _rxConnection);
370 
371         /** return the container window of the top most frame
372             @return
373                 The top most container window, nmay be <NULL/>.
374         */
375         ::com::sun::star::uno::Reference< ::com::sun::star::awt::XWindow> getTopMostContainerWindow() const;
376 
377         // XInitialize will be called inside initialize
378         virtual void impl_initialize();
379 
getPrivateTitle() const380         virtual ::rtl::OUString getPrivateTitle() const { return ::rtl::OUString(); }
381 
382         ::com::sun::star::uno::Reference< ::com::sun::star::frame::XTitle > impl_getTitleHelper_throw();
getPrivateModel() const383         virtual ::com::sun::star::uno::Reference< ::com::sun::star::frame::XModel > getPrivateModel() const
384         {
385             return ::com::sun::star::uno::Reference< ::com::sun::star::frame::XModel >();
386         }
387 
388         virtual void    startFrameListening( const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XFrame >& _rxFrame );
389         virtual void    stopFrameListening( const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XFrame >& _rxFrame );
390 
391         void releaseNumberForComponent();
392 
393         virtual ~OGenericUnoController();
394 
395     private:
396         void fillSupportedFeatures();
397 
398         void InvalidateAll_Impl();
399         void InvalidateFeature_Impl();
400 
401         void ImplInvalidateFeature( sal_Int32 _nId, const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XStatusListener >& _xListener, sal_Bool _bForceBroadcast );
402 
403         sal_Bool ImplInvalidateTBItem(sal_uInt16 nId, const FeatureState& rState);
404         void ImplBroadcastFeatureState(const ::rtl::OUString& _rFeature, const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XStatusListener > & xListener, sal_Bool _bIgnoreCache);
405 
406         // link methods
407         DECL_LINK(OnAsyncInvalidateAll, void*);
408         DECL_LINK(OnAsyncCloseTask, void*);
409 
410     public:
getORB() const411         ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >  getORB() const { return m_xServiceFactory; }
getView() const412         ODataView*  getView() const { return m_pView; }
setView(ODataView & i_rView)413         void        setView( ODataView& i_rView ) { m_pView = &i_rView; }
clearView()414         void        clearView() { m_pView = NULL; }
415         // shows a error box if the SQLExceptionInfo is valid
416         void showError(const ::dbtools::SQLExceptionInfo& _rInfo);
417 
418         // if xListener is NULL the change will be forwarded to all listeners to the given ::com::sun::star::util::URL
419         // if _bForceBroadcast is sal_True, the current feature state is broadcasted no matter if it is the same as the cached state
420         virtual void InvalidateFeature(const ::rtl::OUString& rURLPath, const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XStatusListener > & xListener = NULL, sal_Bool _bForceBroadcast = sal_False);
421         // if there is an ::com::sun::star::util::URL translation for the id ('handle') the preceding InvalidateFeature is used.
422         // if there is a toolbar slot with the given id it is updated (the new state is determined via GetState)
423         // if _bForceBroadcast is sal_True, the current feature state is broadcasted no matter if it is the same as the cached state
424         virtual void InvalidateFeature(sal_uInt16 nId, const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XStatusListener > & xListener = NULL, sal_Bool _bForceBroadcast = sal_False);
425 
426         /** InvalidateAll invalidates all features currently known
427         */
428         virtual void InvalidateAll();
429         // late construction
430         virtual sal_Bool Construct(Window* pParent);
431 
432         /** get the layout manager
433             @param  _xFrame
434                 The frame to ask for the layout manager.
435             @return
436                 The layout manager of the frame, can be <NULL/> if the frame isn't initialized.
437         */
438         ::com::sun::star::uno::Reference< ::com::sun::star::frame::XLayoutManager > getLayoutManager(const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XFrame >& _xFrame) const;
439 
440         // IController
441         virtual void executeUnChecked(const ::com::sun::star::util::URL& _rCommand, const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue>& aArgs);
442         virtual void executeChecked(const ::com::sun::star::util::URL& _rCommand, const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue>& aArgs);
443         virtual void executeUnChecked(sal_uInt16 _nCommandId, const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue>& aArgs);
444         virtual void executeChecked(sal_uInt16 _nCommandId, const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue>& aArgs);
445         virtual sal_Bool isCommandEnabled(sal_uInt16 _nCommandId) const;
446         virtual sal_Bool isCommandEnabled(const ::rtl::OUString& _rCompleteCommandURL) const;
447         virtual sal_uInt16 registerCommandURL( const ::rtl::OUString& _rCompleteCommandURL );
448         virtual void notifyHiContrastChanged();
449         virtual sal_Bool isDataSourceReadOnly() const;
450         virtual ::com::sun::star::uno::Reference< ::com::sun::star::frame::XController > getXController() throw( ::com::sun::star::uno::RuntimeException );
451         virtual bool interceptUserInput( const NotifyEvent& _rEvent );
452 
453         // misc
454         virtual sal_Bool isCommandChecked(sal_uInt16 _nCommandId) const;
455 
456         // ::com::sun::star::lang::XEventListener
457         virtual void SAL_CALL disposing(const ::com::sun::star::lang::EventObject& Source) throw( ::com::sun::star::uno::RuntimeException );
458 
459         // ::com::sun::star::util::XModifyListener
460         virtual void SAL_CALL modified(const ::com::sun::star::lang::EventObject& aEvent) throw( ::com::sun::star::uno::RuntimeException );
461 
462         // XInterface
463         virtual void SAL_CALL acquire(  ) throw ();
464         virtual void SAL_CALL release(  ) throw ();
465 
466         // ::com::sun::star::frame::XController2
467         virtual ::com::sun::star::uno::Reference< ::com::sun::star::awt::XWindow > SAL_CALL getComponentWindow() throw (::com::sun::star::uno::RuntimeException);
468         virtual ::rtl::OUString SAL_CALL getViewControllerName() throw (::com::sun::star::uno::RuntimeException);
469         virtual ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > SAL_CALL getCreationArguments() throw (::com::sun::star::uno::RuntimeException);
470 
471         // ::com::sun::star::frame::XController
472         virtual void SAL_CALL attachFrame(const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XFrame > & xFrame) throw( ::com::sun::star::uno::RuntimeException );
473         virtual sal_Bool SAL_CALL attachModel(const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XModel > & xModel) throw( ::com::sun::star::uno::RuntimeException );
474         virtual sal_Bool SAL_CALL suspend(sal_Bool bSuspend) throw( ::com::sun::star::uno::RuntimeException ) = 0;
475         virtual ::com::sun::star::uno::Any SAL_CALL getViewData(void) throw( ::com::sun::star::uno::RuntimeException );
476         virtual void SAL_CALL restoreViewData(const ::com::sun::star::uno::Any& Data) throw( ::com::sun::star::uno::RuntimeException );
477         virtual ::com::sun::star::uno::Reference< ::com::sun::star::frame::XModel >  SAL_CALL getModel(void) throw( ::com::sun::star::uno::RuntimeException );
478         virtual ::com::sun::star::uno::Reference< ::com::sun::star::frame::XFrame >  SAL_CALL getFrame(void) throw( ::com::sun::star::uno::RuntimeException );
479 
480         // ::com::sun::star::frame::XDispatch
481         virtual void        SAL_CALL dispatch(const ::com::sun::star::util::URL& aURL, const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue>& aArgs) throw(::com::sun::star::uno::RuntimeException);
482         virtual void        SAL_CALL addStatusListener(const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XStatusListener > & aListener, const ::com::sun::star::util::URL& aURL) throw(::com::sun::star::uno::RuntimeException);
483         virtual void        SAL_CALL removeStatusListener(const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XStatusListener > & aListener, const ::com::sun::star::util::URL& aURL) throw(::com::sun::star::uno::RuntimeException);
484 
485         // ::com::sun::star::frame::XDispatchProviderInterceptor
486         virtual ::com::sun::star::uno::Reference< ::com::sun::star::frame::XDispatchProvider >  SAL_CALL getSlaveDispatchProvider(void) throw(::com::sun::star::uno::RuntimeException);
487         virtual void SAL_CALL setSlaveDispatchProvider(const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XDispatchProvider > & _xNewProvider) throw(::com::sun::star::uno::RuntimeException);
488         virtual ::com::sun::star::uno::Reference< ::com::sun::star::frame::XDispatchProvider >  SAL_CALL getMasterDispatchProvider(void) throw(::com::sun::star::uno::RuntimeException);
489         virtual void SAL_CALL setMasterDispatchProvider(const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XDispatchProvider > & _xNewProvider) throw(::com::sun::star::uno::RuntimeException);
490 
491         // ::com::sun::star::frame::XDispatchProvider
492         virtual ::com::sun::star::uno::Reference< ::com::sun::star::frame::XDispatch >  SAL_CALL queryDispatch(const ::com::sun::star::util::URL& aURL, const ::rtl::OUString& aTargetFrameName, sal_Int32 nSearchFlags) throw( ::com::sun::star::uno::RuntimeException );
493         virtual ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Reference< ::com::sun::star::frame::XDispatch >  > SAL_CALL queryDispatches(const ::com::sun::star::uno::Sequence< ::com::sun::star::frame::DispatchDescriptor >& aDescripts) throw( ::com::sun::star::uno::RuntimeException );
494 
495         // ::com::sun::star::lang::XComponent
496         virtual void SAL_CALL dispose() throw(::com::sun::star::uno::RuntimeException); //LLA: need solar mutex {OGenericUnoController_COMPBASE::dispose(); }
497         virtual void SAL_CALL disposing();
498         virtual void SAL_CALL addEventListener(const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XEventListener > & aListener) throw(::com::sun::star::uno::RuntimeException);
499         virtual void SAL_CALL removeEventListener(const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XEventListener > & aListener) throw(::com::sun::star::uno::RuntimeException);
500 
501         // ::com::sun::star::frame::XFrameActionListener
502         virtual void        SAL_CALL frameAction(const ::com::sun::star::frame::FrameActionEvent& aEvent) throw( ::com::sun::star::uno::RuntimeException );
503         // lang::XInitialization
504         virtual void SAL_CALL initialize( const ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Any >& aArguments ) throw(::com::sun::star::uno::Exception, ::com::sun::star::uno::RuntimeException);
505 
506         // XServiceInfo
507         virtual ::rtl::OUString SAL_CALL getImplementationName() throw(::com::sun::star::uno::RuntimeException) = 0;
508         virtual sal_Bool SAL_CALL supportsService(const ::rtl::OUString& ServiceName) throw(::com::sun::star::uno::RuntimeException);
509         virtual ::com::sun::star::uno::Sequence< ::rtl::OUString> SAL_CALL getSupportedServiceNames() throw(::com::sun::star::uno::RuntimeException) = 0;
510 
511         // XDispatchInformationProvider
512         virtual ::com::sun::star::uno::Sequence< ::sal_Int16 > SAL_CALL getSupportedCommandGroups() throw (::com::sun::star::uno::RuntimeException);
513         virtual ::com::sun::star::uno::Sequence< ::com::sun::star::frame::DispatchInformation > SAL_CALL getConfigurableDispatchInformation( ::sal_Int16 ) throw (::com::sun::star::uno::RuntimeException);
514 
515         // XTitle
516         virtual ::rtl::OUString SAL_CALL getTitle(  ) throw (::com::sun::star::uno::RuntimeException);
517         virtual void SAL_CALL setTitle( const ::rtl::OUString& sTitle ) throw (::com::sun::star::uno::RuntimeException);
518 
519         // XTitleChangeBroadcaster
520         virtual void SAL_CALL addTitleChangeListener( const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XTitleChangeListener >& xListener ) throw (::com::sun::star::uno::RuntimeException);
521         virtual void SAL_CALL removeTitleChangeListener( const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XTitleChangeListener >& xListener ) throw (::com::sun::star::uno::RuntimeException);
522 
523         // XUserInputInterception
524         virtual void SAL_CALL addKeyHandler( const ::com::sun::star::uno::Reference< ::com::sun::star::awt::XKeyHandler >& xHandler ) throw (::com::sun::star::uno::RuntimeException);
525         virtual void SAL_CALL removeKeyHandler( const ::com::sun::star::uno::Reference< ::com::sun::star::awt::XKeyHandler >& xHandler ) throw (::com::sun::star::uno::RuntimeException);
526         virtual void SAL_CALL addMouseClickHandler( const ::com::sun::star::uno::Reference< ::com::sun::star::awt::XMouseClickHandler >& xHandler ) throw (::com::sun::star::uno::RuntimeException);
527         virtual void SAL_CALL removeMouseClickHandler( const ::com::sun::star::uno::Reference< ::com::sun::star::awt::XMouseClickHandler >& xHandler ) throw (::com::sun::star::uno::RuntimeException);
528 
529     protected:
530 #ifdef WNT
531         OGenericUnoController();    // never implemented
532 #endif
533     };
534 }
535 
536 #endif //DBAUI_GENERICCONTROLLER_HXX
537 
538 
539