forms/source/inc/formnavigation.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 #ifndef INCLUDED_FORMS_SOURCE_INC_FORMNAVIGATION_HXX
  21 #define INCLUDED_FORMS_SOURCE_INC_FORMNAVIGATION_HXX
  22
  23 #include <com/sun/star/frame/XDispatchProviderInterception.hpp>
  24 #include <com/sun/star/frame/XStatusListener.hpp>
  25 #include <com/sun/star/lang/XMultiServiceFactory.hpp>
  26 #include <com/sun/star/uno/XComponentContext.hpp>
  27 #include <com/sun/star/util/XURLTransformer.hpp>
  28 #include <cppuhelper/implbase2.hxx>
  29 #include "featuredispatcher.hxx"
  30 #include <vector>
  31 #include <map>
  32 #include <memory>
  33
  34
  35 namespace frm
  36 {
  37
  38
  39     class UrlTransformer;
  40     class ControlFeatureInterception;
  41
  42
  43     //= OFormNavigationHelper
  44
  45     typedef ::cppu::ImplHelper2 <   css::frame::XDispatchProviderInterception
  46                                 ,   css::frame::XStatusListener
  47                                 >   OFormNavigationHelper_Base;
  48
  49     class OFormNavigationHelper
  50                         :public OFormNavigationHelper_Base
  51                         ,public IFeatureDispatcher
  52     {
  53     private:
  54         struct FeatureInfo
  55         {
  56             css::util::URL                                             aURL;
  57             css::uno::Reference< css::frame::XDispatch >               xDispatcher;
  58             bool                                                       bCachedState;
  59             css::uno::Any                                              aCachedAdditionalState;
  60
  61             FeatureInfo() : bCachedState( false ) { }
  62         };
  63         typedef ::std::map< sal_Int16, FeatureInfo >    FeatureMap;
  64
  65     private:
  66         css::uno::Reference< css::uno::XComponentContext >
  67                             m_xORB;
  68         ::std::unique_ptr< ControlFeatureInterception >
  69                             m_pFeatureInterception;
  70
  71         // all supported features
  72         FeatureMap          m_aSupportedFeatures;
  73         // all features which we have an external dispatcher for
  74         sal_Int32           m_nConnectedFeatures;
  75
  76     protected:
  77         OFormNavigationHelper( const css::uno::Reference< css::uno::XComponentContext >& _rxORB );
  78         virtual ~OFormNavigationHelper();
  79
  80         // XComponent
  81         void SAL_CALL dispose(  ) throw( css::uno::RuntimeException );
  82
  83         // XDispatchProviderInterception
  84         virtual void SAL_CALL registerDispatchProviderInterceptor( const css::uno::Reference< css::frame::XDispatchProviderInterceptor >& Interceptor ) throw (css::uno::RuntimeException, std::exception) override;
  85         virtual void SAL_CALL releaseDispatchProviderInterceptor( const css::uno::Reference< css::frame::XDispatchProviderInterceptor >& Interceptor ) throw (css::uno::RuntimeException, std::exception) override;
  86
  87         // XStatusListener
  88         virtual void SAL_CALL statusChanged( const css::frame::FeatureStateEvent& State ) throw (css::uno::RuntimeException, std::exception) override;
  89
  90         // XEventListener
  91         virtual void SAL_CALL disposing( const css::lang::EventObject& Source ) throw (css::uno::RuntimeException, std::exception) override;
  92
  93         // IFeatureDispatcher
  94         virtual void            dispatch( sal_Int16 _nFeatureId ) const override;
  95         virtual void            dispatchWithArgument( sal_Int16 _nFeatureId, const sal_Char* _pParamName, const css::uno::Any& _rParamValue ) const override;
  96         virtual bool            isEnabled( sal_Int16 _nFeatureId ) const override;
  97         virtual bool            getBooleanState( sal_Int16 _nFeatureId ) const override;
  98         virtual OUString getStringState( sal_Int16 _nFeatureId ) const override;
  99         virtual sal_Int32       getIntegerState( sal_Int16 _nFeatureId ) const override;
 100
 101         // own overridables
 102         /** is called when the interceptors have.
 103             <p>The default implementations simply calls <member>updateDispatches</member>,
 104             derived classes can prevent this in certain cases, or do additional handling.</p>
 105         */
 106         virtual void    interceptorsChanged( );
 107
 108         /** called when the status of a feature changed
 109
 110             <p>The default implementation does nothing.</p>
 111
 112             <p>If the feature in question does support more state information that just the
 113             enabled/disabled state, then this additional information is to be retrieved in
 114             a separate call.</p>
 115
 116             @param _nFeatureId
 117                 the id of the feature
 118             @param _bEnabled
 119                 determines if the features is enabled or disabled
 120             @see getBooleanState
 121         */
 122         virtual void    featureStateChanged( sal_Int16 _nFeatureId, bool _bEnabled );
 123
 124         /** notification for (potential) changes in the state of all features
 125             <p>The base class implementation does nothing. Derived classes could force
 126             their peer to update it's state, depending on the result of calls to
 127             <member>IFeatureDispatcher::isEnabled</member>.</p>
 128         */
 129         virtual void    allFeatureStatesChanged( );
 130
 131         /** retrieves the list of supported features
 132             <p>To be overridden by derived classes</p>
 133             @param _rFeatureIds
 134                 the array of features to support. Out parameter to fill by the derivee's implementation
 135             @pure
 136         */
 137         virtual void    getSupportedFeatures( ::std::vector< sal_Int16 >& /* [out] */ _rFeatureIds ) = 0;
 138
 139     protected:
 140         /** update all our dispatches which are controlled by our dispatch interceptors
 141         */
 142         void    updateDispatches();
 143
 144         /** connect to the dispatch interceptors
 145         */
 146         void    connectDispatchers();
 147
 148         /** disconnect from the dispatch interceptors
 149         */
 150         void    disconnectDispatchers();
 151
 152         /** queries the interceptor chain for a dispatcher for the given URL
 153         */
 154         css::uno::Reference< css::frame::XDispatch >
 155                 queryDispatch( const css::util::URL& _rURL );
 156
 157         /** invalidates the set of supported features
 158
 159             <p>This will invalidate all structures which are tied to the set of supported
 160             features. All dispatches will be disconnected.<br/>
 161             No automatic re-connection to potential external dispatchers is done, instead,
 162             you have to call updateDispatches explicitly, if necessary.</p>
 163         */
 164         void    invalidateSupportedFeaturesSet();
 165
 166     private:
 167         /** initialize m_aSupportedFeatures, if necessary
 168         */
 169         void    initializeSupportedFeatures();
 170     };
 171
 172     /** helper class mapping between feature ids and feature URLs
 173     */
 174     class OFormNavigationMapper
 175     {
 176     private:
 177         ::std::unique_ptr< UrlTransformer >   m_pUrlTransformer;
 178
 179     public:
 180         OFormNavigationMapper(
 181             const css::uno::Reference< css::uno::XComponentContext >& _rxORB
 182         );
 183         ~OFormNavigationMapper( );
 184
 185         /** retrieves the ASCII representation of a feature URL belonging to an id
 186
 187             @complexity O(log n)
 188             @return NULL if the given id is not a known feature id (which is a valid usage)
 189         */
 190         static const char* getFeatureURLAscii( sal_Int16 _nFeatureId );
 191
 192         /** retrieves the feature URL belonging to an feature id
 193
 194             @complexity O(log n), with n being the number of all potentially known URLs
 195             @return
 196                 <TRUE/> if and only if the given id is a known feature id
 197                 (which is a valid usage)
 198         */
 199         bool        getFeatureURL( sal_Int16 _nFeatureId, css::util::URL& /* [out] */ _rURL );
 200
 201         /** retrieves the feature id belonging to an feature URL
 202
 203             @complexity O(n), with n being the number of all potentially known URLs
 204             @return
 205                 the id of the feature URL, or -1 if the URl is not known
 206                 (which is a valid usage)
 207         */
 208         static sal_Int16 getFeatureId( const OUString& _rCompleteURL );
 209
 210     private:
 211         OFormNavigationMapper( const OFormNavigationMapper& ) = delete;
 212         OFormNavigationMapper& operator=( const OFormNavigationMapper& ) = delete;
 213     };
 214
 215
 216 }   // namespace frm
 217
 218
 219 #endif // INCLUDED_FORMS_SOURCE_INC_FORMNAVIGATION_HXX
 220
 221 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */