1 files changed, 151 insertions, 0 deletions
diff --git a/sd/source/ui/framework/configuration/ConfigurationControllerBroadcaster.hxx b/sd/source/ui/framework/configuration/ConfigurationControllerBroadcaster.hxx
new file mode 100644
index 000000000000..a5939386d7b7
--- /dev/null
+++ b/sd/source/ui/framework/configuration/ConfigurationControllerBroadcaster.hxx
@@ -0,0 +1,151 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org 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 version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org.  If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef SD_FRAMEWORK_CONFIGURATION_CONTROLLER_BROADCASTER_HXX
+#define SD_FRAMEWORK_CONFIGURATION_CONTROLLER_BROADCASTER_HXX
+
+#include <com/sun/star/drawing/framework/XConfigurationChangeListener.hpp>
+#include <com/sun/star/drawing/framework/XConfigurationController.hpp>
+#include <com/sun/star/drawing/framework/ConfigurationChangeEvent.hpp>
+
+#include <comphelper/stl_types.hxx>
+#include <vector>
+#include <hash_map>
+
+namespace css = ::com::sun::star;
+
+namespace sd { namespace framework {
+
+/** This class manages the set of XConfigurationChangeListeners and
+    calls them when the ConfigurationController wants to broadcast an
+    event.
+
+    For every registered combination of listener and event type a user data
+    object is stored.  This user data object is then given to the listener
+    whenever it is called for an event.  With this the listener can use
+    a switch statement to handle different event types.
+*/
+class ConfigurationControllerBroadcaster
+{
+public:
+    /** The given controller is used as origin of thrown exceptions.
+    */
+    ConfigurationControllerBroadcaster (
+        const css::uno::Reference<
+            css::drawing::framework::XConfigurationController>& rxController);
+
+    /** Add a listener for one type of event.  When one listener is
+        interested in more than one event type this method has to be called
+        once for every event type.  Alternatively it can register as
+        universal listener that will be called for all event types.
+        @param rxListener
+            A valid reference to a listener.
+        @param rsEventType
+            The type of event that the listener will be called for.  The
+            empty string is a special value in that the listener will be
+            called for all event types.
+        @param rUserData
+            This object is passed to the listener whenever it is called for
+            the specified event type.  For different event types different
+            user data objects can be provided.
+        @throws IllegalArgumentException
+            when an empty listener reference is given.
+    */
+    void AddListener(
+        const css::uno::Reference<
+            css::drawing::framework::XConfigurationChangeListener>& rxListener,
+        const ::rtl::OUString& rsEventType,
+        const css::uno::Any& rUserData);
+
+    /** Remove all references to the given listener.  When one listener has
+        been registered for more than one type of event then it is removed
+        for all of them.
+        @param rxListener
+            A valid reference to a listener.
+        @throws IllegalArgumentException
+            when an empty listener reference is given.
+    */
+    void RemoveListener(
+        const css::uno::Reference<
+            css::drawing::framework::XConfigurationChangeListener>& rxListener);
+
+    /** Broadcast the given event to all listeners that have been registered
+        for its type of event as well as all universal listeners.
+
+        When calling a listener results in a DisposedException being thrown
+        the listener is unregistered automatically.
+    */
+    void NotifyListeners (
+        const css::drawing::framework::ConfigurationChangeEvent& rEvent);
+
+    /** This convenience variant of NotifyListeners create the event from
+        the given arguments.
+    */
+    void NotifyListeners (
+        const ::rtl::OUString& rsEventType,
+        const ::css::uno::Reference<css::drawing::framework::XResourceId>& rxResourceId,
+        const ::css::uno::Reference<css::drawing::framework::XResource>& rxResourceObject);
+
+    /** Call all listeners and inform them that the
+        ConfigurationController is being disposed.  When this method returns
+        the list of registered listeners is empty.  Further calls to
+        RemoveListener() are not necessary but do not result in an error.
+    */
+    void DisposeAndClear (void);
+
+private:
+    css::uno::Reference<
+        com::sun::star::drawing::framework::XConfigurationController> mxConfigurationController;
+    class ListenerDescriptor {public:
+        css::uno::Reference<
+            css::drawing::framework::XConfigurationChangeListener> mxListener;
+        css::uno::Any maUserData;
+    };
+    typedef ::std::vector<ListenerDescriptor> ListenerList;
+    typedef ::std::hash_map
+        <rtl::OUString,
+         ListenerList,
+         ::comphelper::UStringHash,
+         ::comphelper::UStringEqual> ListenerMap;
+    ListenerMap maListenerMap;
+
+    /** Broadcast the given event to all listeners in the given list.
+
+        When calling a listener results in a DisposedException being thrown
+        the listener is unregistered automatically.
+    */
+    void NotifyListeners (
+        const ListenerList& rList,
+        const css::drawing::framework::ConfigurationChangeEvent& rEvent);
+};
+
+
+
+
+} } // end of namespace sd::framework
+
+#endif