--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/src/qt3support/itemviews/q3iconview.h Mon Jan 11 14:00:40 2010 +0000
@@ -0,0 +1,519 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the Qt3Support module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file. Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights. These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#ifndef Q3ICONVIEW_H
+#define Q3ICONVIEW_H
+
+#include <Qt3Support/q3scrollview.h>
+#include <QtCore/qstring.h>
+#include <QtCore/qrect.h>
+#include <QtCore/qpoint.h>
+#include <QtCore/qsize.h>
+#include <QtGui/qfont.h> // QString->QFont conversion
+#include <Qt3Support/q3dragobject.h>
+#include <QtGui/qbitmap.h>
+#include <QtGui/qpicture.h>
+#include <Qt3Support/q3valuelist.h>
+
+QT_BEGIN_HEADER
+
+QT_BEGIN_NAMESPACE
+
+QT_MODULE(Qt3SupportLight)
+
+#ifndef QT_NO_ICONVIEW
+
+class Q3IconView;
+class QPainter;
+class QMimeSource;
+class QMouseEvent;
+class QDragEnterEvent;
+class QDragMoveEvent;
+class QDragLeaveEvent;
+class QKeyEvent;
+class QFocusEvent;
+class QShowEvent;
+class Q3IconViewItem;
+class Q3IconViewItemLineEdit;
+class QStringList;
+class Q3IconDragPrivate;
+class QColorGroup;
+
+#ifndef QT_NO_DRAGANDDROP
+
+class Q_COMPAT_EXPORT Q3IconDragItem
+{
+public:
+ Q3IconDragItem();
+ virtual ~Q3IconDragItem();
+ virtual QByteArray data() const;
+ virtual void setData(const QByteArray &d);
+ bool operator== (const Q3IconDragItem&) const;
+
+private:
+ QByteArray ba;
+
+};
+
+class Q_COMPAT_EXPORT Q3IconDrag : public Q3DragObject
+{
+ Q_OBJECT
+public:
+ Q3IconDrag(QWidget * dragSource, const char* name = 0);
+ virtual ~Q3IconDrag();
+
+ void append(const Q3IconDragItem &item, const QRect &pr, const QRect &tr);
+
+ virtual const char* format(int i) const;
+ static bool canDecode(QMimeSource* e);
+ virtual QByteArray encodedData(const char* mime) const;
+
+private:
+ Q_DISABLE_COPY(Q3IconDrag)
+
+ Q3IconDragPrivate *d;
+ QChar endMark;
+
+ friend class Q3IconView;
+ friend class Q3IconViewPrivate;
+};
+
+#endif
+
+class Q3IconViewToolTip;
+class Q3IconViewItemPrivate;
+
+class Q_COMPAT_EXPORT Q3IconViewItem
+{
+ friend class Q3IconView;
+ friend class Q3IconViewToolTip;
+ friend class Q3IconViewItemLineEdit;
+
+public:
+ Q3IconViewItem(Q3IconView *parent);
+ Q3IconViewItem(Q3IconView *parent, Q3IconViewItem *after);
+ Q3IconViewItem(Q3IconView *parent, const QString &text);
+ Q3IconViewItem(Q3IconView *parent, Q3IconViewItem *after, const QString &text);
+ Q3IconViewItem(Q3IconView *parent, const QString &text, const QPixmap &icon);
+ Q3IconViewItem(Q3IconView *parent, Q3IconViewItem *after, const QString &text, const QPixmap &icon);
+#ifndef QT_NO_PICTURE
+ Q3IconViewItem(Q3IconView *parent, const QString &text, const QPicture &picture);
+ Q3IconViewItem(Q3IconView *parent, Q3IconViewItem *after, const QString &text, const QPicture &picture);
+#endif
+ virtual ~Q3IconViewItem();
+
+ virtual void setRenameEnabled(bool allow);
+ virtual void setDragEnabled(bool allow);
+ virtual void setDropEnabled(bool allow);
+
+ virtual QString text() const;
+ virtual QPixmap *pixmap() const;
+#ifndef QT_NO_PICTURE
+ virtual QPicture *picture() const;
+#endif
+ virtual QString key() const;
+
+ bool renameEnabled() const;
+ bool dragEnabled() const;
+ bool dropEnabled() const;
+
+ Q3IconView *iconView() const;
+ Q3IconViewItem *prevItem() const;
+ Q3IconViewItem *nextItem() const;
+
+ int index() const;
+
+ virtual void setSelected(bool s, bool cb);
+ virtual void setSelected(bool s);
+ virtual void setSelectable(bool s);
+
+ bool isSelected() const;
+ bool isSelectable() const;
+
+ virtual void repaint();
+
+ virtual bool move(int x, int y);
+ virtual void moveBy(int dx, int dy);
+ virtual bool move(const QPoint &pnt);
+ virtual void moveBy(const QPoint &pnt);
+
+ QRect rect() const;
+ int x() const;
+ int y() const;
+ int width() const;
+ int height() const;
+ QSize size() const;
+ QPoint pos() const;
+ QRect textRect(bool relative = true) const;
+ QRect pixmapRect(bool relative = true) const;
+ bool contains(const QPoint& pnt) const;
+ bool intersects(const QRect& r) const;
+
+ virtual bool acceptDrop(const QMimeSource *mime) const;
+
+#ifndef QT_NO_TEXTEDIT
+ void rename();
+#endif
+
+ virtual int compare(Q3IconViewItem *i) const;
+
+ virtual void setText(const QString &text);
+ virtual void setPixmap(const QPixmap &icon);
+#ifndef QT_NO_PICTURE
+ virtual void setPicture(const QPicture &icon);
+#endif
+ virtual void setText(const QString &text, bool recalc, bool redraw = true);
+ virtual void setPixmap(const QPixmap &icon, bool recalc, bool redraw = true);
+ virtual void setKey(const QString &k);
+
+ virtual int rtti() const;
+ static int RTTI;
+
+protected:
+#ifndef QT_NO_TEXTEDIT
+ virtual void removeRenameBox();
+#endif
+ virtual void calcRect(const QString &text_ = QString());
+ virtual void paintItem(QPainter *p, const QColorGroup &cg);
+ virtual void paintFocus(QPainter *p, const QColorGroup &cg);
+#ifndef QT_NO_DRAGANDDROP
+ virtual void dropped(QDropEvent *e, const Q3ValueList<Q3IconDragItem> &lst);
+#endif
+ virtual void dragEntered();
+ virtual void dragLeft();
+ void setItemRect(const QRect &r);
+ void setTextRect(const QRect &r);
+ void setPixmapRect(const QRect &r);
+ void calcTmpText();
+ QString tempText() const;
+
+private:
+ void init(Q3IconViewItem *after = 0
+#ifndef QT_NO_PICTURE
+ , QPicture *pic = 0
+#endif
+ );
+#ifndef QT_NO_TEXTEDIT
+ void renameItem();
+ void cancelRenameItem();
+#endif
+ void checkRect();
+
+ Q3IconView *view;
+ QString itemText, itemKey;
+ QString tmpText;
+ QPixmap *itemIcon;
+#ifndef QT_NO_PICTURE
+ QPicture *itemPic;
+#endif
+ Q3IconViewItem *prev, *next;
+ uint allow_rename : 1;
+ uint allow_drag : 1;
+ uint allow_drop : 1;
+ uint selected : 1;
+ uint selectable : 1;
+ uint dirty : 1;
+ uint wordWrapDirty : 1;
+ QRect itemRect, itemTextRect, itemIconRect;
+#ifndef QT_NO_TEXTEDIT
+ Q3IconViewItemLineEdit *renameBox;
+#endif
+ QRect oldRect;
+
+ Q3IconViewItemPrivate *d;
+
+};
+
+class Q3IconViewPrivate;
+
+class Q_COMPAT_EXPORT Q3IconView : public Q3ScrollView
+{
+ friend class Q3IconViewItem;
+ friend class Q3IconViewPrivate;
+ friend class Q3IconViewToolTip;
+
+ Q_OBJECT
+ // #### sorting and sort direction do not work
+ Q_ENUMS(SelectionMode ItemTextPos Arrangement ResizeMode)
+ Q_PROPERTY(bool sorting READ sorting)
+ Q_PROPERTY(bool sortDirection READ sortDirection)
+ Q_PROPERTY(SelectionMode selectionMode READ selectionMode WRITE setSelectionMode)
+ Q_PROPERTY(int gridX READ gridX WRITE setGridX)
+ Q_PROPERTY(int gridY READ gridY WRITE setGridY)
+ Q_PROPERTY(int spacing READ spacing WRITE setSpacing)
+ Q_PROPERTY(ItemTextPos itemTextPos READ itemTextPos WRITE setItemTextPos)
+ Q_PROPERTY(QBrush itemTextBackground READ itemTextBackground WRITE setItemTextBackground)
+ Q_PROPERTY(Arrangement arrangement READ arrangement WRITE setArrangement)
+ Q_PROPERTY(ResizeMode resizeMode READ resizeMode WRITE setResizeMode)
+ Q_PROPERTY(int maxItemWidth READ maxItemWidth WRITE setMaxItemWidth)
+ Q_PROPERTY(int maxItemTextLength READ maxItemTextLength WRITE setMaxItemTextLength)
+ Q_PROPERTY(bool autoArrange READ autoArrange WRITE setAutoArrange)
+ Q_PROPERTY(bool itemsMovable READ itemsMovable WRITE setItemsMovable)
+ Q_PROPERTY(bool wordWrapIconText READ wordWrapIconText WRITE setWordWrapIconText)
+ Q_PROPERTY(bool showToolTips READ showToolTips WRITE setShowToolTips)
+ Q_PROPERTY(uint count READ count)
+
+public:
+ enum SelectionMode {
+ Single = 0,
+ Multi,
+ Extended,
+ NoSelection
+ };
+ enum Arrangement {
+ LeftToRight = 0,
+ TopToBottom
+ };
+ enum ResizeMode {
+ Fixed = 0,
+ Adjust
+ };
+ enum ItemTextPos {
+ Bottom = 0,
+ Right
+ };
+
+ Q3IconView(QWidget* parent=0, const char* name=0, Qt::WindowFlags f = 0);
+ virtual ~Q3IconView();
+
+ virtual void insertItem(Q3IconViewItem *item, Q3IconViewItem *after = 0L);
+ virtual void takeItem(Q3IconViewItem *item);
+
+ int index(const Q3IconViewItem *item) const;
+
+ Q3IconViewItem *firstItem() const;
+ Q3IconViewItem *lastItem() const;
+ Q3IconViewItem *currentItem() const;
+ virtual void setCurrentItem(Q3IconViewItem *item);
+ virtual void setSelected(Q3IconViewItem *item, bool s, bool cb = false);
+
+ uint count() const;
+
+public:
+ virtual void showEvent(QShowEvent *);
+
+ virtual void setSelectionMode(SelectionMode m);
+ SelectionMode selectionMode() const;
+
+ Q3IconViewItem *findItem(const QPoint &pos) const;
+
+ enum StringComparisonMode {
+ CaseSensitive = 0x00001, // 0 0001
+ BeginsWith = 0x00002, // 0 0010
+ EndsWith = 0x00004, // 0 0100
+ Contains = 0x00008, // 0 1000
+ ExactMatch = 0x00010 // 1 0000
+ };
+ typedef uint ComparisonFlags;
+ Q3IconViewItem *findItem(const QString &text, ComparisonFlags = BeginsWith | Qt::CaseSensitive) const;
+ virtual void selectAll(bool select);
+ virtual void clearSelection();
+ virtual void invertSelection();
+
+ virtual void repaintItem(Q3IconViewItem *item);
+ void repaintSelectedItems();
+
+ void ensureItemVisible(Q3IconViewItem *item);
+ Q3IconViewItem* findFirstVisibleItem(const QRect &r) const;
+ Q3IconViewItem* findLastVisibleItem(const QRect &r) const;
+
+ virtual void clear();
+
+ virtual void setGridX(int rx);
+ virtual void setGridY(int ry);
+ int gridX() const;
+ int gridY() const;
+ virtual void setSpacing(int sp);
+ int spacing() const;
+ virtual void setItemTextPos(ItemTextPos pos);
+ ItemTextPos itemTextPos() const;
+ virtual void setItemTextBackground(const QBrush &b);
+ QBrush itemTextBackground() const;
+ virtual void setArrangement(Arrangement am);
+ Arrangement arrangement() const;
+ virtual void setResizeMode(ResizeMode am);
+ ResizeMode resizeMode() const;
+ virtual void setMaxItemWidth(int w);
+ int maxItemWidth() const;
+ virtual void setMaxItemTextLength(int w);
+ int maxItemTextLength() const;
+ virtual void setAutoArrange(bool b);
+ bool autoArrange() const;
+ virtual void setShowToolTips(bool b);
+ bool showToolTips() const;
+
+ void setSorting(bool sort, bool ascending = true);
+ bool sorting() const;
+ bool sortDirection() const;
+
+ virtual void setItemsMovable(bool b);
+ bool itemsMovable() const;
+ virtual void setWordWrapIconText(bool b);
+ bool wordWrapIconText() const;
+
+ bool eventFilter(QObject * o, QEvent *);
+
+ QSize minimumSizeHint() const;
+ QSize sizeHint() const;
+
+ virtual void sort(bool ascending = true);
+
+ bool isRenaming() const;
+
+ QVariant inputMethodQuery(Qt::InputMethodQuery query) const;
+
+public Q_SLOTS:
+ virtual void arrangeItemsInGrid(const QSize &grid, bool update = true);
+ virtual void arrangeItemsInGrid(bool update = true);
+ virtual void setContentsPos(int x, int y);
+ virtual void updateContents();
+
+Q_SIGNALS:
+ void selectionChanged();
+ void selectionChanged(Q3IconViewItem *item);
+ void currentChanged(Q3IconViewItem *item);
+ void clicked(Q3IconViewItem *);
+ void clicked(Q3IconViewItem *, const QPoint &);
+ void pressed(Q3IconViewItem *);
+ void pressed(Q3IconViewItem *, const QPoint &);
+
+ void doubleClicked(Q3IconViewItem *item);
+ void returnPressed(Q3IconViewItem *item);
+ void rightButtonClicked(Q3IconViewItem* item, const QPoint& pos);
+ void rightButtonPressed(Q3IconViewItem* item, const QPoint& pos);
+ void mouseButtonPressed(int button, Q3IconViewItem* item, const QPoint& pos);
+ void mouseButtonClicked(int button, Q3IconViewItem* item, const QPoint& pos);
+ void contextMenuRequested(Q3IconViewItem* item, const QPoint &pos);
+
+#ifndef QT_NO_DRAGANDDROP
+ void dropped(QDropEvent *e, const Q3ValueList<Q3IconDragItem> &lst);
+#endif
+ void moved();
+ void onItem(Q3IconViewItem *item);
+ void onViewport();
+ void itemRenamed(Q3IconViewItem *item, const QString &);
+ void itemRenamed(Q3IconViewItem *item);
+
+protected Q_SLOTS:
+ virtual void doAutoScroll();
+ virtual void adjustItems();
+ virtual void slotUpdate();
+
+private Q_SLOTS:
+ void movedContents(int dx, int dy);
+
+protected:
+ void drawContents(QPainter *p, int cx, int cy, int cw, int ch);
+ void contentsMousePressEvent(QMouseEvent *e);
+ void contentsMouseReleaseEvent(QMouseEvent *e);
+ void contentsMouseMoveEvent(QMouseEvent *e);
+ void contentsMouseDoubleClickEvent(QMouseEvent *e);
+ void contentsContextMenuEvent(QContextMenuEvent *e);
+
+#ifndef QT_NO_DRAGANDDROP
+ void contentsDragEnterEvent(QDragEnterEvent *e);
+ void contentsDragMoveEvent(QDragMoveEvent *e);
+ void contentsDragLeaveEvent(QDragLeaveEvent *e);
+ void contentsDropEvent(QDropEvent *e);
+#endif
+
+ void resizeEvent(QResizeEvent* e);
+ void keyPressEvent(QKeyEvent *e);
+ void focusInEvent(QFocusEvent *e);
+ void focusOutEvent(QFocusEvent *e);
+ void enterEvent(QEvent *e);
+
+ virtual void drawRubber(QPainter *p);
+#ifndef QT_NO_DRAGANDDROP
+ virtual Q3DragObject *dragObject();
+ virtual void startDrag();
+#endif
+ virtual void insertInGrid(Q3IconViewItem *item);
+ virtual void drawBackground(QPainter *p, const QRect &r);
+
+ void emitSelectionChanged(Q3IconViewItem * i = 0);
+ void emitRenamed(Q3IconViewItem *item);
+
+ Q3IconViewItem *makeRowLayout(Q3IconViewItem *begin, int &y, bool &changed);
+
+ void changeEvent(QEvent *);
+
+private:
+ Q_DISABLE_COPY(Q3IconView)
+
+ void contentsMousePressEventEx(QMouseEvent *e);
+ virtual void drawDragShapes(const QPoint &pnt);
+#ifndef QT_NO_DRAGANDDROP
+ virtual void initDragEnter(QDropEvent *e);
+#endif
+ Q3IconViewItem* findItemByName(Q3IconViewItem *start);
+ void handleItemChange(Q3IconViewItem *old, bool shift,
+ bool control, bool homeend = false);
+
+ int calcGridNum(int w, int x) const;
+ Q3IconViewItem *rowBegin(Q3IconViewItem *item) const;
+ void updateItemContainer(Q3IconViewItem *item);
+ void appendItemContainer();
+ void rebuildContainers();
+ enum Direction {
+ DirUp = 0,
+ DirDown,
+ DirLeft,
+ DirRight
+ };
+ Q3IconViewItem* findItem(Direction dir,
+ const QPoint &relativeTo,
+ const QRect &searchRect) const;
+ bool neighbourItem(Direction dir,
+ const QPoint &relativeTo,
+ const Q3IconViewItem *item) const;
+ QBitmap mask(QPixmap *pix) const;
+
+ Q3IconViewPrivate *d;
+};
+
+#endif // QT_NO_ICONVIEW
+
+QT_END_NAMESPACE
+
+QT_END_HEADER
+
+#endif // QICONVIEW_H