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
|
/* This file is part of the KDE project
* Copyright (C) 2008 Thomas Zander <zander@kde.org>
* Copyright (C) 2011 C. Boemann <cbo@boemann.dk>
* Copyright (C) 2011-2012 Pierre Stirnweiss <pstirnweiss@googlemail.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef MODEL_H
#define MODEL_H
#include "AbstractStylesModel.h"
#include <QAbstractListModel>
#include <QSize>
class KoStyleThumbnailer;
class KoStyleManager;
class KoParagraphStyle;
class KoCharacterStyle;
class QImage;
class QSignalMapper;
/** This class is used to provide widgets (like the @class StylesCombo) the styles available to the document being worked on. The @class StylesModel can be of two types: character styles or paragraph styles type. This allows the widget to ignore the type of style it is handling.
* Character styles in ODF can be specified in two ways. First, a named character style, specifying character formatting properties. It is meant to be used on a couple of individual characters. Secondely, a paragraph style also specifies character formatting properties, which are to be considered the default for that particular paragraph.
* For this reason, the @class Stylesmodel, when of the type @value characterStyle, do not list the paragraph style names. Only the specific named chracter styles are listed. Additionally, as the first item, a virtual style "As paragraph" is provided. Selecting this "style" will set the character properties as specified by the paragraph style currently applied to the selection.
* This class requires that a @class KoStyleManager and a @class KoStyleThumbnailer be set. See below methods.
*
* The StylesModel re-implement the AbstractStylesModel interface. Several components assume the following properties:
* - the StylesModel is a flat list of items (this also means that "parent" QModelIndexes are always invalid)
* - the StylesModel has only one column
* - there is no header in the model
* - only the following methods are used when updating the underlying model's data: resetModel, insertRows, moveRows, removeRows
*/
class StylesModel : public AbstractStylesModel
{
Q_OBJECT
public:
enum CategoriesInternalIds {
NoneStyleId = -1
};
explicit StylesModel(KoStyleManager *styleManager, AbstractStylesModel::Type modelType, QObject *parent = 0);
~StylesModel();
/** Re-implemented from QAbstractItemModel. */
virtual QModelIndex index(int row, int column = 0, const QModelIndex &parent = QModelIndex()) const;
virtual int rowCount(const QModelIndex &parent) const;
virtual QVariant data(const QModelIndex &index, int role) const;
virtual Qt::ItemFlags flags(const QModelIndex &index) const;
virtual QModelIndex parent(const QModelIndex &child) const;
virtual int columnCount(const QModelIndex &parent) const;
/** *********************************** */
/** Specific methods of the StylesModel */
/** ************************* */
/** Initialising of the model */
/** Specify if the combo should provide the virtual style None. This style is a virtual style which equates to no style. It is only relevant for character styles.
In case the "None" character style is selected, the character formatting properties of the paragraph style are used.
A @class StylesModel of the @enum Type ParagraphStyle always has this property set to false.
On the other hand, the default for a @class StylesModel of the @enum Type CharacterStyle is true.
It is important to set this before setting the stylemanager on the model. The flag is used when populating the styles from the KoStyleManager.
*/
void setProvideStyleNone(bool provide);
/** Sets the @class KoStyleManager of the model. Setting this will populate the styles. It is required that a @param manager is set before using the model.
* CAUTION: Populating the style will select the first inserted item. If this model is already set on a view, this might cause the view to emit an item selection changed signal.
*/
void setStyleManager(KoStyleManager *manager);
/** Sets the @class KoStyleThumbnailer of the model. It is required that a @param thumbnailer is set before using the model. */
void setStyleThumbnailer(KoStyleThumbnailer *thumbnailer);
/** *************** */
/** Using the model */
/** Return a @class QModelIndex for the specified @param style.
* @param style may be either a character or paragraph style.
*/
QModelIndex indexOf(const KoCharacterStyle *style) const;
/** Returns a QImage which is a preview of the style specified by @param row of the given @param size.
* If size isn't specified, the default size of the given @class KoStyleThumbnailer is used.
*/
QImage stylePreview(int row, const QSize &size = QSize());
// QImage stylePreview(QModelIndex &index, const QSize &size = QSize());
/** Specifies which paragraph style is currently the active one (on the current paragraph). This is used in order to properly preview the "As paragraph" virtual character style. */
void setCurrentParagraphStyle(int styleId);
/** Return the first index at list. */
QModelIndex firstStyleIndex();
/** Return style id list. */
QList<int> StyleList();
/** Return new styles and their ids. */
QHash<int, KoParagraphStyle *> draftParStyleList();
QHash<int, KoCharacterStyle *> draftCharStyleList();
/** Add a paragraph style to pargraph style list but this style is not applied. */
void addDraftParagraphStyle(KoParagraphStyle *style);
/** Add a character style to character style list but this style is not applied. */
void addDraftCharacterStyle(KoCharacterStyle *style);
/** we call this when we apply our unapplied styles and we clear our list. */
void clearDraftStyles();
/** We call this when we want a clear style model. */
void clearStyleModel();
/** Returns the type of styles in the model */
AbstractStylesModel::Type stylesType() const;
private Q_SLOTS:
void removeParagraphStyle(KoParagraphStyle *);
void removeCharacterStyle(KoCharacterStyle *);
void updateName(int styleId);
public Q_SLOTS:
void addParagraphStyle(KoParagraphStyle *);
void addCharacterStyle(KoCharacterStyle *);
private:
void updateParagraphStyles();
void updateCharacterStyles();
protected:
QList<int> m_styleList; // list of style IDs
QHash<int, KoParagraphStyle *> m_draftParStyleList; // list of new styles that are not applied
QHash<int, KoCharacterStyle *> m_draftCharStyleList;
private:
KoStyleManager *m_styleManager;
KoParagraphStyle *m_currentParagraphStyle;
KoCharacterStyle *m_defaultCharacterStyle;
QSignalMapper *m_styleMapper;
bool m_provideStyleNone;
};
#endif
|
