1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
|
/* -*- 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 .
*/
#ifndef INCLUDED_SD_INC_OUTLINERITERATOR_HXX
#define INCLUDED_SD_INC_OUTLINERITERATOR_HXX
#include <svx/svdobj.hxx>
#include "pres.hxx"
#include "sal/types.h"
#include <memory>
#include <vector>
class SdDrawDocument;
namespace sd {
class ViewShell;
class Outliner;
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};
/** Use this enum to specify the type of iterator when creating a new
iterator:
<ul><li>SELECTION for iteration over all objects that belong to the
current mark list.</li>
<li>SINGLE_VIEW for iteration over all objects in the current view.</li>
<li>DOCUMENT for iteration over all object in all relevant
views.</li></ul>
*/
enum IteratorType {SELECTION,SINGLE_VIEW,DOCUMENT};
/** 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);
/** 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 (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);
/** 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);
/** 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);
/** 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.
IteratorImplBase* mpIterator;
};
/** This class wraps the <type>Outliner</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>Outliner</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 (::sd::Outliner* 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.
::sd::Outliner* 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<SdrObjectWeakRef>& rObjectList,
SdDrawDocument* pDocument,
const std::shared_ptr<ViewShell>& rpViewShell,
bool bDirectionIsForward=true,
IteratorLocation aLocation=BEGIN);
/** 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=true,
IteratorLocation aLocation=BEGIN);
/** 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* 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&) {return *this;};
};
/** 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();
/** Create a new object with all data members set from the given
position.
@param aPosition
The position object from which to take the values that are
assigned to the data members of this object.
*/
IteratorPosition (const IteratorPosition& aPosition);
/// The destructor is a no-op at the moment.
~IteratorPosition();
/** Assign the content of the given position to this one.
@param aPosition
This is the position object from which to take the values of all
data members.
@return
Returns a reference to this object.
*/
IteratorPosition& operator= (const IteratorPosition& aPosition);
/** 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.
SdrObjectWeakRef 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
#endif // _ INCLUDED_SD_INC_OUTLINERITERATOR_HXX
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|