source: trunk/src/qt3support/itemviews/q3iconview.h@ 458

Last change on this file since 458 was 2, checked in by Dmitry A. Kuminov, 17 years ago

Initially imported qt-all-opensource-src-4.5.1 from Trolltech.
File size: 16.0 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
4** Contact: Qt Software Information ([email protected])
5**
6** This file is part of the Qt3Support module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial Usage
10** Licensees holding valid Qt Commercial licenses may use this file in
11** accordance with the Qt Commercial License Agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and Nokia.
14**
15** GNU Lesser General Public License Usage
16** Alternatively, this file may be used under the terms of the GNU Lesser
17** General Public License version 2.1 as published by the Free Software
18** Foundation and appearing in the file LICENSE.LGPL included in the
19** packaging of this file. Please review the following information to
20** ensure the GNU Lesser General Public License version 2.1 requirements
21** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
22**
23** In addition, as a special exception, Nokia gives you certain
24** additional rights. These rights are described in the Nokia Qt LGPL
25** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this
26** package.
27**
28** GNU General Public License Usage
29** Alternatively, this file may be used under the terms of the GNU
30** General Public License version 3.0 as published by the Free Software
31** Foundation and appearing in the file LICENSE.GPL included in the
32** packaging of this file. Please review the following information to
33** ensure the GNU General Public License version 3.0 requirements will be
34** met: http://www.gnu.org/copyleft/gpl.html.
35**
36** If you are unsure which license is appropriate for your use, please
37** contact the sales department at [email protected].
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42#ifndef Q3ICONVIEW_H
43#define Q3ICONVIEW_H
44
45#include <Qt3Support/q3scrollview.h>
46#include <QtCore/qstring.h>
47#include <QtCore/qrect.h>
48#include <QtCore/qpoint.h>
49#include <QtCore/qsize.h>
50#include <QtGui/qfont.h> // QString->QFont conversion
51#include <Qt3Support/q3dragobject.h>
52#include <QtGui/qbitmap.h>
53#include <QtGui/qpicture.h>
54#include <Qt3Support/q3valuelist.h>
55
56QT_BEGIN_HEADER
57
58QT_BEGIN_NAMESPACE
59
60QT_MODULE(Qt3SupportLight)
61
62#ifndef QT_NO_ICONVIEW
63
64class Q3IconView;
65class QPainter;
66class QMimeSource;
67class QMouseEvent;
68class QDragEnterEvent;
69class QDragMoveEvent;
70class QDragLeaveEvent;
71class QKeyEvent;
72class QFocusEvent;
73class QShowEvent;
74class Q3IconViewItem;
75class Q3IconViewItemLineEdit;
76class QStringList;
77class Q3IconDragPrivate;
78class QColorGroup;
79
80#ifndef QT_NO_DRAGANDDROP
81
82class Q_COMPAT_EXPORT Q3IconDragItem
83{
84public:
85 Q3IconDragItem();
86 virtual ~Q3IconDragItem();
87 virtual QByteArray data() const;
88 virtual void setData(const QByteArray &d);
89 bool operator== (const Q3IconDragItem&) const;
90
91private:
92 QByteArray ba;
93
94};
95
96class Q_COMPAT_EXPORT Q3IconDrag : public Q3DragObject
97{
98 Q_OBJECT
99public:
100 Q3IconDrag(QWidget * dragSource, const char* name = 0);
101 virtual ~Q3IconDrag();
102
103 void append(const Q3IconDragItem &item, const QRect &pr, const QRect &tr);
104
105 virtual const char* format(int i) const;
106 static bool canDecode(QMimeSource* e);
107 virtual QByteArray encodedData(const char* mime) const;
108
109private:
110 Q_DISABLE_COPY(Q3IconDrag)
111
112 Q3IconDragPrivate *d;
113 QChar endMark;
114
115 friend class Q3IconView;
116 friend class Q3IconViewPrivate;
117};
118
119#endif
120
121class Q3IconViewToolTip;
122class Q3IconViewItemPrivate;
123
124class Q_COMPAT_EXPORT Q3IconViewItem
125{
126 friend class Q3IconView;
127 friend class Q3IconViewToolTip;
128 friend class Q3IconViewItemLineEdit;
129
130public:
131 Q3IconViewItem(Q3IconView *parent);
132 Q3IconViewItem(Q3IconView *parent, Q3IconViewItem *after);
133 Q3IconViewItem(Q3IconView *parent, const QString &text);
134 Q3IconViewItem(Q3IconView *parent, Q3IconViewItem *after, const QString &text);
135 Q3IconViewItem(Q3IconView *parent, const QString &text, const QPixmap &icon);
136 Q3IconViewItem(Q3IconView *parent, Q3IconViewItem *after, const QString &text, const QPixmap &icon);
137#ifndef QT_NO_PICTURE
138 Q3IconViewItem(Q3IconView *parent, const QString &text, const QPicture &picture);
139 Q3IconViewItem(Q3IconView *parent, Q3IconViewItem *after, const QString &text, const QPicture &picture);
140#endif
141 virtual ~Q3IconViewItem();
142
143 virtual void setRenameEnabled(bool allow);
144 virtual void setDragEnabled(bool allow);
145 virtual void setDropEnabled(bool allow);
146
147 virtual QString text() const;
148 virtual QPixmap *pixmap() const;
149#ifndef QT_NO_PICTURE
150 virtual QPicture *picture() const;
151#endif
152 virtual QString key() const;
153
154 bool renameEnabled() const;
155 bool dragEnabled() const;
156 bool dropEnabled() const;
157
158 Q3IconView *iconView() const;
159 Q3IconViewItem *prevItem() const;
160 Q3IconViewItem *nextItem() const;
161
162 int index() const;
163
164 virtual void setSelected(bool s, bool cb);
165 virtual void setSelected(bool s);
166 virtual void setSelectable(bool s);
167
168 bool isSelected() const;
169 bool isSelectable() const;
170
171 virtual void repaint();
172
173 virtual bool move(int x, int y);
174 virtual void moveBy(int dx, int dy);
175 virtual bool move(const QPoint &pnt);
176 virtual void moveBy(const QPoint &pnt);
177
178 QRect rect() const;
179 int x() const;
180 int y() const;
181 int width() const;
182 int height() const;
183 QSize size() const;
184 QPoint pos() const;
185 QRect textRect(bool relative = true) const;
186 QRect pixmapRect(bool relative = true) const;
187 bool contains(const QPoint& pnt) const;
188 bool intersects(const QRect& r) const;
189
190 virtual bool acceptDrop(const QMimeSource *mime) const;
191
192#ifndef QT_NO_TEXTEDIT
193 void rename();
194#endif
195
196 virtual int compare(Q3IconViewItem *i) const;
197
198 virtual void setText(const QString &text);
199 virtual void setPixmap(const QPixmap &icon);
200#ifndef QT_NO_PICTURE
201 virtual void setPicture(const QPicture &icon);
202#endif
203 virtual void setText(const QString &text, bool recalc, bool redraw = true);
204 virtual void setPixmap(const QPixmap &icon, bool recalc, bool redraw = true);
205 virtual void setKey(const QString &k);
206
207 virtual int rtti() const;
208 static int RTTI;
209
210protected:
211#ifndef QT_NO_TEXTEDIT
212 virtual void removeRenameBox();
213#endif
214 virtual void calcRect(const QString &text_ = QString());
215 virtual void paintItem(QPainter *p, const QColorGroup &cg);
216 virtual void paintFocus(QPainter *p, const QColorGroup &cg);
217#ifndef QT_NO_DRAGANDDROP
218 virtual void dropped(QDropEvent *e, const Q3ValueList<Q3IconDragItem> &lst);
219#endif
220 virtual void dragEntered();
221 virtual void dragLeft();
222 void setItemRect(const QRect &r);
223 void setTextRect(const QRect &r);
224 void setPixmapRect(const QRect &r);
225 void calcTmpText();
226 QString tempText() const;
227
228private:
229 void init(Q3IconViewItem *after = 0
230#ifndef QT_NO_PICTURE
231 , QPicture *pic = 0
232#endif
233 );
234#ifndef QT_NO_TEXTEDIT
235 void renameItem();
236 void cancelRenameItem();
237#endif
238 void checkRect();
239
240 Q3IconView *view;
241 QString itemText, itemKey;
242 QString tmpText;
243 QPixmap *itemIcon;
244#ifndef QT_NO_PICTURE
245 QPicture *itemPic;
246#endif
247 Q3IconViewItem *prev, *next;
248 uint allow_rename : 1;
249 uint allow_drag : 1;
250 uint allow_drop : 1;
251 uint selected : 1;
252 uint selectable : 1;
253 uint dirty : 1;
254 uint wordWrapDirty : 1;
255 QRect itemRect, itemTextRect, itemIconRect;
256#ifndef QT_NO_TEXTEDIT
257 Q3IconViewItemLineEdit *renameBox;
258#endif
259 QRect oldRect;
260
261 Q3IconViewItemPrivate *d;
262
263};
264
265class Q3IconViewPrivate;
266
267class Q_COMPAT_EXPORT Q3IconView : public Q3ScrollView
268{
269 friend class Q3IconViewItem;
270 friend class Q3IconViewPrivate;
271 friend class Q3IconViewToolTip;
272
273 Q_OBJECT
274 // #### sorting and sort direction do not work
275 Q_ENUMS(SelectionMode ItemTextPos Arrangement ResizeMode)
276 Q_PROPERTY(bool sorting READ sorting)
277 Q_PROPERTY(bool sortDirection READ sortDirection)
278 Q_PROPERTY(SelectionMode selectionMode READ selectionMode WRITE setSelectionMode)
279 Q_PROPERTY(int gridX READ gridX WRITE setGridX)
280 Q_PROPERTY(int gridY READ gridY WRITE setGridY)
281 Q_PROPERTY(int spacing READ spacing WRITE setSpacing)
282 Q_PROPERTY(ItemTextPos itemTextPos READ itemTextPos WRITE setItemTextPos)
283 Q_PROPERTY(QBrush itemTextBackground READ itemTextBackground WRITE setItemTextBackground)
284 Q_PROPERTY(Arrangement arrangement READ arrangement WRITE setArrangement)
285 Q_PROPERTY(ResizeMode resizeMode READ resizeMode WRITE setResizeMode)
286 Q_PROPERTY(int maxItemWidth READ maxItemWidth WRITE setMaxItemWidth)
287 Q_PROPERTY(int maxItemTextLength READ maxItemTextLength WRITE setMaxItemTextLength)
288 Q_PROPERTY(bool autoArrange READ autoArrange WRITE setAutoArrange)
289 Q_PROPERTY(bool itemsMovable READ itemsMovable WRITE setItemsMovable)
290 Q_PROPERTY(bool wordWrapIconText READ wordWrapIconText WRITE setWordWrapIconText)
291 Q_PROPERTY(bool showToolTips READ showToolTips WRITE setShowToolTips)
292 Q_PROPERTY(uint count READ count)
293
294public:
295 enum SelectionMode {
296 Single = 0,
297 Multi,
298 Extended,
299 NoSelection
300 };
301 enum Arrangement {
302 LeftToRight = 0,
303 TopToBottom
304 };
305 enum ResizeMode {
306 Fixed = 0,
307 Adjust
308 };
309 enum ItemTextPos {
310 Bottom = 0,
311 Right
312 };
313
314 Q3IconView(QWidget* parent=0, const char* name=0, Qt::WindowFlags f = 0);
315 virtual ~Q3IconView();
316
317 virtual void insertItem(Q3IconViewItem *item, Q3IconViewItem *after = 0L);
318 virtual void takeItem(Q3IconViewItem *item);
319
320 int index(const Q3IconViewItem *item) const;
321
322 Q3IconViewItem *firstItem() const;
323 Q3IconViewItem *lastItem() const;
324 Q3IconViewItem *currentItem() const;
325 virtual void setCurrentItem(Q3IconViewItem *item);
326 virtual void setSelected(Q3IconViewItem *item, bool s, bool cb = false);
327
328 uint count() const;
329
330public:
331 virtual void showEvent(QShowEvent *);
332
333 virtual void setSelectionMode(SelectionMode m);
334 SelectionMode selectionMode() const;
335
336 Q3IconViewItem *findItem(const QPoint &pos) const;
337
338 enum StringComparisonMode {
339 CaseSensitive = 0x00001, // 0 0001
340 BeginsWith = 0x00002, // 0 0010
341 EndsWith = 0x00004, // 0 0100
342 Contains = 0x00008, // 0 1000
343 ExactMatch = 0x00010 // 1 0000
344 };
345 typedef uint ComparisonFlags;
346 Q3IconViewItem *findItem(const QString &text, ComparisonFlags = BeginsWith | Qt::CaseSensitive) const;
347 virtual void selectAll(bool select);
348 virtual void clearSelection();
349 virtual void invertSelection();
350
351 virtual void repaintItem(Q3IconViewItem *item);
352 void repaintSelectedItems();
353
354 void ensureItemVisible(Q3IconViewItem *item);
355 Q3IconViewItem* findFirstVisibleItem(const QRect &r) const;
356 Q3IconViewItem* findLastVisibleItem(const QRect &r) const;
357
358 virtual void clear();
359
360 virtual void setGridX(int rx);
361 virtual void setGridY(int ry);
362 int gridX() const;
363 int gridY() const;
364 virtual void setSpacing(int sp);
365 int spacing() const;
366 virtual void setItemTextPos(ItemTextPos pos);
367 ItemTextPos itemTextPos() const;
368 virtual void setItemTextBackground(const QBrush &b);
369 QBrush itemTextBackground() const;
370 virtual void setArrangement(Arrangement am);
371 Arrangement arrangement() const;
372 virtual void setResizeMode(ResizeMode am);
373 ResizeMode resizeMode() const;
374 virtual void setMaxItemWidth(int w);
375 int maxItemWidth() const;
376 virtual void setMaxItemTextLength(int w);
377 int maxItemTextLength() const;
378 virtual void setAutoArrange(bool b);
379 bool autoArrange() const;
380 virtual void setShowToolTips(bool b);
381 bool showToolTips() const;
382
383 void setSorting(bool sort, bool ascending = true);
384 bool sorting() const;
385 bool sortDirection() const;
386
387 virtual void setItemsMovable(bool b);
388 bool itemsMovable() const;
389 virtual void setWordWrapIconText(bool b);
390 bool wordWrapIconText() const;
391
392 bool eventFilter(QObject * o, QEvent *);
393
394 QSize minimumSizeHint() const;
395 QSize sizeHint() const;
396
397 virtual void sort(bool ascending = true);
398
399 bool isRenaming() const;
400
401 QVariant inputMethodQuery(Qt::InputMethodQuery query) const;
402
403public Q_SLOTS:
404 virtual void arrangeItemsInGrid(const QSize &grid, bool update = true);
405 virtual void arrangeItemsInGrid(bool update = true);
406 virtual void setContentsPos(int x, int y);
407 virtual void updateContents();
408
409Q_SIGNALS:
410 void selectionChanged();
411 void selectionChanged(Q3IconViewItem *item);
412 void currentChanged(Q3IconViewItem *item);
413 void clicked(Q3IconViewItem *);
414 void clicked(Q3IconViewItem *, const QPoint &);
415 void pressed(Q3IconViewItem *);
416 void pressed(Q3IconViewItem *, const QPoint &);
417
418 void doubleClicked(Q3IconViewItem *item);
419 void returnPressed(Q3IconViewItem *item);
420 void rightButtonClicked(Q3IconViewItem* item, const QPoint& pos);
421 void rightButtonPressed(Q3IconViewItem* item, const QPoint& pos);
422 void mouseButtonPressed(int button, Q3IconViewItem* item, const QPoint& pos);
423 void mouseButtonClicked(int button, Q3IconViewItem* item, const QPoint& pos);
424 void contextMenuRequested(Q3IconViewItem* item, const QPoint &pos);
425
426#ifndef QT_NO_DRAGANDDROP
427 void dropped(QDropEvent *e, const Q3ValueList<Q3IconDragItem> &lst);
428#endif
429 void moved();
430 void onItem(Q3IconViewItem *item);
431 void onViewport();
432 void itemRenamed(Q3IconViewItem *item, const QString &);
433 void itemRenamed(Q3IconViewItem *item);
434
435protected Q_SLOTS:
436 virtual void doAutoScroll();
437 virtual void adjustItems();
438 virtual void slotUpdate();
439
440private Q_SLOTS:
441 void movedContents(int dx, int dy);
442
443protected:
444 void drawContents(QPainter *p, int cx, int cy, int cw, int ch);
445 void contentsMousePressEvent(QMouseEvent *e);
446 void contentsMouseReleaseEvent(QMouseEvent *e);
447 void contentsMouseMoveEvent(QMouseEvent *e);
448 void contentsMouseDoubleClickEvent(QMouseEvent *e);
449 void contentsContextMenuEvent(QContextMenuEvent *e);
450
451#ifndef QT_NO_DRAGANDDROP
452 void contentsDragEnterEvent(QDragEnterEvent *e);
453 void contentsDragMoveEvent(QDragMoveEvent *e);
454 void contentsDragLeaveEvent(QDragLeaveEvent *e);
455 void contentsDropEvent(QDropEvent *e);
456#endif
457
458 void resizeEvent(QResizeEvent* e);
459 void keyPressEvent(QKeyEvent *e);
460 void focusInEvent(QFocusEvent *e);
461 void focusOutEvent(QFocusEvent *e);
462 void enterEvent(QEvent *e);
463
464 virtual void drawRubber(QPainter *p);
465#ifndef QT_NO_DRAGANDDROP
466 virtual Q3DragObject *dragObject();
467 virtual void startDrag();
468#endif
469 virtual void insertInGrid(Q3IconViewItem *item);
470 virtual void drawBackground(QPainter *p, const QRect &r);
471
472 void emitSelectionChanged(Q3IconViewItem * i = 0);
473 void emitRenamed(Q3IconViewItem *item);
474
475 Q3IconViewItem *makeRowLayout(Q3IconViewItem *begin, int &y, bool &changed);
476
477 void changeEvent(QEvent *);
478
479private:
480 Q_DISABLE_COPY(Q3IconView)
481
482 void contentsMousePressEventEx(QMouseEvent *e);
483 virtual void drawDragShapes(const QPoint &pnt);
484#ifndef QT_NO_DRAGANDDROP
485 virtual void initDragEnter(QDropEvent *e);
486#endif
487 Q3IconViewItem* findItemByName(Q3IconViewItem *start);
488 void handleItemChange(Q3IconViewItem *old, bool shift,
489 bool control, bool homeend = false);
490
491 int calcGridNum(int w, int x) const;
492 Q3IconViewItem *rowBegin(Q3IconViewItem *item) const;
493 void updateItemContainer(Q3IconViewItem *item);
494 void appendItemContainer();
495 void rebuildContainers();
496 enum Direction {
497 DirUp = 0,
498 DirDown,
499 DirLeft,
500 DirRight
501 };
502 Q3IconViewItem* findItem(Direction dir,
503 const QPoint &relativeTo,
504 const QRect &searchRect) const;
505 bool neighbourItem(Direction dir,
506 const QPoint &relativeTo,
507 const Q3IconViewItem *item) const;
508 QBitmap mask(QPixmap *pix) const;
509
510 Q3IconViewPrivate *d;
511};
512
513#endif // QT_NO_ICONVIEW
514
515QT_END_NAMESPACE
516
517QT_END_HEADER
518
519#endif // QICONVIEW_H
Note: See TracBrowser for help on using the repository browser.