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, 314 insertions, 0 deletions

diff --git a/sd/inc/OutlinerIterator.hxx b/sd/inc/OutlinerIterator.hxx
new file mode 100644
index 000000000..d160609d8
--- /dev/null
+++ b/sd/inc/OutlinerIterator.hxx
@@ -0,0 +1,314 @@
+/* -*- 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 <svx/svdobj.hxx>
+
+#include "pres.hxx"
+#include <sal/types.h>
+#include <memory>
+#include <vector>
+
+class SdDrawDocument;
+class SdOutliner;
+
+namespace sd {
+
+class ViewShell;
+
+namespace outliner {
+
+class IteratorImplBase;
+class IteratorPosition;
+
+/** Use this enum to specify the initial location of the object pointed to by
+    a newly created iterator.  The values are
+    <ul><li><const>BEGIN</const> for the first object with reference to
+    iteration direction.</li>
+    <li>END for one past the last valid object or, if the iterator is a
+    backward iterator, the object in front of the first valid one.</li>
+    <li>CURRENT for the current object.  Because there is only a current
+    page this usually is taken to be the first/last object on the current
+    page.</li></ul>
+*/
+enum IteratorLocation {BEGIN,END,CURRENT};
+
+/** This iterator can be used to iterate over all <type>SdrObject</type>
+    objects of one of three set denoted by the <type>IteratorType</type>:
+    <ul><li>All objects of the current mark list (selection)
+    (type==SELECTION).</li>
+    <li>All objects in the current view (type==SINGLE_VIEW).</li>
+    <li>All objects in all views (type=DOCUMENT).</li></ul>
+
+    <p>Note that the iterator does not change pages or views.  It is the
+    task of the user of the iterator to take the information provided by the
+    <type>IteratorPosition</type> as returned by the
+    <member>operator*()</member> method and set view, visible page, and
+    selection/edit mode markers to reflect this position.</p>
+
+    <p>A simple forward iteration from the first to the last object would
+    instantiate the iterator with
+    <code>Iterator(pDocument,pViewShell,true,BEGIN)</code> for some document
+    and view shell.  This iterator can then be compared against
+    <code>Iterator(pDocument,pViewShell,true,END)</code>.  On equality the
+    iteration should be stopped without evaluating the iterator: The position
+    of an end iterator is not valid.</p>
+*/
+class Iterator
+{
+public:
+    Iterator();
+
+    /** The copy constructor creates a new iterator by copying the
+        implementation object.
+    */
+    Iterator (const Iterator& rIterator);
+    Iterator(Iterator&& rIterator) noexcept;
+
+    /** Create a new iterator with the implementation object being the
+        provided one.
+        @param pObject
+            A copy of this object will become the implementation object.
+    */
+    explicit Iterator (std::unique_ptr<IteratorImplBase> pObject);
+
+    ~Iterator();
+
+    /** Assign the iterator from the given one.  The implementation object
+        of this iterator will be a copy of the given iterator.
+        @param rIterator
+            The iterator which to assign from.
+    */
+    Iterator& operator= (const Iterator& rIterator);
+    Iterator& operator=(Iterator&& rIterator) noexcept;
+
+    /** Return the current position of the iterator.
+        @return
+            Returns a reference to the current position.  Therefore this
+            method is not thread safe.  The reason for this behaviour is, of
+            course, to omit the copying of the returned position.
+    */
+    const IteratorPosition& operator* () const;
+    /** The prefix increment operator returns the iterator pointing to the
+        next object.  When in doubt prefer this operator over the postfix
+        increment operator.
+        @return
+            Returns a reference to this iterator pointing to the next object.
+    */
+    Iterator& operator++ ();
+    /** Test equality of two iterators.  Two iterators are taken to be equal
+        when they point are of the same type (their implementation objects
+        are instances of the same class) and point to the same object.
+        @param rIterator
+            The iterator to test equality with.
+        @return
+            Returns <TRUE/> when both iterators point to the same object.
+    */
+    bool operator== (const Iterator& rIterator) const;
+    /** Test whether two iterators point to different objects.  This is just
+        the negation of the result of the equality operator.
+        @param rIterator
+            The iterator to test inequality with.
+        @return
+            Returns <TRUE/> when both iterators point to the different objects.
+    */
+    bool operator!= (const Iterator& rIterator) const;
+    /** Reverse the direction of iteration.  The position of the iterator is
+        not changed.  Thus calling this method twice returns to the old state.
+    */
+    void Reverse();
+
+private:
+    /// The implementation object to which most of the methods are forwarded.
+    std::unique_ptr<IteratorImplBase> mxIterator;
+};
+
+/** This class wraps the <type>SdOutliner</type> class and represents it as
+    a container of <type>SdrObject</type> objects.  Its main purpose is to
+    provide iterators for certain sub-sets of those objects.  These sub-sets
+    are a) the set of the currently selected objects, b) all objects in the
+    current view, and c) all objects in all views.
+
+    <p>The direction of the returned iterators depends on the underlying
+    <type>SdOutliner</type> object and is usually set in the search
+    dialog.</p>
+*/
+class OutlinerContainer
+{
+public:
+    /** Create a new wrapper object for the given outliner.
+        @param pOutliner
+            The outliner that is represented by the new object as
+            <type>SdrObject</type> container.
+    */
+    OutlinerContainer (SdOutliner* pOutliner);
+
+    /** Return an iterator that points to the first object of one of the
+        sets described above.  This takes also into account the direction of
+        iteration.
+        @return
+            The returned iterator points either to the first (forward
+            search) or to the last object (backward search) of the set.
+    */
+    Iterator begin();
+
+    /** Return an iterator that marks the end of the iteration.  This takes
+        also into account the direction of iteration. The object pointed to
+        is not valid.
+        @return
+            The returned iterator points either to that object past the last
+            one (forward search) or to the one in front of the first
+            (backward search).
+    */
+    Iterator end();
+
+    /** Return an iterator that points to the current object of one of the
+        sets described above.  This takes also into account the direction of
+        iteration.
+        @return
+            The returned iterator points either to the first (forward
+            search) or to the last object (backward search) of the set of
+            selected objects or of the current page if the search set spans
+            more than one page.
+    */
+    Iterator current();
+
+private:
+    /// The wrapped outliner that is represented as object container.
+    SdOutliner* mpOutliner;
+
+    /** Create an iterator.  The object pointed to depends on the search
+        direction retrieved from the outliner object
+        <member>mpOutliner</member> and the given location.
+        @param aLocation
+            This specifies whether the returned iterator points to the
+            first, (one past the) last, or current object.
+        @return
+            Returns an iterator as constructed by
+            <member>CreateSelectionIterator()</member>,
+     */
+    Iterator CreateIterator (IteratorLocation aLocation);
+
+    /** Create an iterator that iterates over all currently selected
+        <type>SdrObjects</type> objects of the <member>mpOutliner</member>
+        outliner.
+        @param rObjectList
+            List of currently selected objects.  This list is necessary
+            so that the selection can be changed without affecting the
+            iterator.
+        @param pDocument
+            The document to which the objects belong.
+        @param pViewShell
+            The view shell which displays the objects.
+        @param bDirectionIsForward
+            The direction of iteration.  It defaults to forward.
+        @param aLocation
+            This specifies at which object the iterator points initially.
+    */
+    static Iterator CreateSelectionIterator (
+        const ::std::vector<::tools::WeakReference<SdrObject>>& rObjectList,
+        SdDrawDocument* pDocument,
+        const std::shared_ptr<ViewShell>& rpViewShell,
+        bool bDirectionIsForward,
+        IteratorLocation aLocation);
+
+    /** Create an iterator that iterates over all <type>SdrObjects</type>
+        objects of the <member>mpOutliner</member> outliner.
+        @param pDocument
+            The document to which the objects belong.
+        @param pViewShell
+            The view shell which displays the objects.
+        @param bDirectionIsForward
+            The direction of iteration.  It defaults to forward.
+        @param aLocation
+            This specifies at which object the iterator points initially.
+    */
+    static Iterator CreateDocumentIterator (
+        SdDrawDocument* pDocument,
+        const std::shared_ptr<ViewShell>& rpViewShell,
+        bool bDirectionIsForward,
+        IteratorLocation aLocation);
+
+    /** Return the index of a page that contains an object that a new
+        iterator shall point to.  This page index depends primarily on the
+        location, iteration direction, as well as on edit mode and page
+        kind.
+        @param pDocument
+            The document to which the page belongs.
+        @param pViewShell
+            The view shell which displays the page.
+        @param ePageKind
+            Specifies the view the page belongs to.
+        @param eEditMode
+            Specifies whether the page is a master page.
+        @param bDirectionIsForward
+            The direction of iteration.
+        @param aLocation
+            This specifies at which object the iterator points initially.
+    */
+    static sal_Int32 GetPageIndex (
+        SdDrawDocument const * pDocument,
+        const std::shared_ptr<ViewShell>& rpViewShell,
+        PageKind ePageKind,
+        EditMode eEditMode,
+        bool bDirectionIsForward,
+        IteratorLocation aLocation);
+
+    // Do not allow default constructor and copying of outliner containers.
+    OutlinerContainer (const OutlinerContainer&) = delete;
+    OutlinerContainer& operator= (const OutlinerContainer&) = delete;
+};
+
+/** Data collection specifying a <type>SdrObject</type> and its position in
+    a document and view.
+*/
+class IteratorPosition
+{
+public:
+    /** Create a new object with all data members set to default values.
+        These values should not be accessed.  The only use of the object as
+        it is as a marker in comparisons.
+    */
+    IteratorPosition();
+
+    /** Compare two positions for equality.
+        @return
+            <TRUE/> is returned only when all data members have the same
+            values in both position objects.
+    */
+    bool operator== (const IteratorPosition& aPosition) const;
+
+    /// Pointer to the actual <type>SdrObject</type> object.
+    ::tools::WeakReference<SdrObject> mxObject;
+
+    /// Number of the actual SdrText from the current <type>SdrObject</type>
+    sal_Int32 mnText;
+
+    /// The index of a page where the object is located on.
+    sal_Int32 mnPageIndex;
+    /// Page kind of the view.
+    PageKind mePageKind;
+    /// Edit mode of the view.
+    EditMode meEditMode;
+};
+
+} } // end of namespace ::sd::outliner
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */