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
|
/* This file is part of the KDE project
* Copyright (C) 2011-2012 Pierre Stirnweiss <pstirnweiss@googlemail.com>
*
* 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 STYLESCOMBO_H
#define STYLESCOMBO_H
#include <QComboBox>
class QListView;
class StylesModel;
class StylesComboPreview;
/** This combo is specifically designed to allow chosing a text style, be it a character style or a paragraph style.
* The combo itself does not know what type of style it is dealing with. In that respect it follows pretty much the normal QComboBox paradigm.
* This is achieved by setting a @class StylesModel to the combo.
* The combo also creates and uses a @class StylesDelegate in order to paint the items as preview in the dropdown menu. This delegate also provide a button to call the style manager dialog directly.
* Additionally the combo display the style as a preview in its main area.
* The combo allows its user to specify if the current selected style should be considered as original or not. If the style has been modified, a + button appears in the main area. Pressing it will allow to change the name of the style. Focusing out, or pressing enter will send a signal for creating a new style. Escaping will prevent this signal to be sent and return to the preview.
*/
class StylesCombo : public QComboBox
{
Q_OBJECT
public:
explicit StylesCombo(QWidget *parent);
~StylesCombo();
/** Use this method to set the @param model of the combo. */
void setStylesModel(StylesModel *model);
/** This method is an override of QComboBox setLineEdit. We need to make it public since its Qt counterpart is public. However, this method is not supposed to be used (unless you know what you are doing). The StylesCombo relies on its own internal QLineEdit subclass for quite a lot of its functionnality. There is no guarantee that the whole thing will work in case the line edit is replaced */
void setLineEdit(QLineEdit *lineEdit);
/** Same as above */
void setEditable(bool editable);
/** This method is used to specify if the currently selected style is in its original state or is considered modified. In the later case, the + button will appear (see the class description) */
void setStyleIsOriginal(bool original);
bool eventFilter(QObject *, QEvent *);
public slots:
/** This slot needs to be called if the preview in the main area needs to be updated for some reason */
void slotUpdatePreview();
signals:
/** This is emitted when a selection is made (programatically or by user interaction). It is
* to be noted that this signal is also emitted when an item is selected again.
* @param index: the index of the selected item. */
void selected(int index);
/** This is emitted when a selection is changed (programatically or by user interaction). It is
* to be noted that this signal is _not_ emitted when an item is selected again. Not even if it
* had been modified.
* @param index: the index of the selected item. */
void selectionChanged(int index);
/** This signal is emitted on validation of the name of a modified style (after pressing the + button). This validation happens on focus out or pressed enter key.
* @param name: the name by which the new style should be called */
void newStyleRequested(QString name);
/** This signal is emitted when the "show style manager" button is pressed in the dropdown list.
* @param index: the index of the item on which the button was pressed */
void showStyleManager(int index);
/** This signal is emitted when the "delete style" button is pressed in the dropdown list.
* @param index: the index of the item on which the button was pressed
* This is currently disabled */
void deleteStyle(int index);
private slots:
void slotDeleteStyle(QModelIndex);
void slotShowDia(QModelIndex);
void slotSelectionChanged(int index);
void slotItemClicked(QModelIndex);
void slotPreviewClicked();
private:
StylesModel *m_stylesModel;
StylesComboPreview *m_preview;
QListView *m_view;
int m_selectedItem;
bool m_originalStyle;
};
#endif //STYLESCOMBO_H
|
