#79955# move to dispatch dir

4 files changed, 1512 insertions, 0 deletions

diff --git a/framework/inc/dispatch/helpagentdispatcher.hxx b/framework/inc/dispatch/helpagentdispatcher.hxx
new file mode 100644
index 0000000000..b9218087f9
--- /dev/null
+++ b/framework/inc/dispatch/helpagentdispatcher.hxx
@@ -0,0 +1,225 @@
+/*************************************************************************
+ *
+ *  $RCSfile: helpagentdispatcher.hxx,v $
+ *
+ *  $Revision: 1.1 $
+ *
+ *  last change: $Author: as $ $Date: 2001-07-02 13:23:13 $
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 by Sun Microsystems, Inc.
+ *  901 San Antonio Road, Palo Alto, CA 94303, USA
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Lesser General Public
+ *  License version 2.1, as published by the Free Software Foundation.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+ *  MA  02111-1307  USA
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc..
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+#ifndef __FRAMEWORK_DISPATCH_HELPAGENTDISPATCHER_HXX_
+#define __FRAMEWORK_DISPATCH_HELPAGENTDISPATCHER_HXX_
+
+#ifndef __FRAMEWORK_THREADHELP_THREADHELPBASE_HXX_
+#include <threadhelp/threadhelpbase.hxx>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XDISPATCH_HPP_
+#include <com/sun/star/frame/XDispatch.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XFRAME_HPP_
+#include <com/sun/star/frame/XFrame.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_AWT_XWINDOWLISTENER_HPP_
+#include <com/sun/star/awt/XWindowListener.hpp>
+#endif
+
+#ifndef _CPPUHELPER_IMPLBASE2_HXX_
+#include <cppuhelper/implbase2.hxx>
+#endif
+
+#ifndef _OSL_MUTEX_HXX_
+#include <osl/mutex.hxx>
+#endif
+
+#ifndef _VOS_REF_HXX_
+#include <vos/ref.hxx>
+#endif
+
+#ifndef _FRAMEWORK_HELPER_TIMERHELPER_HXX_
+#include <helper/timerhelper.hxx>
+#endif
+
+#ifndef _SVTOOLS_HELPAGENTWIDNOW_HXX_
+#include <svtools/helpagentwindow.hxx>
+#endif
+
+class Window;
+
+//........................................................................
+namespace framework
+{
+//........................................................................
+
+    //====================================================================
+    //= OHelpAgentDispatcher
+    //====================================================================
+    typedef ::cppu::WeakImplHelper2	<	::com::sun::star::frame::XDispatch
+                                    ,	::com::sun::star::awt::XWindowListener
+                                    >	OHelpAgent_Base;
+
+    class HelpAgentDispatcher
+            :private ThreadHelpBase
+            ,public OHelpAgent_Base
+            ,public ITimerListener
+            ,public ::svt::IHelpAgentCallback
+    {
+    protected:
+        ::rtl::OUString		m_sCurrentURL;
+
+        Window*				m_pContainerWindow;		// parent of the agent window.
+        ::svt::HelpAgentWindow*
+                            m_pAgentWindow;			// the agent window itself
+
+        ::com::sun::star::uno::Reference< ::com::sun::star::frame::XFrame >
+                            m_xParentFrame;			// weak reference to the frame we're responsible for
+
+        ::vos::ORef< OTimerHelper >
+                            m_xAutoCloseTimer;
+
+    public:
+        HelpAgentDispatcher( const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XFrame >& _rxParentFrame );
+
+    protected:
+        ~HelpAgentDispatcher();
+
+        // ::com::sun::star::frame::XDispatch
+        virtual void SAL_CALL dispatch( const ::com::sun::star::util::URL& _rURL, const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& _rArgs ) throw (::com::sun::star::uno::RuntimeException);
+        virtual void SAL_CALL addStatusListener( const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XStatusListener >& _rxListener, const ::com::sun::star::util::URL& _rURL ) throw (::com::sun::star::uno::RuntimeException);
+        virtual void SAL_CALL removeStatusListener( const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XStatusListener >& _rxListener, const ::com::sun::star::util::URL& _rURL ) throw (::com::sun::star::uno::RuntimeException);
+
+        // ::com::sun::star::awt::XWindowListener
+        virtual void SAL_CALL windowResized( const ::com::sun::star::awt::WindowEvent& _rSource ) throw (::com::sun::star::uno::RuntimeException);
+        virtual void SAL_CALL windowMoved( const ::com::sun::star::awt::WindowEvent& _rSource ) throw (::com::sun::star::uno::RuntimeException);
+        virtual void SAL_CALL windowShown( const ::com::sun::star::lang::EventObject& _rSource ) throw (::com::sun::star::uno::RuntimeException);
+        virtual void SAL_CALL windowHidden( const ::com::sun::star::lang::EventObject& _rSource ) throw (::com::sun::star::uno::RuntimeException);
+
+        // ::com::sun::star::lang::XEventListener
+        virtual void SAL_CALL disposing( const ::com::sun::star::lang::EventObject& _rSource ) throw (::com::sun::star::uno::RuntimeException);
+
+    protected:
+        void	implConstruct( const ::com::sun::star::uno::Reference< ::com::sun::star::awt::XWindow >& _rxContainer );
+
+        /// switches the agent to a new URL
+        void		switchURL(const ::com::sun::star::util::URL& _rURL);
+
+        /// ensures that the agent's window exists and is visible
+        sal_Bool	ensureAgentWindow();
+        /// check if the agent window exists
+        sal_Bool	haveAgentWindow() const { return (NULL != m_pAgentWindow); }
+        /** destroyes the agent window
+            <p>This method has to be called with m_aMutex aqcuired _exactly_ once!</p>
+        */
+        void		closeAgentWindow();
+
+        /** positions the help agent's window in an optimal position
+            <p>At the moment, this is a lie. The agent's window will always be placed in the
+            lower right corner of the parent window.</p>
+        */
+        void		positionAgentWindow();
+
+        /// stops the timer which triggers the auto close event
+        void		stopAutoCloseTimer();
+        /// starts the timer which triggers the auto close event
+        void		startAutoCloseTimer();
+
+        /** ensures that m_pContainerWindow is set
+        */
+        sal_Bool	ensureContainerWindow();
+
+        /** checks whether or not the given is on the ignore list
+        */
+        sal_Bool	approveURLRequest(const ::com::sun::star::util::URL& _rURL);
+
+        /** mark the given URL as "ignored once more"
+        */
+        void		markURLIgnored( const ::rtl::OUString& _rURL );
+
+        /// to be called when the agent window has been closed by an external instance
+        void		agentClosedExternally();
+
+    protected:
+        // ITimerListener overridables
+        virtual void	timerExpired();
+
+        // IHelpAgentCallback overridables
+        virtual void	helpRequested();
+        virtual void	closeAgent();
+    };
+
+//........................................................................
+}	// namespace framework
+//........................................................................
+
+#endif // _FRAMEWORK_DISPATCH_HELPAGENTDISPATCHER_HXX_
+
+/*************************************************************************
+ * history:
+ *	$Log: not supported by cvs2svn $
+ *	Revision 1.3  2001/06/11 10:14:25  as
+ *	#85529# use new lock mechanism
+ *
+ *	Revision 1.2  2001/05/07 15:05:17  fs
+ *	moved the HelpAgentWindow implementation to SVTOOLS (prevent creating a new resource file here)
+ *
+ *	Revision 1.1  2001/05/07 13:39:50  fs
+ *	initial checkin - help agent dispatcher
+ *
+ *
+ *	Revision 1.0 03.05.01 11:28:28  fs
+ ************************************************************************/
+
diff --git a/framework/inc/dispatch/interceptionhelper.hxx b/framework/inc/dispatch/interceptionhelper.hxx
new file mode 100644
index 0000000000..9206eb274c
--- /dev/null
+++ b/framework/inc/dispatch/interceptionhelper.hxx
@@ -0,0 +1,416 @@
+/*************************************************************************
+ *
+ *  $RCSfile: interceptionhelper.hxx,v $
+ *
+ *  $Revision: 1.1 $
+ *
+ *  last change: $Author: as $ $Date: 2001-07-02 13:20:35 $
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 by Sun Microsystems, Inc.
+ *  901 San Antonio Road, Palo Alto, CA 94303, USA
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Lesser General Public
+ *  License version 2.1, as published by the Free Software Foundation.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+ *  MA  02111-1307  USA
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc.
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+#ifndef __FRAMEWORK_HELPER_INTERCEPTIONHELPER_HXX_
+#define __FRAMEWORK_HELPER_INTERCEPTIONHELPER_HXX_
+
+//_________________________________________________________________________________________________________________
+//	my own includes
+//_________________________________________________________________________________________________________________
+
+#ifndef __FRAMEWORK_MACROS_GENERIC_HXX_
+#include <macros/generic.hxx>
+#endif
+
+#ifndef __FRAMEWORK_MACROS_XINTERFACE_HXX_
+#include <macros/xinterface.hxx>
+#endif
+
+#ifndef __FRAMEWORK_MACROS_DEBUG_HXX_
+#include <macros/debug.hxx>
+#endif
+
+#ifndef __FRAMEWORK_THREADHELP_THREADHELPBASE_HXX_
+#include <threadhelp/threadhelpbase.hxx>
+#endif
+
+#ifndef __FRAMEWORK_SERVICES_FRAME_HXX_
+#include <services/frame.hxx>
+#endif
+
+#ifndef __FRAMEWORK_GENERAL_H_
+#include <general.h>
+#endif
+
+//_________________________________________________________________________________________________________________
+//	interface includes
+//_________________________________________________________________________________________________________________
+
+#ifndef _COM_SUN_STAR_LANG_XMULTISERVICEFACTORY_HPP_
+#include <com/sun/star/lang/XMultiServiceFactory.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XDISPATCHPROVIDERINTERCEPTION_HPP_
+#include <com/sun/star/frame/XDispatchProviderInterception.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XDISPATCHPROVIDERINTERCEPTOR_HPP_
+#include <com/sun/star/frame/XDispatchProviderInterceptor.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XDISPATCHPROVIDER_HPP_
+#include <com/sun/star/frame/XDispatchProvider.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XDISPATCH_HPP_
+#include <com/sun/star/frame/XDispatch.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XFRAME_HPP_
+#include <com/sun/star/frame/XFrame.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_DISPATCHDESCRIPTOR_HPP_
+#include <com/sun/star/frame/DispatchDescriptor.hpp>
+#endif
+
+//_________________________________________________________________________________________________________________
+//	other includes
+//_________________________________________________________________________________________________________________
+
+#ifndef _CPPUHELPER_WEAK_HXX_
+#include <cppuhelper/weak.hxx>
+#endif
+
+#ifndef _CPPUHELPER_WEAKREF_HXX_
+#include <cppuhelper/weakref.hxx>
+#endif
+
+#ifndef __SGI_STL_DEQUE
+#include <deque>
+#endif
+
+//_________________________________________________________________________________________________________________
+//	namespace
+//_________________________________________________________________________________________________________________
+
+namespace framework{
+
+//_________________________________________________________________________________________________________________
+//	exported const
+//_________________________________________________________________________________________________________________
+
+//_________________________________________________________________________________________________________________
+//	exported definitions
+//_________________________________________________________________________________________________________________
+
+/*-************************************************************************************************************//**
+    We must save a performant list with URL pattern for all registered interceptor objects.
+    We implement this as a dynamical vector of interceptor references with a URL list for every item.
+*//*-*************************************************************************************************************/
+
+struct	IMPL_TInterceptorInfo
+{
+    css::uno::Reference< css::frame::XDispatchProviderInterceptor >	xInterceptor	;
+    css::uno::Sequence< ::rtl::OUString >							seqPatternList	;
+};
+
+class IMPL_CInterceptorList : public ::std::deque< IMPL_TInterceptorInfo >
+{
+    public:
+        // Implement our own find method to search for an interceptor in our list of structures!
+        // We can't search for it directly with ::std::find_if() or something else.
+        iterator find( const css::uno::Reference< css::frame::XDispatchProviderInterceptor >& xInterceptor )
+        {
+            // I hope that the iterator has a right implemented ++operator and we arrive end() exactly!
+            // If it is so - we can use aItem->... without any problems and must not check it.
+            iterator aItem;
+            for( aItem=begin(); aItem!=end(); ++aItem )
+            {
+                if( aItem->xInterceptor == xInterceptor )
+                {
+                    break;
+                }
+            }
+            return aItem;
+        }
+};
+
+/*-************************************************************************************************************//**
+    @short          implement a helper to support interception with additional functionality
+    @descr			These helper implement the complete XDispatchProviderInterception interface with
+                    master/slave functionality AND using of optional features like URL lists!
+
+    @implements		XInterface
+                    XDispatchProviderInterception
+    @base			ThreadHelpBase
+                    OWeakObject
+
+    @attention		Don't use this class as direct member - use it dynamicly. Do not derive from this class.
+                    We hold a weakreference to ouer owner not to ouer superclass.
+
+    @devstatus		ready to use
+    @threadsafe		yes
+*//*-*************************************************************************************************************/
+
+class InterceptionHelper   :   public css::frame::XDispatchProvider                ,
+                                public css::frame::XDispatchProviderInterception	,
+                                public css::lang::XEventListener					,
+                                public ThreadHelpBase									,
+                                public ::cppu::OWeakObject
+{
+    //-------------------------------------------------------------------------------------------------------------
+    //	public methods
+    //-------------------------------------------------------------------------------------------------------------
+
+    public:
+
+        //---------------------------------------------------------------------------------------------------------
+        //	constructor / destructor
+        //---------------------------------------------------------------------------------------------------------
+
+        /*-****************************************************************************************************//**
+            @short		standard ctor
+            @descr		These initialize a new instance of this class with all needed informations for work.
+                        We share mutex with owner implementation and hold a weakreference to it!
+
+            @seealso	-
+
+            @param		"xSlaveDispatcher"	, reference to a dispatch helper of our owner. We need it as slave for registered interceptors.
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        InterceptionHelper(    const   css::uno::Reference< css::frame::XFrame >&              xFrame              ,
+                                const	css::uno::Reference< css::frame::XDispatchProvider >&	xSlaveDispatcher	);
+
+        //---------------------------------------------------------------------------------------------------------
+        //	XInterface
+        //---------------------------------------------------------------------------------------------------------
+
+        DECLARE_XINTERFACE
+
+        //---------------------------------------------------------------------------------------------------------
+        //	XDispatchProvider
+        //---------------------------------------------------------------------------------------------------------
+
+        /*-****************************************************************************************************//**
+            @short      query for a dispatcher for given parameter
+            @descr		If somebody will dispatch a URL he must have a valid dispatch object to do it.
+                        With these function you he can get these object ... if target exist or could create!
+                        If an interceptor is registered for given URL we used - otherwise not.
+
+            @seealso	interface XDispatch
+            @seealso	method queryDispatches()
+
+            @param		"aURL"				, the URL to dispatch
+            @param		"sTargetFrameName"	, the name of the target frame or a special name like "_blank", "_top" ...
+            @param		"nSearchFlags"		, optional search parameter for targeting
+            @return		-
+
+            @onerror	A null reference is returned.
+        *//*-*****************************************************************************************************/
+
+        virtual css::uno::Reference< css::frame::XDispatch > SAL_CALL queryDispatch(	const	css::util::URL&		aURL			,
+                                                                                        const	::rtl::OUString&	sTargetFrameName,
+                                                                                                sal_Int32			nSearchFlags	) throw( css::uno::RuntimeException );
+
+        /*-****************************************************************************************************//**
+            @short      query for more then one dispatcher at the same time
+            @descr		These function do the same like queryDispatch() before, but for a lot of URLs at the same time.
+                        A registered interceptor is used automaticly.
+
+            @seealso	interface XDispatch
+            @seealso	method queryDispatch()
+
+            @param		"aDescriptor", list to describe more then one dispatches
+            @return		-
+
+            @onerror	An empty list is returned or if one dispatch was wrong one result is missing!
+        *//*-*****************************************************************************************************/
+
+        virtual css::uno::Sequence< css::uno::Reference< css::frame::XDispatch > > SAL_CALL queryDispatches( const css::uno::Sequence< css::frame::DispatchDescriptor >& seqDescriptor ) throw( css::uno::RuntimeException );
+
+        //---------------------------------------------------------------------------------------------------------
+        //	XDispatchProviderInterception
+        //---------------------------------------------------------------------------------------------------------
+
+        /*-****************************************************************************************************//**
+            @short      register an interceptor for dispatches
+            @descr		Somebody can register himself to intercept all or some special dispatches.
+                        It's depend from his supported interfaces. If he implement XInterceptorInfo
+                        he his called for some special URLs only - otherwise we call it for every request!
+
+            @seealso	interface XDispatchProviderInterceptor
+            @seealso	interface XInterceptorInfo
+            @seealso	method releaseDispatchProviderInterceptor()
+
+            @param		"xInterceptor", reference to interceptor for register
+            @return		-
+
+            @onerror	Listener is'nt added to our container.
+        *//*-*****************************************************************************************************/
+
+        virtual void SAL_CALL registerDispatchProviderInterceptor( const css::uno::Reference< css::frame::XDispatchProviderInterceptor >& xInterceptor ) throw( css::uno::RuntimeException );
+
+        /*-****************************************************************************************************//**
+            @short      release an interceptor for dispatches
+            @descr		Remove registered interceptor from our internal list and all special informations about him.
+
+            @seealso	method registerDispatchProviderInterceptor()
+
+            @param		"xInterceptor", reference to interceptor for release
+            @return		-
+
+            @onerror	Listener is'nt removed from our container.
+        *//*-*****************************************************************************************************/
+
+        virtual void SAL_CALL releaseDispatchProviderInterceptor( const css::uno::Reference< css::frame::XDispatchProviderInterceptor >& xInterceptor ) throw( css::uno::RuntimeException );
+
+        //---------------------------------------------------------------------------------------------------------
+        //	XEventListener
+        //---------------------------------------------------------------------------------------------------------
+
+        virtual void SAL_CALL disposing( const css::lang::EventObject& Source ) throw ( css::uno::RuntimeException );
+
+    //-------------------------------------------------------------------------------------------------------------
+    //	protected methods
+    //-------------------------------------------------------------------------------------------------------------
+
+    protected:
+
+        /*-****************************************************************************************************//**
+            @short		standard destructor
+            @descr		This method destruct an instance of this class and clear some member.
+                        This method is protected, because its not allowed to use this class as a direct member!
+                        You MUST use a dynamical instance (pointer). That's the reason for a protected dtor.
+
+            @seealso	-
+
+            @param		-
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        virtual ~InterceptionHelper();
+
+    //-------------------------------------------------------------------------------------------------------------
+    //	private methods
+    //-------------------------------------------------------------------------------------------------------------
+
+    private:
+
+        /*-****************************************************************************************************//**
+            @short		search an interceptor which is registered for given URL
+            @descr		We search in our list to get the right interceptor, which wish to intercept these URL.
+                        We don't must use the highest one!
+
+            @seealso	-
+
+            @param		"sURL", URL which must match with a registered pattern
+            @return		Reference to a registered interceptor for these URL or NULL if no object was found.
+
+            @onerror	A null reference is returned.
+        *//*-*****************************************************************************************************/
+
+        css::uno::Reference< css::frame::XDispatchProviderInterceptor > impl_searchMatchingInterceptor( const ::rtl::OUString& sURL );
+
+    //-------------------------------------------------------------------------------------------------------------
+    //	debug methods
+    //	(should be private everyway!)
+    //-------------------------------------------------------------------------------------------------------------
+
+        /*-****************************************************************************************************//**
+            @short		debug-method to check incoming parameter of some other mehods of this class
+            @descr		The following methods are used to check parameters for other methods
+                        of this class. The return value is used directly for an ASSERT(...).
+
+            @seealso	ASSERTs in implementation!
+
+            @param		references to checking variables
+            @return		sal_False ,on invalid parameter
+            @return		sal_True  ,otherwise
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+    #ifdef ENABLE_ASSERTIONS
+
+    private:
+
+        static sal_Bool impldbg_checkParameter_InterceptionHelper                  (   const   css::uno::Reference< css::frame::XDispatchProvider >&               xSlaveDispatcher);
+        static sal_Bool impldbg_checkParameter_queryDispatch						(	const	css::util::URL&														aURL			,
+                                                                                        const	::rtl::OUString&													sTargetFrameName,
+                                                                                                sal_Int32															nSearchFlags	);
+        static sal_Bool impldbg_checkParameter_queryDispatches						(	const	css::uno::Sequence< css::frame::DispatchDescriptor >&				seqDescriptor	);
+        static sal_Bool impldbg_checkParameter_registerDispatchProviderInterceptor	(	const	css::uno::Reference< css::frame::XDispatchProviderInterceptor >&	xInterceptor	);
+        static sal_Bool impldbg_checkParameter_releaseDispatchProviderInterceptor	(	const	css::uno::Reference< css::frame::XDispatchProviderInterceptor >&	xInterceptor	);
+
+    #endif	// #ifdef ENABLE_ASSERTIONS
+
+    //-------------------------------------------------------------------------------------------------------------
+    //	variables
+    //	(should be private everyway!)
+    //-------------------------------------------------------------------------------------------------------------
+
+    private:
+
+        css::uno::WeakReference< css::frame::XFrame >					m_xOwnerWeak			;	/// weakreference to owner (Don't use a hard reference. Owner can't delete us then!)
+        css::uno::Reference< css::frame::XDispatchProvider >			m_xSlaveDispatcher		;	/// helper for XDispatchProvider and XDispatch interfaces
+        IMPL_CInterceptorList											m_aInterceptorList		;	/// an interceptor can register himself for a list of URLs or URL pattern
+
+};      //  class InterceptionHelper
+
+}		//	namespace framework
+
+#endif  //  #ifndef __FRAMEWORK_HELPER_INTERCEPTIONHELPER_HXX_
diff --git a/framework/inc/dispatch/mailtodispatcher.hxx b/framework/inc/dispatch/mailtodispatcher.hxx
new file mode 100644
index 0000000000..e66c3fc4ea
--- /dev/null
+++ b/framework/inc/dispatch/mailtodispatcher.hxx
@@ -0,0 +1,423 @@
+/*************************************************************************
+ *
+ *  $RCSfile: mailtodispatcher.hxx,v $
+ *
+ *  $Revision: 1.1 $
+ *
+ *  last change: $Author: as $ $Date: 2001-07-02 13:22:39 $
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 by Sun Microsystems, Inc.
+ *  901 San Antonio Road, Palo Alto, CA 94303, USA
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Lesser General Public
+ *  License version 2.1, as published by the Free Software Foundation.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+ *  MA  02111-1307  USA
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc.
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+#ifndef __FRAMEWORK_DISPATCH_MAILTODISPATCHER_HXX_
+#define __FRAMEWORK_DISPATCH_MAILTODISPATCHER_HXX_
+
+//_________________________________________________________________________________________________________________
+//	my own includes
+//_________________________________________________________________________________________________________________
+
+#ifndef __FRAMEWORK_CLASSES_TASKCREATOR_HXX_
+#include <classes/taskcreator.hxx>
+#endif
+
+#ifndef __FRAMEWORK_SERVICES_FRAME_HXX_
+#include <services/frame.hxx>
+#endif
+
+#ifndef __FRAMEWORK_MACROS_GENERIC_HXX_
+#include <macros/generic.hxx>
+#endif
+
+#ifndef __FRAMEWORK_MACROS_XINTERFACE_HXX_
+#include <macros/xinterface.hxx>
+#endif
+
+#ifndef __FRAMEWORK_MACROS_XTYPEPROVIDER_HXX_
+#include <macros/xtypeprovider.hxx>
+#endif
+
+#ifndef __FRAMEWORK_MACROS_DEBUG_HXX_
+#include <macros/debug.hxx>
+#endif
+
+#ifndef __FRAMEWORK_THREADHELP_THREADHELPBASE_HXX_
+#include <threadhelp/threadhelpbase.hxx>
+#endif
+
+#ifndef __FRAMEWORK_GENERAL_H_
+#include <general.h>
+#endif
+
+#ifndef __FRAMEWORK_STDTYPES_H_
+#include <stdtypes.h>
+#endif
+
+//_________________________________________________________________________________________________________________
+//	interface includes
+//_________________________________________________________________________________________________________________
+
+#ifndef _COM_SUN_STAR_LANG_XTYPEPROVIDER_HPP_
+#include <com/sun/star/lang/XTypeProvider.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XDISPATCH_HPP_
+#include <com/sun/star/frame/XDispatch.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_UTIL_URL_HPP_
+#include <com/sun/star/util/URL.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_DISPATCHDESCRIPTOR_HPP_
+#include <com/sun/star/frame/DispatchDescriptor.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_BEANS_PROPERTYVALUE_HPP_
+#include <com/sun/star/beans/PropertyValue.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XSTATUSLISTENER_HPP_
+#include <com/sun/star/frame/XStatusListener.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XFRAMELOADER_HPP_
+#include <com/sun/star/frame/XFrameLoader.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XLOADEVENTLISTENER_HPP_
+#include <com/sun/star/frame/XLoadEventListener.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XDESKTOP_HPP_
+#include <com/sun/star/frame/XDesktop.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XTASK_HPP_
+#include <com/sun/star/frame/XTask.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_FEATURESTATEEVENT_HPP_
+#include <com/sun/star/frame/FeatureStateEvent.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XFRAMEACTIONLISTENER_HPP_
+#include <com/sun/star/frame/XFrameActionListener.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_SYSTEM_XSIMPLEMAILCLIENTSUPPLIER_HPP_
+#include <com/sun/star/system/XSimpleMailClientSupplier.hpp>
+#endif
+
+//_________________________________________________________________________________________________________________
+//	other includes
+//_________________________________________________________________________________________________________________
+
+#ifndef _CPPUHELPER_WEAK_HXX_
+#include <cppuhelper/weak.hxx>
+#endif
+
+#ifndef _CPPUHELPER_WEAKREF_HXX_
+#include <cppuhelper/weakref.hxx>
+#endif
+
+#ifndef _CPPUHELPER_INTERFACECONTAINER_H_
+#include <cppuhelper/interfacecontainer.h>
+#endif
+
+//_________________________________________________________________________________________________________________
+//	namespace
+//_________________________________________________________________________________________________________________
+
+namespace framework{
+
+typedef ::cppu::OMultiTypeInterfaceContainerHelperVar<	::rtl::OUString			,
+                                                        OUStringHashCode		,
+                                                        std::equal_to< ::rtl::OUString > > IMPL_ListenerHashContainer;
+
+
+//_________________________________________________________________________________________________________________
+//	exported const
+//_________________________________________________________________________________________________________________
+
+//_________________________________________________________________________________________________________________
+//	exported definitions
+//_________________________________________________________________________________________________________________
+
+
+/*-************************************************************************************************************//**
+    @short			helper for desktop only(!) to create new tasks on demand for dispatches
+    @descr			Use this class as member only! Never use it as baseclass.
+                    XInterface will be ambigous and we hold a weakcss::uno::Reference to ouer OWNER - not to ouer SUPERCLASS!
+
+    @implements		XInterface
+                    XDispatch
+                    XLoadEventListener
+                    XFrameActionListener
+                    XEventListener
+    @base			OMutexMember
+                    OWeakObject
+
+    @devstatus		ready to use
+*//*-*************************************************************************************************************/
+class MailToDispatcher :   // interfaces
+                                public css::lang::XTypeProvider			,
+                                public css::frame::XDispatch			,
+                                public css::lang::XEventListener		,
+                                // baseclasses
+                                // Order is neccessary for right initialization!
+                                public ThreadHelpBase					,
+                                public cppu::OWeakObject
+{
+    //-------------------------------------------------------------------------------------------------------------
+    //	public methods
+    //-------------------------------------------------------------------------------------------------------------
+
+    public:
+
+        //---------------------------------------------------------------------------------------------------------
+        //	constructor / destructor
+        //---------------------------------------------------------------------------------------------------------
+
+        /*-****************************************************************************************************//**
+            @short		standard ctor
+            @descr		These initialize a new instance of ths class with needed informations for work.
+
+            @seealso	using at owner
+
+            @param		"xFactory"	, css::uno::Reference to servicemanager for creation of new services
+            @param		"xOwner"	, css::uno::Reference to our owner, the Desktop!!!
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        MailToDispatcher(  const   css::uno::Reference< css::lang::XMultiServiceFactory >& xFactory    ,
+                            const	css::uno::Reference< css::frame::XFrame >&				xOwner		);
+
+        //---------------------------------------------------------------------------------------------------------
+        //	XInterface
+        //---------------------------------------------------------------------------------------------------------
+
+        DECLARE_XINTERFACE
+        DECLARE_XTYPEPROVIDER
+
+        //---------------------------------------------------------------------------------------------------------
+        //	XDispatch
+        //---------------------------------------------------------------------------------------------------------
+
+        /*-****************************************************************************************************//**
+            @short      dispatch URL with arguments
+            @descr		Every dispatch create a new task. If load of URL failed task will deleted automaticly!
+
+            @seealso	-
+
+            @param		"aURL"			, URL to dispatch.
+            @param		"seqArguments"	, list of optional arguments.
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        virtual void SAL_CALL dispatch(	const	css::util::URL&										aURL			,
+                                        const	css::uno::Sequence< css::beans::PropertyValue >&	seqProperties	) throw( css::uno::RuntimeException );
+
+        /*-****************************************************************************************************//**
+            @short      add listener for state events
+            @descr		You can add a listener to get information about status of dispatch: OK or Failed.
+
+            @seealso	method loadFinished()
+            @seealso	method loadCancelled()
+
+            @param		"xControl"	, css::uno::Reference to a valid listener for state events.
+            @param		"aURL"		, URL about listener will be informed, if something occured.
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        virtual void SAL_CALL addStatusListener(	const	css::uno::Reference< css::frame::XStatusListener >&	xControl,
+                                                    const	css::util::URL&										aURL	) throw( css::uno::RuntimeException );
+
+        /*-****************************************************************************************************//**
+            @short      remove listener for state events
+            @descr		You can remove a listener if information of dispatch isn't important for you any longer.
+
+            @seealso	method loadFinished()
+            @seealso	method loadCancelled()
+
+            @param		"xControl"	, css::uno::Reference to a valid listener.
+            @param		"aURL"		, URL on which listener has registered.
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        virtual void SAL_CALL removeStatusListener(	const	css::uno::Reference< css::frame::XStatusListener >&	xControl,
+                                                    const	css::util::URL&										aURL	) throw( css::uno::RuntimeException );
+
+
+        //---------------------------------------------------------------------------------------------------------
+        //	 XEventListener
+        //---------------------------------------------------------------------------------------------------------
+
+        /*-****************************************************************************************************//**
+            @short		dispose current instance
+            @descr		If service helper isn't required any longer call this method to release all used ressources.
+
+            @seealso	-
+
+            @param		"aEvent", information about source of this event.
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        void SAL_CALL disposing( const css::lang::EventObject& aEvent ) throw( css::uno::RuntimeException );
+
+    //-------------------------------------------------------------------------------------------------------------
+    //	protected methods
+    //-------------------------------------------------------------------------------------------------------------
+
+    protected:
+
+        /*-****************************************************************************************************//**
+            @short		standard destructor
+            @descr		This method destruct an instance of this class and clear some member.
+                        This method is protected, because its not allowed to use an instance of this class as a member!
+                        You MUST use a pointer.
+
+            @seealso	-
+
+            @param		-
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        virtual ~MailToDispatcher();
+
+    //-------------------------------------------------------------------------------------------------------------
+    //	private methods
+    //-------------------------------------------------------------------------------------------------------------
+
+    private:
+
+        /*-****************************************************************************************************//**
+            @short		-
+            @descr		-
+
+            @seealso	-
+
+            @param		-
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        void impl_sendStatusEvent(	const	css::uno::Reference< css::frame::XFrame >&	xEventSource	,
+                                    const	::rtl::OUString&							sURL			,
+                                            sal_Bool    								bLoadState		);
+
+
+        void impl_getSequenceFromStringList( css::uno::Sequence< ::rtl::OUString >&, const ::rtl::OUString& );
+
+    //-------------------------------------------------------------------------------------------------------------
+    //	debug methods
+    //	(should be private everyway!)
+    //-------------------------------------------------------------------------------------------------------------
+
+        /*-****************************************************************************************************//**
+            @short		debug-method to check incoming parameter of some other mehods of this class
+            @descr		The following methods are used to check parameters for other methods
+                        of this class. The return value is used directly for an ASSERT(...).
+
+            @seealso	ASSERTs in implementation!
+
+            @param		css::uno::References to checking variables
+            @return		sal_False on invalid parameter<BR>
+                        sal_True  otherway
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+    #ifdef ENABLE_ASSERTIONS
+
+    private:
+
+        static sal_Bool impldbg_checkParameter_MailToDispatcher    (   const   css::uno::Reference< css::lang::XMultiServiceFactory >& xFactory        ,
+                                                                        const	css::uno::Reference< css::frame::XFrame >&				xOwner			);
+        static sal_Bool impldbg_checkParameter_dispatch				(	const	css::util::URL&											aURL			,
+                                                                        const	css::uno::Sequence< css::beans::PropertyValue >&		seqArguments	);
+        static sal_Bool impldbg_checkParameter_addStatusListener	(	const	css::uno::Reference< css::frame::XStatusListener >&		xControl		,
+                                                                        const	css::util::URL&											aURL			);
+        static sal_Bool impldbg_checkParameter_removeStatusListener	(	const	css::uno::Reference< css::frame::XStatusListener >&		xControl		,
+                                                                        const	css::util::URL&											aURL			);
+    #endif	// #ifdef ENABLE_ASSERTIONS
+
+    //-------------------------------------------------------------------------------------------------------------
+    //	variables
+    //	(should be private everyway!)
+    //-------------------------------------------------------------------------------------------------------------
+
+    private:
+
+        css::uno::WeakReference< css::frame::XFrame >					m_xOwnerWeak		;			/// css::uno::WeakReference to owner (Don't use a hard css::uno::Reference. Owner can't delete us then!)
+        css::uno::Reference< css::lang::XMultiServiceFactory >			m_xFactory			;			/// factory shared with our owner to create new services!
+        IMPL_ListenerHashContainer										m_aListenerContainer;			/// hash table for listener at specified URLs
+        sal_Bool														m_bAlreadyDisposed	;			/// Protection against multiple disposing calls.
+        css::uno::Reference< css::system::XSimpleMailClientSupplier >	m_xSimpleMailClientSupplier;	/// simple mail client supplier
+};      //  class MailToDispatcher
+
+}		//	namespace framework
+
+#endif  //  #ifndef __FRAMEWORK_DISPATCH_MAILTODISPATCHER_HXX_
diff --git a/framework/inc/dispatch/menudispatcher.hxx b/framework/inc/dispatch/menudispatcher.hxx
new file mode 100644
index 0000000000..e6726b8c21
--- /dev/null
+++ b/framework/inc/dispatch/menudispatcher.hxx
@@ -0,0 +1,448 @@
+/*************************************************************************
+ *
+ *  $RCSfile: menudispatcher.hxx,v $
+ *
+ *  $Revision: 1.1 $
+ *
+ *  last change: $Author: as $ $Date: 2001-07-02 13:22:14 $
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 by Sun Microsystems, Inc.
+ *  901 San Antonio Road, Palo Alto, CA 94303, USA
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Lesser General Public
+ *  License version 2.1, as published by the Free Software Foundation.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+ *  MA  02111-1307  USA
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc.
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+#ifndef __FRAMEWORK_DISPATCH_MENUDISPATCHER_HXX_
+#define __FRAMEWORK_DISPATCH_MENUDISPATCHER_HXX_
+
+//_________________________________________________________________________________________________________________
+//	my own includes
+//_________________________________________________________________________________________________________________
+
+#ifndef __FRAMEWORK_CLASSES_TASKCREATOR_HXX_
+#include <classes/taskcreator.hxx>
+#endif
+
+#ifndef __FRAMEWORK_SERVICES_FRAME_HXX_
+#include <services/frame.hxx>
+#endif
+
+#ifndef __FRAMEWORK_MACROS_GENERIC_HXX_
+#include <macros/generic.hxx>
+#endif
+
+#ifndef __FRAMEWORK_MACROS_XINTERFACE_HXX_
+#include <macros/xinterface.hxx>
+#endif
+
+#ifndef __FRAMEWORK_MACROS_XTYPEPROVIDER_HXX_
+#include <macros/xtypeprovider.hxx>
+#endif
+
+#ifndef __FRAMEWORK_MACROS_DEBUG_HXX_
+#include <macros/debug.hxx>
+#endif
+
+#ifndef __FRAMEWORK_THREADHELP_THREADHELPBASE_HXX_
+#include <threadhelp/threadhelpbase.hxx>
+#endif
+
+#ifndef __FRAMEWORK_CLASSES_MENUMANAGER_HXX_
+#include <classes/menumanager.hxx>
+#endif
+
+#ifndef __FRAMEWORK_GENERAL_H_
+#include <general.h>
+#endif
+
+#ifndef __FRAMEWORK_STDTYPES_H_
+#include <stdtypes.h>
+#endif
+
+//_________________________________________________________________________________________________________________
+//	interface includes
+//_________________________________________________________________________________________________________________
+
+#ifndef _COM_SUN_STAR_LANG_XTYPEPROVIDER_HPP_
+#include <com/sun/star/lang/XTypeProvider.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XDISPATCH_HPP_
+#include <com/sun/star/frame/XDispatch.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_UTIL_URL_HPP_
+#include <com/sun/star/util/URL.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_DISPATCHDESCRIPTOR_HPP_
+#include <com/sun/star/frame/DispatchDescriptor.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_BEANS_PROPERTYVALUE_HPP_
+#include <com/sun/star/beans/PropertyValue.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XSTATUSLISTENER_HPP_
+#include <com/sun/star/frame/XStatusListener.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XFRAMELOADER_HPP_
+#include <com/sun/star/frame/XFrameLoader.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XLOADEVENTLISTENER_HPP_
+#include <com/sun/star/frame/XLoadEventListener.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XDESKTOP_HPP_
+#include <com/sun/star/frame/XDesktop.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XTASK_HPP_
+#include <com/sun/star/frame/XTask.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_FEATURESTATEEVENT_HPP_
+#include <com/sun/star/frame/FeatureStateEvent.hpp>
+#endif
+
+#ifndef _COM_SUN_STAR_FRAME_XFRAMEACTIONLISTENER_HPP_
+#include <com/sun/star/frame/XFrameActionListener.hpp>
+#endif
+
+//_________________________________________________________________________________________________________________
+//	other includes
+//_________________________________________________________________________________________________________________
+
+#ifndef _CPPUHELPER_WEAK_HXX_
+#include <cppuhelper/weak.hxx>
+#endif
+
+#ifndef _CPPUHELPER_WEAKREF_HXX_
+#include <cppuhelper/weakref.hxx>
+#endif
+
+#ifndef _CPPUHELPER_INTERFACECONTAINER_H_
+#include <cppuhelper/interfacecontainer.h>
+#endif
+
+//_________________________________________________________________________________________________________________
+//	namespace
+//_________________________________________________________________________________________________________________
+
+namespace framework{
+
+
+//_________________________________________________________________________________________________________________
+//	exported const
+//_________________________________________________________________________________________________________________
+
+//_________________________________________________________________________________________________________________
+//	exported definitions
+//_________________________________________________________________________________________________________________
+
+/*-************************************************************************************************************//**
+    We must save informations about our listener and URL for listening.
+    We implement this as a hashtable for strings.
+*//*-*************************************************************************************************************/
+
+typedef ::cppu::OMultiTypeInterfaceContainerHelperVar<	::rtl::OUString			,
+                                                        OUStringHashCode		,
+                                                        std::equal_to< ::rtl::OUString > > IMPL_ListenerHashContainer;
+
+
+/*-************************************************************************************************************//**
+    @short			helper for desktop only(!) to create new tasks on demand for dispatches
+    @descr			Use this class as member only! Never use it as baseclass.
+                    XInterface will be ambigous and we hold a weakcss::uno::Reference to ouer OWNER - not to ouer SUPERCLASS!
+
+    @implements		XInterface
+                    XDispatch
+                    XLoadEventListener
+                    XFrameActionListener
+                    XEventListener
+    @base			ThreadHelpBase
+                    OWeakObject
+
+    @devstatus		ready to use
+*//*-*************************************************************************************************************/
+class MenuDispatcher   :   // interfaces
+                                public css::lang::XTypeProvider			,
+                                public css::frame::XDispatch			,
+                                public css::frame::XFrameActionListener	,
+                                // baseclasses
+                                // Order is neccessary for right initialization!
+                                public ThreadHelpBase						,
+                                public cppu::OWeakObject
+{
+    //-------------------------------------------------------------------------------------------------------------
+    //	public methods
+    //-------------------------------------------------------------------------------------------------------------
+
+    public:
+
+        //---------------------------------------------------------------------------------------------------------
+        //	constructor / destructor
+        //---------------------------------------------------------------------------------------------------------
+
+        /*-****************************************************************************************************//**
+            @short		standard ctor
+            @descr		These initialize a new instance of ths class with needed informations for work.
+
+            @seealso	using at owner
+
+            @param		"xFactory"	, css::uno::Reference to servicemanager for creation of new services
+            @param		"xOwner"	, css::uno::Reference to our owner, the Desktop!!!
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        MenuDispatcher(    const   css::uno::Reference< css::lang::XMultiServiceFactory >& xFactory    ,
+                            const	css::uno::Reference< css::frame::XFrame >&				xOwner		);
+
+        //---------------------------------------------------------------------------------------------------------
+        //	XInterface
+        //---------------------------------------------------------------------------------------------------------
+
+        DECLARE_XINTERFACE
+        DECLARE_XTYPEPROVIDER
+
+        //---------------------------------------------------------------------------------------------------------
+        //	XDispatch
+        //---------------------------------------------------------------------------------------------------------
+
+        /*-****************************************************************************************************//**
+            @short      dispatch URL with arguments
+            @descr		Every dispatch create a new task. If load of URL failed task will deleted automaticly!
+
+            @seealso	-
+
+            @param		"aURL"			, URL to dispatch.
+            @param		"seqArguments"	, list of optional arguments.
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        virtual void SAL_CALL dispatch(	const	css::util::URL&										aURL			,
+                                        const	css::uno::Sequence< css::beans::PropertyValue >&	seqProperties	) throw( css::uno::RuntimeException );
+
+        /*-****************************************************************************************************//**
+            @short      add listener for state events
+            @descr		You can add a listener to get information about status of dispatch: OK or Failed.
+
+            @seealso	method loadFinished()
+            @seealso	method loadCancelled()
+
+            @param		"xControl"	, css::uno::Reference to a valid listener for state events.
+            @param		"aURL"		, URL about listener will be informed, if something occured.
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        virtual void SAL_CALL addStatusListener(	const	css::uno::Reference< css::frame::XStatusListener >&	xControl,
+                                                    const	css::util::URL&										aURL	) throw( css::uno::RuntimeException );
+
+        /*-****************************************************************************************************//**
+            @short      remove listener for state events
+            @descr		You can remove a listener if information of dispatch isn't important for you any longer.
+
+            @seealso	method loadFinished()
+            @seealso	method loadCancelled()
+
+            @param		"xControl"	, css::uno::Reference to a valid listener.
+            @param		"aURL"		, URL on which listener has registered.
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        virtual void SAL_CALL removeStatusListener(	const	css::uno::Reference< css::frame::XStatusListener >&	xControl,
+                                                    const	css::util::URL&										aURL	) throw( css::uno::RuntimeException );
+
+
+        //---------------------------------------------------------------------------------------------------------
+        //	 XFrameActionListener
+        //---------------------------------------------------------------------------------------------------------
+
+        virtual void SAL_CALL frameAction( const css::frame::FrameActionEvent& aEvent ) throw ( css::uno::RuntimeException );
+
+        //---------------------------------------------------------------------------------------------------------
+        //	 XEventListener
+        //---------------------------------------------------------------------------------------------------------
+
+        /*-****************************************************************************************************//**
+            @short		dispose current instance
+            @descr		If service helper isn't required any longer call this method to release all used ressources.
+
+            @seealso	-
+
+            @param		"aEvent", information about source of this event.
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        void SAL_CALL disposing( const EVENTOBJECT& aEvent ) throw( css::uno::RuntimeException );
+
+    //-------------------------------------------------------------------------------------------------------------
+    //	protected methods
+    //-------------------------------------------------------------------------------------------------------------
+
+    protected:
+
+        /*-****************************************************************************************************//**
+            @short		standard destructor
+            @descr		This method destruct an instance of this class and clear some member.
+                        This method is protected, because its not allowed to use an instance of this class as a member!
+                        You MUST use a pointer.
+
+            @seealso	-
+
+            @param		-
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        virtual ~MenuDispatcher();
+
+    //-------------------------------------------------------------------------------------------------------------
+    //	private methods
+    //-------------------------------------------------------------------------------------------------------------
+
+    private:
+
+        /*-****************************************************************************************************//**
+            @short		-
+            @descr		-
+
+            @seealso	-
+
+            @param		-
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        void impl_sendStatusEvent(	const	css::uno::Reference< XFRAME >&	xEventSource	,
+                                    const	::rtl::OUString&		sURL			,
+                                            sal_Bool    			bLoadState		);
+
+
+        /*-****************************************************************************************************//**
+            @short		-
+            @descr		-
+
+            @seealso	-
+
+            @param		-
+            @return		-
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+        sal_Bool impl_setMenuBar( MenuBar* pMenuBar, sal_Bool bMenuFromResource = sal_False );
+
+    //-------------------------------------------------------------------------------------------------------------
+    //	debug methods
+    //	(should be private everyway!)
+    //-------------------------------------------------------------------------------------------------------------
+
+        /*-****************************************************************************************************//**
+            @short		debug-method to check incoming parameter of some other mehods of this class
+            @descr		The following methods are used to check parameters for other methods
+                        of this class. The return value is used directly for an ASSERT(...).
+
+            @seealso	ASSERTs in implementation!
+
+            @param		css::uno::References to checking variables
+            @return		sal_False on invalid parameter<BR>
+                        sal_True  otherway
+
+            @onerror	-
+        *//*-*****************************************************************************************************/
+
+    #ifdef ENABLE_ASSERTIONS
+
+    private:
+
+        static sal_Bool impldbg_checkParameter_MenuDispatcher      (   const   css::uno::Reference< css::lang::XMultiServiceFactory >& xFactory        ,
+                                                                        const	css::uno::Reference< css::frame::XFrame >&				xOwner			);
+        static sal_Bool impldbg_checkParameter_dispatch				(	const	css::util::URL&											aURL			,
+                                                                        const	css::uno::Sequence< css::beans::PropertyValue >&		seqArguments	);
+        static sal_Bool impldbg_checkParameter_addStatusListener	(	const	css::uno::Reference< css::frame::XStatusListener >&		xControl		,
+                                                                        const	css::util::URL&											aURL			);
+        static sal_Bool impldbg_checkParameter_removeStatusListener	(	const	css::uno::Reference< css::frame::XStatusListener >&		xControl		,
+                                                                        const	css::util::URL&											aURL			);
+    #endif	// #ifdef ENABLE_ASSERTIONS
+
+    //-------------------------------------------------------------------------------------------------------------
+    //	variables
+    //	(should be private everyway!)
+    //-------------------------------------------------------------------------------------------------------------
+
+    private:
+
+        css::uno::WeakReference< css::frame::XFrame >			m_xOwnerWeak		;	/// css::uno::WeakReference to owner (Don't use a hard css::uno::Reference. Owner can't delete us then!)
+        css::uno::Reference< css::lang::XMultiServiceFactory >	m_xFactory			;	/// factory shared with our owner to create new services!
+        IMPL_ListenerHashContainer								m_aListenerContainer;	/// hash table for listener at specified URLs
+        sal_Bool												m_bAlreadyDisposed	;	/// Protection against multiple disposing calls.
+        sal_Bool												m_bActivateListener ;	/// dispatcher is listener for frame activation
+        MenuManager*											m_pMenuManager		;	/// menu manager controlling menu dispatches
+
+};      //  class MenuDispatcher
+
+}		//	namespace framework
+
+#endif  //  #ifndef __FRAMEWORK_DISPATCH_MENUDISPATCHER_HXX_