Adding upstream version 4:7.4.7.upstream/4%7.4.7upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 161 insertions, 0 deletions

diff --git a/framework/inc/helper/ocomponentaccess.hxx b/framework/inc/helper/ocomponentaccess.hxx
new file mode 100644
index 000000000..9c444953a
--- /dev/null
+++ b/framework/inc/helper/ocomponentaccess.hxx
@@ -0,0 +1,161 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ *   Licensed to the Apache Software Foundation (ASF) under one or more
+ *   contributor license agreements. See the NOTICE file distributed
+ *   with this work for additional information regarding copyright
+ *   ownership. The ASF licenses this file to you under the Apache
+ *   License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0 .
+ */
+
+#pragma once
+
+#include <com/sun/star/frame/XFramesSupplier.hpp>
+#include <com/sun/star/container/XEnumerationAccess.hpp>
+#include <com/sun/star/container/XEnumeration.hpp>
+#include <com/sun/star/frame/XDesktop.hpp>
+#include <com/sun/star/lang/XComponent.hpp>
+
+#include <cppuhelper/implbase.hxx>
+#include <cppuhelper/weakref.hxx>
+#include <vector>
+
+namespace framework{
+
+/*-************************************************************************************************************
+    @short          implement XEnumerationAccess interface as helper to create many oneway enumeration of components
+    @descr          We share mutex and framecontainer with our owner and have full access to its child tasks.
+                    (Our owner can be the Desktop only!) We create oneway enumerations on demand. These "lists"
+                    can be used for one time only. Step during the list from first to last element.
+                    (The type of created enumerations is OComponentEnumeration.)
+
+    @implements     XInterface
+                    XTypeProvider
+                    XEnumerationAccess
+                    XElementAccess
+
+    @base           OWeakObject
+
+    @devstatus      ready to use
+*//*-*************************************************************************************************************/
+
+class OComponentAccess final : public ::cppu::WeakImplHelper< css::container::XEnumerationAccess >
+{
+
+    //  public methods
+
+    public:
+
+        //  constructor / destructor
+
+        /*-****************************************************************************************************
+            @short      constructor to initialize this instance
+            @descr      A desktop will create an enumeration-access-object. An enumeration is a oneway-list and a
+                        snapshot of the components of current tasks under the desktop.
+                        But we need an instance to create more than one enumerations at different times!
+
+            @seealso    class Desktop
+            @seealso    class OComponentEnumeration
+
+            @param      "xOwner" is a reference to our owner and must be the desktop!
+            @onerror    Do nothing and reset this object to default with an empty list.
+        *//*-*****************************************************************************************************/
+
+        OComponentAccess( const css::uno::Reference< css::frame::XDesktop >& xOwner );
+
+        //  XEnumerationAccess
+
+        /*-****************************************************************************************************
+            @short      create a new enumeration of components
+            @descr      You can call this method to get a new snapshot from all components of all tasks of the desktop as an enumeration.
+
+            @seealso    interface XEnumerationAccess
+            @seealso    interface XEnumeration
+            @seealso    class Desktop
+            @return     If the desktop and some components exist => a valid reference to an enumeration<BR>
+                        An NULL-reference, other way.
+        *//*-*****************************************************************************************************/
+
+        virtual css::uno::Reference< css::container::XEnumeration > SAL_CALL createEnumeration() override;
+
+        //  XElementAccess
+
+        /*-****************************************************************************************************
+            @short      get the type of elements in enumeration
+            @seealso    interface XElementAccess
+            @seealso    class OComponentEnumeration
+            @return     The uno-type XComponent.
+        *//*-*****************************************************************************************************/
+
+        virtual css::uno::Type SAL_CALL getElementType() override;
+
+        /*-****************************************************************************************************
+            @short      get state of componentlist of enumeration.
+            @seealso    interface XElementAccess
+            @return     sal_True  ,if more than 0 elements exist.
+            @return     sal_False ,otherwise.
+        *//*-*****************************************************************************************************/
+
+        virtual sal_Bool SAL_CALL hasElements() override;
+
+    //  protected methods
+
+    private:
+
+        /*-****************************************************************************************************
+            @short      standard destructor
+            @descr      This method destruct an instance of this class and clear some member.
+                        Don't use an instance of this class as normal member. Use it dynamically with a pointer.
+                        We hold a weakreference to our owner and not to our superclass!
+                        That's the reason for a protected dtor.
+
+            @seealso    class Desktop
+        *//*-*****************************************************************************************************/
+
+        virtual ~OComponentAccess() override;
+
+
+        /*-****************************************************************************************************
+            @short      recursive method (!) to collect all components of all frames from the subtree of given node
+            @descr      This is necessary to create the enumeration.
+
+            @seealso    method createEnumeration
+
+            @param      "xNode"        , root of subtree and start point of search
+            @param      "seqComponents", result list of search. We can't use a return value, we search recursive
+                                         and must collect all information.
+        *//*-*****************************************************************************************************/
+
+        void impl_collectAllChildComponents(    const   css::uno::Reference< css::frame::XFramesSupplier >&            xNode           ,
+                                                        std::vector< css::uno::Reference< css::lang::XComponent > >&   seqComponents   );
+
+        /*-****************************************************************************************************
+            @short      get the component of a frame
+            @descr      The component of a frame can be the window, the controller or the model.
+
+            @seealso    method createEnumeration
+
+            @param      "xFrame", frame which contains the component
+            @return     A reference to the component of given frame.
+
+            @onerror    A null reference is returned.
+        *//*-*****************************************************************************************************/
+
+        css::uno::Reference< css::lang::XComponent > impl_getFrameComponent( const css::uno::Reference< css::frame::XFrame >& xFrame ) const;
+
+        css::uno::WeakReference< css::frame::XDesktop >     m_xOwner;   /// weak reference to the desktop object!
+
+};      //  class OComponentAccess
+
+}       //  namespace framework
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */