summaryrefslogtreecommitdiffstats
path: root/framework/inc/helper/ocomponentaccess.hxx
diff options
context:
space:
mode:
Diffstat (limited to 'framework/inc/helper/ocomponentaccess.hxx')
-rw-r--r--framework/inc/helper/ocomponentaccess.hxx161
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: */