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
|
/*
* SPDX-FileCopyrightText: 2013-2020 Mattia Basaglia
*
* SPDX-License-Identifier: LGPL-3.0-or-later
*/
#ifndef COLOR_WIDGETS_SWATCH_HPP
#define COLOR_WIDGETS_SWATCH_HPP
#include <QWidget>
#include <QPen>
#include "color_palette.hpp"
namespace color_widgets {
/**
* \brief A widget drawing a palette
*/
class QCP_EXPORT Swatch : public QWidget
{
Q_OBJECT
/**
* \brief Palette shown by the widget
*/
Q_PROPERTY(const ColorPalette& palette READ palette WRITE setPalette NOTIFY paletteChanged)
/**
* \brief Currently selected color (-1 if no color is selected)
*/
Q_PROPERTY(int selected READ selected WRITE setSelected NOTIFY selectedChanged)
/**
* \brief Preferred size for a color square
*/
Q_PROPERTY(QSize colorSize READ colorSize WRITE setColorSize NOTIFY colorSizeChanged)
Q_PROPERTY(ColorSizePolicy colorSizePolicy READ colorSizePolicy WRITE setColorSizePolicy NOTIFY colorSizePolicyChanged)
/**
* \brief Border around the colors
*/
Q_PROPERTY(QPen border READ border WRITE setBorder NOTIFY borderChanged)
/**
* \brief Selection rectangle for selected color
*/
Q_PROPERTY(QPen selection READ selectionPen WRITE setSelectionPen)
/**
* \brief Forces the Swatch to display that many rows of colors
*
* If there are too few elements, the widget will display less than this
* many rows.
*
* A value of0 means that the number of rows is automatic.
*
* \note Conflicts with forcedColumns
*/
Q_PROPERTY(int forcedRows READ forcedRows WRITE setForcedRows NOTIFY forcedRowsChanged)
/**
* \brief Forces the Swatch to display that many columns of colors
*
* If there are too few elements, the widget will display less than this
* many columns.
*
* A value of 0 means that the number of columns is automatic.
*
* \note Conflicts with forcedRows
*/
Q_PROPERTY(int forcedColumns READ forcedColumns WRITE setForcedColumns NOTIFY forcedColumnsChanged)
/**
* \brief Whether the palette can be modified via user interaction
* \note Even when this is \b false, it can still be altered programmatically
*/
Q_PROPERTY(bool readOnly READ readOnly WRITE setReadOnly NOTIFY readOnlyChanged)
/**
* \brief Maximum size a color square can have
*/
Q_PROPERTY(QSize maxColorSize READ maxColorSize WRITE setMaxColorSize NOTIFY maxColorSizeChanged)
/**
* \brief Whether to show an extra color to perform a "clear" operation.
*
* Clicking on this extra pseudo-color will emit signals like clicked() etc with an index of -1.
*/
Q_PROPERTY(bool showClearColor READ showClearColor WRITE setShowClearColor NOTIFY showClearColorChanged)
public:
enum ColorSizePolicy
{
Hint, ///< The size is just a hint
Minimum, ///< Can expand but not contract
Fixed ///< Must be exactly as specified
};
Q_ENUMS(ColorSizePolicy)
Swatch(QWidget* parent = nullptr);
~Swatch();
QSize sizeHint() const Q_DECL_OVERRIDE;
QSize minimumSizeHint() const Q_DECL_OVERRIDE;
const ColorPalette& palette() const;
ColorPalette& palette();
int selected() const;
/**
* \brief Color at the currently selected index
*/
QColor selectedColor() const;
/**
* \brief Color index at the given position within the widget
* \param p Point in local coordinates
* \returns -1 if the position doesn't represent any color
*/
int indexAt(const QPoint& p);
/**
* \brief Color at the given position within the widget
* \param p Point in local coordinates
*/
QColor colorAt(const QPoint& p);
QSize colorSize() const;
QSize maxColorSize() const;
ColorSizePolicy colorSizePolicy() const;
QPen border() const;
QPen selectionPen() const;
int forcedRows() const;
int forcedColumns() const;
bool readOnly() const;
bool showClearColor() const;
public Q_SLOTS:
void setPalette(const ColorPalette& palette);
void setSelected(int selected);
/**
* Sets the given color as selected color.
* If the given color is not in the palette, the function returns
* false
*/
bool setSelectedColor(const QColor& color);
void clearSelection();
void setColorSize(const QSize& colorSize);
void setMaxColorSize(const QSize& colorSize);
void setColorSizePolicy(ColorSizePolicy colorSizePolicy);
void setBorder(const QPen& border);
void setSelectionPen(const QPen& selected);
void setForcedRows(int forcedRows);
void setForcedColumns(int forcedColumns);
void setReadOnly(bool readOnly);
/**
* \brief Remove the currently seleceted color
**/
void removeSelected();
void setShowClearColor(bool show);
Q_SIGNALS:
void paletteChanged(const ColorPalette& palette);
void selectedChanged(int selected);
void colorSelected(const QColor& color);
void colorSizeChanged(const QSize& colorSize);
void maxColorSizeChanged(const QSize& colorSize);
void colorSizePolicyChanged(ColorSizePolicy colorSizePolicy);
void doubleClicked(int index, Qt::KeyboardModifiers modifiers);
void rightClicked(int index, Qt::KeyboardModifiers modifiers);
void clicked(int index, Qt::KeyboardModifiers modifiers);
void forcedRowsChanged(int forcedRows);
void forcedColumnsChanged(int forcedColumns);
void readOnlyChanged(bool readOnly);
void borderChanged(const QPen& border);
void showClearColorChanged(bool show);
protected:
bool event(QEvent* event) Q_DECL_OVERRIDE;
void paintEvent(QPaintEvent* event) Q_DECL_OVERRIDE;
void keyPressEvent(QKeyEvent* event) Q_DECL_OVERRIDE;
void mousePressEvent(QMouseEvent *event) Q_DECL_OVERRIDE;
void mouseReleaseEvent(QMouseEvent *event) Q_DECL_OVERRIDE;
void mouseMoveEvent(QMouseEvent *event) Q_DECL_OVERRIDE;
void mouseDoubleClickEvent(QMouseEvent *event) Q_DECL_OVERRIDE;
void wheelEvent(QWheelEvent* event) Q_DECL_OVERRIDE;
void dragEnterEvent(QDragEnterEvent *event) Q_DECL_OVERRIDE;
void dragMoveEvent(QDragMoveEvent* event) Q_DECL_OVERRIDE;
void dragLeaveEvent(QDragLeaveEvent *event) Q_DECL_OVERRIDE;
void dropEvent(QDropEvent* event) Q_DECL_OVERRIDE;
protected Q_SLOTS:
/**
* \brief Connected to the internal palette object to keep eveything consistent
*/
void paletteModified();
private:
class Private;
Private* p;
};
} // namespace color_widgets
#endif // COLOR_WIDGETS_SWATCH_HPP
|
