Google Git
Sign in
android / platform / external / qt / 7bfefd596b628604816a01c904428ab99099b10d / . / Windows-4.7.4 / src / qt3support / itemviews / q3iconview.cpp
blob: c48b27b64fc8bddb85522dff8590be9a990c3222 [file] [log] [blame]
/****************************************************************************
**
** Copyright (C) 2011 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$
** GNU Lesser General Public License Usage
** 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.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU General
** Public License version 3.0 as published by the Free Software Foundation
** and appearing in the file LICENSE.GPL included in the packaging of this
** file. Please review the following information to ensure the GNU General
** Public License version 3.0 requirements will be met:
** http://www.gnu.org/copyleft/gpl.html.
**
** Other Usage
** Alternatively, this file may be used in accordance with the terms and
** conditions contained in a signed written agreement between you and Nokia.
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include "qglobal.h"
#if defined(Q_CC_BOR)
// needed for qsort() because of a std namespace problem on Borland
#include "qplatformdefs.h"
#endif
#include "q3iconview.h"
#ifndef QT_NO_ICONVIEW
#include "private/q3richtext_p.h"
#include "q3textedit.h"
#include "qapplication.h"
#include "qbitmap.h"
#include "qbrush.h"
#include "q3cleanuphandler.h"
#include "qcursor.h"
#include "qevent.h"
#include "qfontmetrics.h"
#include "qhash.h"
#include "qimage.h"
#include "qmime.h"
#include "qpainter.h"
#include "qpalette.h"
#include "qpen.h"
#include "qpixmapcache.h"
#include "qstringlist.h"
#include "qstyle.h"
#include "qstyleoption.h"
#include "qtimer.h"
#include "qtooltip.h"
#include "q3strlist.h"
#include <limits.h>
#include <stdlib.h>
QT_BEGIN_NAMESPACE
#define RECT_EXTENSION 300
static const char * const unknown_xpm[] = {
"32 32 11 1",
"c c #ffffff",
"g c #c0c0c0",
"a c #c0ffc0",
"h c #a0a0a4",
"d c #585858",
"f c #303030",
"i c #400000",
"b c #00c000",
"e c #000000",
"# c #000000",
". c None",
"...###..........................",
"...#aa##........................",
".###baaa##......................",
".#cde#baaa##....................",
".#cccdeebaaa##..##f.............",
".#cccccdeebaaa##aaa##...........",
".#cccccccdeebaaaaaaaa##.........",
".#cccccccccdeebaaaaaaa#.........",
".#cccccgcgghhebbbbaaaaa#........",
".#ccccccgcgggdebbbbbbaa#........",
".#cccgcgcgcgghdeebiebbba#.......",
".#ccccgcggggggghdeddeeba#.......",
".#cgcgcgcggggggggghghdebb#......",
".#ccgcggggggggghghghghd#b#......",
".#cgcgcggggggggghghghhd#b#......",
".#gcggggggggghghghhhhhd#b#......",
".#cgcggggggggghghghhhhd#b#......",
".#ggggggggghghghhhhhhhdib#......",
".#gggggggggghghghhhhhhd#b#......",
".#hhggggghghghhhhhhhhhd#b#......",
".#ddhhgggghghghhhhhhhhd#b#......",
"..##ddhhghghhhhhhhhhhhdeb#......",
"....##ddhhhghhhhhhhhhhd#b#......",
"......##ddhhhhhhhhhhhhd#b#......",
"........##ddhhhhhhhhhhd#b#......",
"..........##ddhhhhhhhhd#b#......",
"............##ddhhhhhhd#b###....",
"..............##ddhhhhd#b#####..",
"................##ddhhd#b######.",
"..................##dddeb#####..",
"....................##d#b###....",
"......................####......"};
static QPixmap *unknown_icon = 0;
static QPixmap *qiv_buffer_pixmap = 0;
#if !defined(Q_WS_X11)
static QPixmap *qiv_selection = 0;
#endif
static bool optimize_layout = false;
static void qt_cleanup_iv_pixmaps();
typedef QList<QPixmap *> IVPixmaps;
Q_GLOBAL_STATIC_WITH_INITIALIZER(IVPixmaps, qiv_pixmaps, qAddPostRoutine(qt_cleanup_iv_pixmaps))
static void qt_cleanup_iv_pixmaps()
{
qDeleteAll(*qiv_pixmaps());
}
static QPixmap *get_qiv_buffer_pixmap(const QSize &s)
{
if (!qiv_buffer_pixmap) {
qiv_buffer_pixmap = new QPixmap(s);
qiv_pixmaps()->append(qiv_buffer_pixmap);
return qiv_buffer_pixmap;
}
qiv_buffer_pixmap->resize(s);
return qiv_buffer_pixmap;
}
#ifndef QT_NO_DRAGANDDROP
class Q_COMPAT_EXPORT Q3IconDragData
{
public:
Q3IconDragData();
Q3IconDragData(const QRect &ir, const QRect &tr);
QRect pixmapRect() const;
QRect textRect() const;
void setPixmapRect(const QRect &r);
void setTextRect(const QRect &r);
QRect iconRect_, textRect_;
QString key_;
bool operator==(const Q3IconDragData &i) const;
};
class Q_COMPAT_EXPORT Q3IconDragDataItem
{
public:
Q3IconDragDataItem() {}
Q3IconDragDataItem(const Q3IconDragItem &i1, const Q3IconDragData &i2) : data(i1), item(i2) {}
Q3IconDragItem data;
Q3IconDragData item;
bool operator== (const Q3IconDragDataItem&) const;
};
class Q3IconDragPrivate
{
public:
QLinkedList<Q3IconDragDataItem> items;
static bool decode(QMimeSource* e, QLinkedList<Q3IconDragDataItem> &lst);
};
#endif
class Q3IconViewPrivate
{
public:
Q3IconViewItem *firstItem, *lastItem;
uint count;
Q3IconView::SelectionMode selectionMode;
Q3IconViewItem *currentItem, *tmpCurrentItem, *highlightedItem,
*startDragItem, *pressedItem, *selectAnchor, *renamingItem;
QRect *rubber;
QTimer *scrollTimer, *adjustTimer, *updateTimer, *inputTimer,
*fullRedrawTimer;
int rastX, rastY, spacing;
int dragItems;
QPoint oldDragPos;
Q3IconView::Arrangement arrangement;
Q3IconView::ResizeMode resizeMode;
QSize oldSize;
#ifndef QT_NO_DRAGANDDROP
QLinkedList<Q3IconDragDataItem> iconDragData;
#endif
int numDragItems, cachedW, cachedH;
int maxItemWidth, maxItemTextLength;
QPoint dragStart;
QString currInputString;
Q3IconView::ItemTextPos itemTextPos;
#ifndef QT_NO_CURSOR
QCursor oldCursor;
#endif
int cachedContentsX, cachedContentsY;
QBrush itemTextBrush;
QRegion clipRegion;
QPoint dragStartPos;
QFontMetrics *fm;
int minLeftBearing, minRightBearing;
uint mousePressed : 1;
uint cleared : 1;
uint dropped : 1;
uint clearing : 1;
uint oldDragAcceptAction : 1;
uint isIconDrag : 1;
uint drawDragShapes : 1;
uint dirty : 1;
uint rearrangeEnabled : 1;
uint reorderItemsWhenInsert : 1;
uint drawAllBack : 1;
uint resortItemsWhenInsert : 1;
uint sortDirection : 1;
uint wordWrapIconText : 1;
uint containerUpdateLocked : 1;
uint firstSizeHint : 1;
uint showTips : 1;
uint pressedSelected : 1;
uint dragging : 1;
uint drawActiveSelection : 1;
uint inMenuMode : 1;
QPoint dragPos;
QPixmapCache maskCache;
QHash<Q3IconViewItem *, Q3IconViewItem *> selectedItems;
struct ItemContainer {
ItemContainer(ItemContainer *pr, ItemContainer *nx, const QRect &r)
: p(pr), n(nx), rect(r)
{
if (p)
p->n = this;
if (n)
n->p = this;
}
ItemContainer *p, *n;
QRect rect;
QList<Q3IconViewItem*> items;
} *firstContainer, *lastContainer;
struct SortableItem {
Q3IconViewItem *item;
};
public:
/* finds the containers that intersect with \a searchRect in the direction \a dir relative to \a relativeTo */
QList<ItemContainer* >* findContainers(
Q3IconView:: Direction dir,
const QPoint &relativeTo,
const QRect &searchRect) const;
// friend int cmpIconViewItems(const void *n1, const void *n2);
};
QList<Q3IconViewPrivate::ItemContainer *>* Q3IconViewPrivate::findContainers(
Q3IconView:: Direction dir,
const QPoint &relativeTo,
const QRect &searchRect) const
{
QList<Q3IconViewPrivate::ItemContainer *>* list =
new QList<Q3IconViewPrivate::ItemContainer*>();
if (arrangement == Q3IconView::LeftToRight) {
if (dir == Q3IconView::DirLeft || dir == Q3IconView::DirRight) {
ItemContainer *c = firstContainer;
for (; c; c = c->n)
if (c->rect.intersects(searchRect))
list->append(c);
} else {
if (dir == Q3IconView::DirDown) {
ItemContainer *c = firstContainer;
for (; c; c = c->n)
if (c->rect.intersects(searchRect) &&
c->rect.bottom() >= relativeTo.y())
list->append(c);
} else {
ItemContainer *c = lastContainer;
for (; c; c = c->p)
if (c->rect.intersects(searchRect) &&
c->rect.top() <= relativeTo.y())
list->append(c);
}
}
} else {
if (dir == Q3IconView::DirUp || dir == Q3IconView::DirDown) {
ItemContainer *c = firstContainer;
for (; c; c = c->n)
if (c->rect.intersects(searchRect))
list->append(c);
} else {
if (dir == Q3IconView::DirRight) {
ItemContainer *c = firstContainer;
for (; c; c = c->n)
if (c->rect.intersects(searchRect) &&
c->rect.right() >= relativeTo.x())
list->append(c);
} else {
ItemContainer *c = lastContainer;
for (; c; c = c->p)
if (c->rect.intersects(searchRect) &&
c->rect.left() <= relativeTo.x())
list->append(c);
}
}
}
return list;
}
#if defined(Q_C_CALLBACKS)
extern "C" {
#endif
#ifdef Q_OS_WINCE
static int _cdecl cmpIconViewItems(const void *n1, const void *n2)
#else
static int cmpIconViewItems(const void *n1, const void *n2)
#endif
{
if (!n1 || !n2)
return 0;
Q3IconViewPrivate::SortableItem *i1 = (Q3IconViewPrivate::SortableItem *)n1;
Q3IconViewPrivate::SortableItem *i2 = (Q3IconViewPrivate::SortableItem *)n2;
return i1->item->compare(i2->item);
}
#if defined(Q_C_CALLBACKS)
}
#endif
class Q3IconViewItemPrivate
{
public:
Q3IconViewPrivate::ItemContainer *container1, *container2;
};
#ifndef QT_NO_TEXTEDIT
class Q3IconViewItemLineEdit : public Q3TextEdit
{
friend class Q3IconViewItem;
public:
Q3IconViewItemLineEdit(const QString &text, QWidget *parent, Q3IconViewItem *theItem, const char* name=0);
protected:
void keyPressEvent(QKeyEvent *e);
void focusOutEvent(QFocusEvent *e);
protected:
Q3IconViewItem *item;
QString startText;
private:
Q_DISABLE_COPY(Q3IconViewItemLineEdit)
};
Q3IconViewItemLineEdit::Q3IconViewItemLineEdit(const QString &text, QWidget *parent,
Q3IconViewItem *theItem, const char *name)
: Q3TextEdit(parent, name), item(theItem), startText(text)
{
setFrameStyle(QFrame::Plain | QFrame::Box);
setLineWidth(1);
setHScrollBarMode(AlwaysOff);
setVScrollBarMode(AlwaysOff);
setWordWrap(WidgetWidth);
setWrapColumnOrWidth(item->iconView()->maxItemWidth() -
(item->iconView()->itemTextPos() == Q3IconView::Bottom ?
0 : item->pixmapRect().width()));
document()->formatter()->setAllowBreakInWords(true);
resize(200, 200); // ### some size, there should be a forceReformat()
setTextFormat(Qt::PlainText);
setText(text);
setAlignment(Qt::AlignCenter);
resize(wrapColumnOrWidth() + 2, heightForWidth(wrapColumnOrWidth()) + 2);
}
void Q3IconViewItemLineEdit::keyPressEvent(QKeyEvent *e)
{
if (e->key() == Qt::Key_Escape) {
item->Q3IconViewItem::setText(startText);
item->cancelRenameItem();
} else if (e->key() == Qt::Key_Enter ||
e->key() == Qt::Key_Return) {
item->renameItem();
} else {
Q3TextEdit::keyPressEvent(e);
sync();
resize(width(), document()->height() + 2);
}
}
void Q3IconViewItemLineEdit::focusOutEvent(QFocusEvent *e)
{
Q_UNUSED(e) // I need this to get rid of a Borland warning
if (e->reason() != Qt::PopupFocusReason)
item->cancelRenameItem();
}
#endif
#ifndef QT_NO_DRAGANDDROP
/*!
\class Q3IconDragItem
\brief The Q3IconDragItem class encapsulates a drag item.
\compat
The Q3IconDrag class uses a list of Q3IconDragItems to support drag
and drop operations.
In practice a Q3IconDragItem object (or an object of a class derived
from Q3IconDragItem) is created for each icon view item which is
dragged. Each of these Q3IconDragItems is stored in a Q3IconDrag
object.
See Q3IconView::dragObject() for more information.
*/
/*!
Constructs a Q3IconDragItem with no data.
*/
Q3IconDragItem::Q3IconDragItem()
{
ba = "no data";
}
/*!
Destructor.
*/
Q3IconDragItem::~Q3IconDragItem()
{
}
/*!
Returns the data contained in the Q3IconDragItem.
*/
QByteArray Q3IconDragItem::data() const
{
return ba;
}
/*!
Sets the data for the Q3IconDragItem to the data stored in the
QByteArray \a d.
*/
void Q3IconDragItem::setData(const QByteArray &d)
{
ba = d;
}
/*!
\internal
*/
bool Q3IconDragItem::operator==(const Q3IconDragItem &i) const
{
return ba == i.ba;
}
/*!
\reimp
*/
bool Q3IconDragDataItem::operator==(const Q3IconDragDataItem &i) const
{
return (i.item == item &&
i.data == data);
}
/*!
\reimp
*/
bool Q3IconDragData::operator==(const Q3IconDragData &i) const
{
return key_ == i.key_;
}
/*!
\class Q3IconDrag
\brief The Q3IconDrag class supports drag and drop operations
within a Q3IconView.
\compat
A Q3IconDrag object is used to maintain information about the
positions of dragged items and the data associated with them.
Q3IconViews are able to use this information to paint the dragged
items in the correct positions. Internally, Q3IconDrag stores the
data associated with drag items in Q3IconDragItem objects.
If you want to use the extended drag and drop functionality of
Q3IconView, create a Q3IconDrag object in a reimplementation of
Q3IconView::dragObject(). Then create a Q3IconDragItem for each item
which should be dragged, set the data it represents with
Q3IconDragItem::setData(), and add each Q3IconDragItem to the drag
object using append().
The data in Q3IconDragItems is stored in a QByteArray and is
mime-typed (see QMimeSource and the
\link http://qt.nokia.com/doc/dnd.html Drag and Drop\endlink
overview). If you want to use your own mime-types derive a class
from Q3IconDrag and reimplement format(), encodedData() and
canDecode().
The fileiconview example program demonstrates the use of the
Q3IconDrag class including subclassing and reimplementing
dragObject(), format(), encodedData() and canDecode().
\sa QMimeSource::format()
*/
/*!
Constructs a drag object called \a name, which is a child of \a
dragSource.
Note that the drag object will be deleted when \a dragSource is deleted.
*/
Q3IconDrag::Q3IconDrag(QWidget * dragSource, const char* name)
: Q3DragObject(dragSource, name)
{
d = new Q3IconDragPrivate;
}
/*!
Destructor.
*/
Q3IconDrag::~Q3IconDrag()
{
delete d;
}
/*!
Append the Q3IconDragItem, \a i, to the Q3IconDrag object's list of
items. You must also supply the geometry of the pixmap, \a pr, and
the textual caption, \a tr.
\sa Q3IconDragItem
*/
void Q3IconDrag::append(const Q3IconDragItem &i, const QRect &pr, const QRect &tr)
{
d->items.append(Q3IconDragDataItem(i, Q3IconDragData(pr, tr)));
}
/*!
\reimp
*/
const char* Q3IconDrag::format(int i) const
{
if (i == 0)
return "application/x-qiconlist";
return 0;
}
/*!
Returns the encoded data of the drag object if \a mime is
application/x-qiconlist.
*/
QByteArray Q3IconDrag::encodedData(const char* mime) const
{
if (d->items.size() <= 0 || QString::fromLatin1(mime) !=
QString::fromLatin1("application/x-qiconlist"))
return QByteArray();
QLinkedList<Q3IconDragDataItem>::ConstIterator it = d->items.begin();
QString s;
for (; it != d->items.end(); ++it) {
QString k(QLatin1String("%1$@@$%2$@@$%3$@@$%4$@@$%5$@@$%6$@@$%7$@@$%8$@@$"));
k = k.arg((*it).item.pixmapRect().x()).arg(
(*it).item.pixmapRect().y()).arg((*it).item.pixmapRect().width()).
arg((*it).item.pixmapRect().height()).arg(
(*it).item.textRect().x()).arg((*it).item.textRect().y()).
arg((*it).item.textRect().width()).arg(
(*it).item.textRect().height());
k += QString::fromLatin1((*it).data.data()) + QLatin1String("$@@$");
s += k;
}
QByteArray a;
a.resize(s.length() + 1);
memcpy(a.data(), s.latin1(), a.size());
return a;
}
/*!
Returns true if \a e can be decoded by the Q3IconDrag, otherwise
return false.
*/
bool Q3IconDrag::canDecode(QMimeSource* e)
{
if (e->provides("application/x-qiconlist"))
return true;
return false;
}
/*!
Decodes the data which is stored (encoded) in \a e and, if
successful, fills the \a list of icon drag items with the decoded
data. Returns true if there was some data, false otherwise.
*/
bool Q3IconDragPrivate::decode(QMimeSource* e, QLinkedList<Q3IconDragDataItem> &lst)
{
QByteArray ba = e->encodedData("application/x-qiconlist");
if (ba.size()) {
lst.clear();
// #### unicode clean????
QString s = QString::fromLatin1(ba);
Q3IconDragDataItem item;
QRect ir, tr;
QStringList l = QStringList::split(QLatin1String("$@@$"), s);
int i = 0;
QStringList::Iterator it = l.begin();
for (; it != l.end(); ++it) {
if (i == 0) {
ir.setX((*it).toInt());
} else if (i == 1) {
ir.setY((*it).toInt());
} else if (i == 2) {
ir.setWidth((*it).toInt());
} else if (i == 3) {
ir.setHeight((*it).toInt());
} else if (i == 4) {
tr.setX((*it).toInt());
} else if (i == 5) {
tr.setY((*it).toInt());
} else if (i == 6) {
tr.setWidth((*it).toInt());
} else if (i == 7) {
tr.setHeight((*it).toInt());
} else if (i == 8) {
QByteArray d;
d.resize((*it).length());
memcpy(d.data(), (*it).latin1(), (*it).length());
item.item.setPixmapRect(ir);
item.item.setTextRect(tr);
item.data.setData(d);
lst.append(item);
}
++i;
if (i > 8)
i = 0;
}
return true;
}
return false;
}
Q3IconDragData::Q3IconDragData()
: iconRect_(), textRect_()
{
}
Q3IconDragData::Q3IconDragData(const QRect &ir, const QRect &tr)
: iconRect_(ir), textRect_(tr)
{
}
QRect Q3IconDragData::textRect() const
{
return textRect_;
}
QRect Q3IconDragData::pixmapRect() const
{
return iconRect_;
}
void Q3IconDragData::setPixmapRect(const QRect &r)
{
iconRect_ = r;
}
void Q3IconDragData::setTextRect(const QRect &r)
{
textRect_ = r;
}
#endif
/*!
\class Q3IconViewItem
\brief The Q3IconViewItem class provides a single item in a Q3IconView.
\compat
A Q3IconViewItem contains an icon, a string and optionally a sort
key, and can display itself in a Q3IconView.
The simplest way to create a Q3IconViewItem and insert it into a
Q3IconView is to construct the item passing the constructor a
pointer to the icon view, a string and an icon:
\snippet doc/src/snippets/code/src_qt3support_itemviews_q3iconview.cpp 0
By default the text of an icon view item may not be edited by the
user but calling setRenameEnabled(true) will allow the user to
perform in-place editing of the item's text.
When the icon view is deleted all items in it are deleted
automatically.
The Q3IconView::firstItem() and Q3IconViewItem::nextItem() functions
provide a means of iterating over all the items in a Q3IconView:
\snippet doc/src/snippets/code/src_qt3support_itemviews_q3iconview.cpp 1
The item's icon view is available from iconView(), and its
position in the icon view from index().
The item's selection status is available from isSelected() and is
set and controlled by setSelected() and isSelectable().
The text and icon can be set with setText() and setPixmap() and
retrieved with text() and pixmap(). The item's sort key defaults
to text() but may be set with setKey() and retrieved with key().
The comparison function, compare() uses key().
Items may be repositioned with move() and moveBy(). An item's
geometry is available from rect(), x(), y(), width(), height(),
size(), pos(), textRect() and pixmapRect(). You can also test
against the position of a point with contains() and intersects().
To remove an item from an icon view, just delete the item. The
Q3IconViewItem destructor removes it cleanly from its icon view.
Because the icon view is designed to use drag-and-drop, the icon
view item also has functions for drag-and-drop which may be
reimplemented.
The class is designed to be very similar to Q3ListView and Q3ListBox
in use, both via instantiation and subclassing.
*/
/*!
Constructs a Q3IconViewItem and inserts it into icon view \a parent
with no text and a default icon.
*/
Q3IconViewItem::Q3IconViewItem(Q3IconView *parent)
: view(parent), itemText(), itemIcon(unknown_icon)
{
init();
}
/*!
Constructs a Q3IconViewItem and inserts it into the icon view \a
parent with no text and a default icon, after the icon view item
\a after.
*/
Q3IconViewItem::Q3IconViewItem(Q3IconView *parent, Q3IconViewItem *after)
: view(parent), itemText(), itemIcon(unknown_icon),
prev(0), next(0)
{
init(after);
}
/*!
Constructs an icon view item and inserts it into the icon view \a
parent using \a text as the text and a default icon.
*/
Q3IconViewItem::Q3IconViewItem(Q3IconView *parent, const QString &text)
: view(parent), itemText(text), itemIcon(unknown_icon)
{
init(0);
}
/*!
Constructs an icon view item and inserts it into the icon view \a
parent using \a text as the text and a default icon, after the
icon view item \a after.
*/
Q3IconViewItem::Q3IconViewItem(Q3IconView *parent, Q3IconViewItem *after,
const QString &text)
: view(parent), itemText(text), itemIcon(unknown_icon)
{
init(after);
}
/*!
Constructs an icon view item and inserts it into the icon view \a
parent using \a text as the text and \a icon as the icon.
*/
Q3IconViewItem::Q3IconViewItem(Q3IconView *parent, const QString &text,
const QPixmap &icon)
: view(parent),
itemText(text), itemIcon(new QPixmap(icon))
{
init(0);
}
/*!
Constructs an icon view item and inserts it into the icon view \a
parent using \a text as the text and \a icon as the icon, after
the icon view item \a after.
*/
Q3IconViewItem::Q3IconViewItem(Q3IconView *parent, Q3IconViewItem *after,
const QString &text, const QPixmap &icon)
: view(parent), itemText(text), itemIcon(new QPixmap(icon))
{
init(after);
}
/*!
Constructs an icon view item and inserts it into the icon view \a
parent using \a text as the text and \a picture as the icon.
*/
#ifndef QT_NO_PICTURE
Q3IconViewItem::Q3IconViewItem(Q3IconView *parent, const QString &text,
const QPicture &picture)
: view(parent), itemText(text), itemIcon(0)
{
init(0, new QPicture(picture));
}
/*!
Constructs an icon view item and inserts it into the icon view \a
parent using \a text as the text and \a picture as the icon, after
the icon view item \a after.
*/
Q3IconViewItem::Q3IconViewItem(Q3IconView *parent, Q3IconViewItem *after,
const QString &text, const QPicture &picture)
: view(parent), itemText(text), itemIcon(0)
{
init(after, new QPicture(picture));
}
#endif
/*!
This private function initializes the icon view item and inserts it
into the icon view.
*/
void Q3IconViewItem::init(Q3IconViewItem *after
#ifndef QT_NO_PICTURE
, QPicture *pic
#endif
)
{
d = new Q3IconViewItemPrivate;
d->container1 = 0;
d->container2 = 0;
prev = next = 0;
allow_rename = false;
allow_drag = true;
allow_drop = true;
selected = false;
selectable = true;
#ifndef QT_NO_TEXTEDIT
renameBox = 0;
#endif
#ifndef QT_NO_PICTURE
itemPic = pic;
#endif
if (view) {
itemKey = itemText;
dirty = true;
wordWrapDirty = true;
itemRect = QRect(-1, -1, 0, 0);
calcRect();
view->insertItem(this, after);
}
}
/*!
Destroys the icon view item and tells the parent icon view that
the item has been destroyed.
*/
Q3IconViewItem::~Q3IconViewItem()
{
#ifndef QT_NO_TEXTEDIT
removeRenameBox();
#endif
if (view && !view->d->clearing)
view->takeItem(this);
view = 0;
if (itemIcon && itemIcon->serialNumber() != unknown_icon->serialNumber())
delete itemIcon;
#ifndef QT_NO_PICTURE
delete itemPic;
#endif
delete d;
}
int Q3IconViewItem::RTTI = 0;
/*!
Returns 0.
Make your derived classes return their own values for rtti(), so
that you can distinguish between icon view item types. You should
use values greater than 1000, preferably a large random number, to
allow for extensions to this class.
*/
int Q3IconViewItem::rtti() const
{
return RTTI;
}
/*!
Sets \a text as the text of the icon view item. This function
might be a no-op if you reimplement text().
\sa text()
*/
void Q3IconViewItem::setText(const QString &text)
{
if (text == itemText)
return;
wordWrapDirty = true;
itemText = text;
if (itemKey.isEmpty())
itemKey = itemText;
QRect oR = rect();
calcRect();
oR = oR.united(rect());
if (view) {
if (QRect(view->contentsX(), view->contentsY(),
view->visibleWidth(), view->visibleHeight()).
intersects(oR))
view->repaintContents(oR.x() - 1, oR.y() - 1, oR.width() + 2, oR.height() + 2);
}
}
/*!
Sets \a k as the sort key of the icon view item. By default
text() is used for sorting.
\sa compare()
*/
void Q3IconViewItem::setKey(const QString &k)
{
if (k == itemKey)
return;
itemKey = k;
}
/*!
Sets \a icon as the item's icon in the icon view. This function
might be a no-op if you reimplement pixmap().
\sa pixmap()
*/
void Q3IconViewItem::setPixmap(const QPixmap &icon)
{
if (itemIcon && itemIcon == unknown_icon)
itemIcon = 0;
if (itemIcon)
*itemIcon = icon;
else
itemIcon = new QPixmap(icon);
QRect oR = rect();
calcRect();
oR = oR.united(rect());
if (view) {
if (QRect(view->contentsX(), view->contentsY(),
view->visibleWidth(), view->visibleHeight()).
intersects(oR))
view->repaintContents(oR.x() - 1, oR.y() - 1, oR.width() + 2, oR.height() + 2);
}
}
/*!
Sets \a icon as the item's icon in the icon view. This function
might be a no-op if you reimplement picture().
\sa picture()
*/
#ifndef QT_NO_PICTURE
void Q3IconViewItem::setPicture(const QPicture &icon)
{
// clear assigned pixmap if any
if (itemIcon) {
if (itemIcon == unknown_icon) {
itemIcon = 0;
} else {
delete itemIcon;
itemIcon = 0;
}
}
if (itemPic)
delete itemPic;
itemPic = new QPicture(icon);
QRect oR = rect();
calcRect();
oR = oR.united(rect());
if (view) {
if (QRect(view->contentsX(), view->contentsY(),
view->visibleWidth(), view->visibleHeight()).
intersects(oR))
view->repaintContents(oR.x() - 1, oR.y() - 1, oR.width() + 2, oR.height() + 2);
}
}
#endif
/*!
\overload
Sets \a text as the text of the icon view item. If \a recalc is
true, the icon view's layout is recalculated. If \a redraw is true
(the default), the icon view is repainted.
\sa text()
*/
void Q3IconViewItem::setText(const QString &text, bool recalc, bool redraw)
{
if (text == itemText)
return;
wordWrapDirty = true;
itemText = text;
if (recalc)
calcRect();
if (redraw)
repaint();
}
/*!
\overload
Sets \a icon as the item's icon in the icon view. If \a recalc is
true, the icon view's layout is recalculated. If \a redraw is true
(the default), the icon view is repainted.
\sa pixmap()
*/
void Q3IconViewItem::setPixmap(const QPixmap &icon, bool recalc, bool redraw)
{
if (itemIcon && itemIcon == unknown_icon)
itemIcon = 0;
if (itemIcon)
*itemIcon = icon;
else
itemIcon = new QPixmap(icon);
if (redraw) {
if (recalc) {
QRect oR = rect();
calcRect();
oR = oR.united(rect());
if (view) {
if (QRect(view->contentsX(), view->contentsY(),
view->visibleWidth(), view->visibleHeight()).
intersects(oR))
view->repaintContents(oR.x() - 1, oR.y() - 1, oR.width() + 2, oR.height() + 2);
}
} else {
repaint();
}
} else if (recalc) {
calcRect();
}
}
/*!
If \a allow is true, the user can rename the icon view item by
clicking on the text (or pressing F2) while the item is selected
(in-place renaming). If \a allow is false, in-place renaming is
not possible.
*/
void Q3IconViewItem::setRenameEnabled(bool allow)
{
allow_rename = (uint)allow;
}
/*!
If \a allow is true, the icon view permits the user to drag the
icon view item either to another position within the icon view or
to somewhere outside of it. If \a allow is false, the item cannot
be dragged.
*/
void Q3IconViewItem::setDragEnabled(bool allow)
{
allow_drag = (uint)allow;
}
/*!
If \a allow is true, the icon view lets the user drop something on
this icon view item.
*/
void Q3IconViewItem::setDropEnabled(bool allow)
{
allow_drop = (uint)allow;
}
/*!
Returns the text of the icon view item. Normally you set the text
of the item with setText(), but sometimes it's inconvenient to
call setText() for every item; so you can subclass Q3IconViewItem,
reimplement this function, and return the text of the item. If you
do this, you must call calcRect() manually each time the text
(and therefore its size) changes.
\sa setText()
*/
QString Q3IconViewItem::text() const
{
return itemText;
}
/*!
Returns the key of the icon view item or text() if no key has been
explicitly set.
\sa setKey(), compare()
*/
QString Q3IconViewItem::key() const
{
return itemKey;
}
/*!
Returns the icon of the icon view item if it is a pixmap, or 0 if
it is a picture. In the latter case use picture() instead.
Normally you set the pixmap of the item with setPixmap(), but
sometimes it's inconvenient to call setPixmap() for every item. So
you can subclass Q3IconViewItem, reimplement this function and
return a pointer to the item's pixmap. If you do this, you \e must
call calcRect() manually each time the size of this pixmap
changes.
\sa setPixmap()
*/
QPixmap *Q3IconViewItem::pixmap() const
{
return itemIcon;
}
/*!
Returns the icon of the icon view item if it is a picture, or 0 if
it is a pixmap. In the latter case use pixmap() instead. Normally
you set the picture of the item with setPicture(), but sometimes
it's inconvenient to call setPicture() for every item. So you can
subclass Q3IconViewItem, reimplement this function and return a
pointer to the item's picture. If you do this, you \e must call
calcRect() manually each time the size of this picture changes.
\sa setPicture()
*/
#ifndef QT_NO_PICTURE
QPicture *Q3IconViewItem::picture() const
{
return itemPic;
}
#endif
/*!
Returns true if the item can be renamed by the user with in-place
renaming; otherwise returns false.
\sa setRenameEnabled()
*/
bool Q3IconViewItem::renameEnabled() const
{
return (bool)allow_rename;
}
/*!
Returns true if the user is allowed to drag the icon view item;
otherwise returns false.
\sa setDragEnabled()
*/
bool Q3IconViewItem::dragEnabled() const
{
return (bool)allow_drag;
}
/*!
Returns true if the user is allowed to drop something onto the
item; otherwise returns false.
\sa setDropEnabled()
*/
bool Q3IconViewItem::dropEnabled() const
{
return (bool)allow_drop;
}
/*!
Returns a pointer to this item's icon view parent.
*/
Q3IconView *Q3IconViewItem::iconView() const
{
return view;
}
/*!
Returns a pointer to the previous item, or 0 if this is the first
item in the icon view.
\sa nextItem() Q3IconView::firstItem()
*/
Q3IconViewItem *Q3IconViewItem::prevItem() const
{
return prev;
}
/*!
Returns a pointer to the next item, or 0 if this is the last item
in the icon view.
To find the first item use Q3IconView::firstItem().
Example:
\snippet doc/src/snippets/code/src_qt3support_itemviews_q3iconview.cpp 2
\sa prevItem()
*/
Q3IconViewItem *Q3IconViewItem::nextItem() const
{
return next;
}
/*!
Returns the index of this item in the icon view, or -1 if an error
occurred.
*/
int Q3IconViewItem::index() const
{
if (view)
return view->index(this);
return -1;
}
/*!
\overload
This variant is equivalent to calling the other variant with \e cb
set to false.
*/
void Q3IconViewItem::setSelected(bool s)
{
setSelected(s, false);
}
/*!
Selects or unselects the item, depending on \a s; it may also
unselect other items, depending on Q3IconView::selectionMode() and
\a cb.
If \a s is false, the item is unselected.
If \a s is true and Q3IconView::selectionMode() is
Q3IconView::Single, the item is selected and the item previously
selected is unselected.
If \a s is true and Q3IconView::selectionMode() is
Q3IconView::Extended, the item is selected. If \a cb is true, the
selection state of the other items is left unchanged. If \a cb is
false (the default) all other items are unselected.
If \a s is true and Q3IconView::selectionMode() is
Q3IconView::Multi, the item is selected.
Note that \a cb is used only if Q3IconView::selectionMode() is
Q3IconView::Extended; cb defaults to false.
All items whose selection status changes repaint themselves.
*/
void Q3IconViewItem::setSelected(bool s, bool cb)
{
if (!view)
return;
if (view->selectionMode() != Q3IconView::NoSelection &&
selectable && s != (bool)selected) {
if (view->d->selectionMode == Q3IconView::Single && this != view->d->currentItem) {
Q3IconViewItem *o = view->d->currentItem;
if (o && o->selected)
o->selected = false;
view->d->currentItem = this;
if (o)
o->repaint();
emit view->currentChanged(this);
}
if (!s) {
selected = false;
} else {
if (view->d->selectionMode == Q3IconView::Single && view->d->currentItem) {
view->d->currentItem->selected = false;
}
if ((view->d->selectionMode == Q3IconView::Extended && !cb) ||
view->d->selectionMode == Q3IconView::Single) {
bool b = view->signalsBlocked();
view->blockSignals(true);
view->selectAll(false);
view->blockSignals(b);
}
selected = s;
}
repaint();
if (!view->signalsBlocked()) {
bool emitIt = view->d->selectionMode == Q3IconView::Single && s;
Q3IconView *v = view;
emit v->selectionChanged();
if (emitIt)
emit v->selectionChanged(this);
}
}
}
/*!
Sets this item to be selectable if \a enable is true (the default)
or unselectable if \a enable is false.
The user is unable to select a non-selectable item using either
the keyboard or the mouse. (The application programmer can select
an item in code regardless of this setting.)
\sa isSelectable()
*/
void Q3IconViewItem::setSelectable(bool enable)
{
selectable = (uint)enable;
}
/*!
Returns true if the item is selected; otherwise returns false.
\sa setSelected()
*/
bool Q3IconViewItem::isSelected() const
{
return (bool)selected;
}
/*!
Returns true if the item is selectable; otherwise returns false.
\sa setSelectable()
*/
bool Q3IconViewItem::isSelectable() const
{
return (bool)selectable;
}
/*!
Repaints the item.
*/
void Q3IconViewItem::repaint()
{
if (view)
view->repaintItem(this);
}
/*!
Moves the item to position (\a x, \a y) in the icon view (these
are contents coordinates). Returns true if the item is moved.
Returns false if the item is already at the specified position.
*/
bool Q3IconViewItem::move(int x, int y)
{
if (x == this->x() && y == this->y())
return false;
itemRect.setRect(x, y, itemRect.width(), itemRect.height());
checkRect();
if (view)
view->updateItemContainer(this);
return true;
}
/*!
Moves the item \a dx pixels in the x-direction and \a dy pixels in
the y-direction.
*/
void Q3IconViewItem::moveBy(int dx, int dy)
{
itemRect.moveBy(dx, dy);
checkRect();
if (view)
view->updateItemContainer(this);
}
/*!
\overload
Moves the item to the point \a pnt.
*/
bool Q3IconViewItem::move(const QPoint &pnt)
{
return move(pnt.x(), pnt.y());
}
/*!
\overload
Moves the item by the x, y values in point \a pnt.
*/
void Q3IconViewItem::moveBy(const QPoint &pnt)
{
moveBy(pnt.x(), pnt.y());
}
/*!
Returns the bounding rectangle of the item (in contents
coordinates).
*/
QRect Q3IconViewItem::rect() const
{
return itemRect;
}
/*!
Returns the x-coordinate of the item (in contents coordinates).
*/
int Q3IconViewItem::x() const
{
return itemRect.x();
}
/*!
Returns the y-coordinate of the item (in contents coordinates).
*/
int Q3IconViewItem::y() const
{
return itemRect.y();
}
/*!
Returns the width of the item.
*/
int Q3IconViewItem::width() const
{
return qMax(itemRect.width(), QApplication::globalStrut().width());
}
/*!
Returns the height of the item.
*/
int Q3IconViewItem::height() const
{
return qMax(itemRect.height(), QApplication::globalStrut().height());
}
/*!
Returns the size of the item.
*/
QSize Q3IconViewItem::size() const
{
return QSize(itemRect.width(), itemRect.height());
}
/*!
Returns the position of the item (in contents coordinates).
*/
QPoint Q3IconViewItem::pos() const
{
return QPoint(itemRect.x(), itemRect.y());
}
/*!
Returns the bounding rectangle of the item's text.
If \a relative is true, (the default), the returned rectangle is
relative to the origin of the item's rectangle. If \a relative is
false, the returned rectangle is relative to the origin of the
icon view's contents coordinate system.
*/
QRect Q3IconViewItem::textRect(bool relative) const
{
if (relative)
return itemTextRect;
else
return QRect(x() + itemTextRect.x(), y() + itemTextRect.y(), itemTextRect.width(), itemTextRect.height());
}
/*!
Returns the bounding rectangle of the item's icon.
If \a relative is true, (the default), the rectangle is relative to
the origin of the item's rectangle. If \a relative is false, the
returned rectangle is relative to the origin of the icon view's
contents coordinate system.
*/
QRect Q3IconViewItem::pixmapRect(bool relative) const
{
if (relative)
return itemIconRect;
else
return QRect(x() + itemIconRect.x(), y() + itemIconRect.y(), itemIconRect.width(), itemIconRect.height());
}
/*!
Returns true if the item contains the point \a pnt (in contents
coordinates); otherwise returns false.
*/
bool Q3IconViewItem::contains(const QPoint& pnt) const
{
QRect textArea = textRect(false);
QRect pixmapArea = pixmapRect(false);
if (iconView()->itemTextPos() == Q3IconView::Bottom)
textArea.setTop(pixmapArea.bottom());
else
textArea.setLeft(pixmapArea.right());
return textArea.contains(pnt) || pixmapArea.contains(pnt);
}
/*!
Returns true if the item intersects the rectangle \a r (in
contents coordinates); otherwise returns false.
*/
bool Q3IconViewItem::intersects(const QRect& r) const
{
return (textRect(false).intersects(r) ||
pixmapRect(false).intersects(r));
}
/*!
\fn bool Q3IconViewItem::acceptDrop(const QMimeSource *mime) const
Returns true if you can drop things with a QMimeSource of \a mime
onto this item; otherwise returns false.
The default implementation always returns false. You must subclass
Q3IconViewItem and reimplement acceptDrop() to accept drops.
*/
bool Q3IconViewItem::acceptDrop(const QMimeSource *) const
{
return false;
}
#ifndef QT_NO_TEXTEDIT
/*!
Starts in-place renaming of an icon, if allowed.
This function sets up the icon view so that the user can edit the
item text, and then returns. When the user is done, setText() will
be called and Q3IconView::itemRenamed() will be emitted (unless the
user canceled, e.g. by pressing the Escape key).
\sa setRenameEnabled()
*/
void Q3IconViewItem::rename()
{
if (!view)
return;
if (renameBox)
removeRenameBox();
oldRect = rect();
renameBox = new Q3IconViewItemLineEdit(itemText, view->viewport(), this, "qt_renamebox");
iconView()->ensureItemVisible(this);
QRect tr(textRect(false));
view->addChild(renameBox, tr.x() + (tr.width() / 2 - renameBox->width() / 2), tr.y() - 3);
renameBox->selectAll();
view->viewport()->setFocusProxy(renameBox);
renameBox->setFocus();
renameBox->show();
Q_ASSERT(view->d->renamingItem == 0L);
view->d->renamingItem = this;
}
#endif
/*!
Compares this icon view item to \a i. Returns -1 if this item is
less than \a i, 0 if they are equal, and 1 if this icon view item
is greater than \a i.
The default implementation compares the item keys (key()) using
QString::localeAwareCompare(). A reimplementation may use
different values and a different comparison function. Here is a
reimplementation that uses plain Unicode comparison:
\snippet doc/src/snippets/code/src_qt3support_itemviews_q3iconview.cpp 3
\sa key() QString::localeAwareCompare() QString::compare()
*/
int Q3IconViewItem::compare(Q3IconViewItem *i) const
{
return key().localeAwareCompare(i->key());
}
#ifndef QT_NO_TEXTEDIT
/*!
This private function is called when the user pressed Return during
in-place renaming.
*/
void Q3IconViewItem::renameItem()
{
if (!renameBox || !view)
return;
if (!view->d->wordWrapIconText) {
wordWrapDirty = true;
calcRect();
}
QRect r = itemRect;
setText(renameBox->text());
view->repaintContents(oldRect.x() - 1, oldRect.y() - 1, oldRect.width() + 2, oldRect.height() + 2);
view->repaintContents(r.x() - 1, r.y() - 1, r.width() + 2, r.height() + 2);
removeRenameBox();
view->emitRenamed(this);
}
/*!
Cancels in-place renaming.
*/
void Q3IconViewItem::cancelRenameItem()
{
if (!view)
return;
QRect r = itemRect;
calcRect();
view->repaintContents(oldRect.x() - 1, oldRect.y() - 1, oldRect.width() + 2, oldRect.height() + 2);
view->repaintContents(r.x() - 1, r.y() - 1, r.width() + 2, r.height() + 2);
if (!renameBox)
return;
removeRenameBox();
}
/*!
Removes the editbox that is used for in-place renaming.
*/
void Q3IconViewItem::removeRenameBox()
{
if (!renameBox || !view)
return;
bool resetFocus = view->viewport()->focusProxy() == renameBox;
renameBox->hide();
renameBox->deleteLater();
renameBox = 0;
if (resetFocus) {
view->viewport()->setFocusProxy(view);
view->setFocus();
}
Q_ASSERT(view->d->renamingItem == this);
view->d->renamingItem = 0L;
}
#endif
/*!
This virtual function is responsible for calculating the
rectangles returned by rect(), textRect() and pixmapRect().
setRect(), setTextRect() and setPixmapRect() are provided mainly
for reimplementations of this function.
\a text_ is an internal parameter which defaults to an empty
string.
*/
void Q3IconViewItem::calcRect(const QString &text_)
{
if (!view) // #####
return;
wordWrapDirty = true;
int pw = 0;
int ph = 0;
#ifndef QT_NO_PICTURE
if (picture()) {
QRect br = picture()->boundingRect();
pw = br.width() + 2;
ph = br.height() + 2;
} else
#endif
{
pw = (pixmap() ? pixmap() : unknown_icon)->width() + 2;
ph = (pixmap() ? pixmap() : unknown_icon)->height() + 2;
}
itemIconRect.setWidth(pw);
itemIconRect.setHeight(ph);
calcTmpText();
QString t = text_;
if (t.isEmpty()) {
if (view->d->wordWrapIconText)
t = itemText;
else
t = tmpText;
}
int tw = 0;
int th = 0;
// ##### TODO: fix font bearings!
QRect r;
if (view->d->wordWrapIconText) {
r = QRect(view->d->fm->boundingRect(0, 0, iconView()->maxItemWidth() -
(iconView()->itemTextPos() == Q3IconView::Bottom ? 0 :
pixmapRect().width()),
0xFFFFFFFF, Qt::AlignHCenter | Qt::WordBreak | Qt::BreakAnywhere, t));
r.setWidth(r.width() + 4);
} else {
r = QRect(0, 0, view->d->fm->width(t), view->d->fm->height());
r.setWidth(r.width() + 4);
}
if (r.width() > iconView()->maxItemWidth() -
(iconView()->itemTextPos() == Q3IconView::Bottom ? 0 :
pixmapRect().width()))
r.setWidth(iconView()->maxItemWidth() - (iconView()->itemTextPos() == Q3IconView::Bottom ? 0 :
pixmapRect().width()));
tw = r.width();
th = r.height();
if (tw < view->d->fm->width(QLatin1Char('X')))
tw = view->d->fm->width(QLatin1Char('X'));
itemTextRect.setWidth(tw);
itemTextRect.setHeight(th);
int w = 0;
int h = 0;
if (view->itemTextPos() == Q3IconView::Bottom) {
w = qMax(itemTextRect.width(), itemIconRect.width());
h = itemTextRect.height() + itemIconRect.height() + 1;
itemRect.setWidth(w);
itemRect.setHeight(h);
itemTextRect = QRect((width() - itemTextRect.width()) / 2, height() - itemTextRect.height(),
itemTextRect.width(), itemTextRect.height());
itemIconRect = QRect((width() - itemIconRect.width()) / 2, 0,
itemIconRect.width(), itemIconRect.height());
} else {
h = qMax(itemTextRect.height(), itemIconRect.height());
w = itemTextRect.width() + itemIconRect.width() + 1;
itemRect.setWidth(w);
itemRect.setHeight(h);
itemTextRect = QRect(width() - itemTextRect.width(), (height() - itemTextRect.height()) / 2,
itemTextRect.width(), itemTextRect.height());
itemIconRect = QRect(0, (height() - itemIconRect.height()) / 2,
itemIconRect.width(), itemIconRect.height());
}
if (view)
view->updateItemContainer(this);
}
/*!
Paints the item using the painter \a p and the color group \a cg.
If you want the item to be drawn with a different font or color,
reimplement this function, change the values of the color group or
the painter's font, and then call the Q3IconViewItem::paintItem()
with the changed values.
*/
void Q3IconViewItem::paintItem(QPainter *p, const QColorGroup &cg)
{
if (!view)
return;
p->save();
if (isSelected()) {
p->setPen(cg.highlightedText());
} else {
p->setPen(cg.text());
}
calcTmpText();
#ifndef QT_NO_PICTURE
if (picture()) {
QPicture *pic = picture();
if (isSelected()) {
p->fillRect(pixmapRect(false), QBrush(cg.highlight(), Qt::Dense4Pattern));
}
p->drawPicture(x()-pic->boundingRect().x(), y()-pic->boundingRect().y(), *pic);
if (isSelected()) {
p->fillRect(textRect(false), cg.highlight());
p->setPen(QPen(cg.highlightedText()));
} else if (view->d->itemTextBrush != QBrush(Qt::NoBrush))
p->fillRect(textRect(false), view->d->itemTextBrush);
int align = view->itemTextPos() == Q3IconView::Bottom ? Qt::AlignHCenter : Qt::AlignAuto;
if (view->d->wordWrapIconText)
align |= Qt::WordBreak | Qt::BreakAnywhere;
p->drawText(textRect(false), align, view->d->wordWrapIconText ? itemText : tmpText);
p->restore();
return;
}
#endif
bool textOnBottom = (view->itemTextPos() == Q3IconView::Bottom);
int dim;
if (textOnBottom)
dim = (pixmap() ? pixmap() : unknown_icon)->width();
else
dim = (pixmap() ? pixmap() : unknown_icon)->height();
if (isSelected()) {
QPixmap *pix = pixmap() ? pixmap() : unknown_icon;
if (pix && !pix->isNull()) {
QPixmap *buffer = get_qiv_buffer_pixmap(pix->size());
QBitmap mask = view->mask(pix);
QPainter p2(buffer);
p2.fillRect(pix->rect(), Qt::white);
p2.drawPixmap(0, 0, *pix);
p2.end();
p2.begin(buffer);
p2.fillRect(pix->rect(), QBrush(cg.highlight(), Qt::Dense4Pattern));
p2.end();
buffer->setMask(mask);
QRect cr = pix->rect();
if (textOnBottom)
p->drawPixmap(x() + (width() - dim) / 2, y(), *buffer, 0, 0,
cr.width(), cr.height());
else
p->drawPixmap(x() , y() + (height() - dim) / 2, *buffer, 0, 0,
cr.width(), cr.height());
}
} else {
if (textOnBottom)
p->drawPixmap(x() + (width() - dim) / 2, y(),
*(pixmap() ? pixmap() : unknown_icon));
else
p->drawPixmap(x() , y() + (height() - dim) / 2,
*(pixmap() ? pixmap() : unknown_icon));
}
p->save();
if (isSelected()) {
p->fillRect(textRect(false), cg.highlight());
p->setPen(QPen(cg.highlightedText()));
} else if (view->d->itemTextBrush != QBrush(Qt::NoBrush))
p->fillRect(textRect(false), view->d->itemTextBrush);
int align = Qt::AlignHCenter;
if (view->d->wordWrapIconText)
align |= Qt::WordBreak | Qt::BreakAnywhere;
p->drawText(textRect(false), align,
view->d->wordWrapIconText ? itemText : tmpText);
p->restore();
p->restore();
}
/*!
Paints the focus rectangle of the item using the painter \a p and
the color group \a cg.
*/
void Q3IconViewItem::paintFocus(QPainter *p, const QColorGroup &cg)
{
if (!view)
return;
QStyleOptionFocusRect opt;
opt.rect = textRect(false);
opt.palette = cg;
if (isSelected()) {
opt.state = QStyle::State_FocusAtBorder;
opt.backgroundColor = cg.highlight();
} else {
opt.state = QStyle::State_None;
opt.backgroundColor = cg.base();
}
view->style()->drawPrimitive(QStyle::PE_FrameFocusRect, &opt, p);
if (this != view->d->currentItem) {
opt.rect = pixmapRect(false);
opt.backgroundColor = cg.base();
opt.state = QStyle::State_None;
view->style()->drawPrimitive(QStyle::PE_FrameFocusRect, &opt, p);
}
}
#ifndef QT_NO_DRAGANDDROP
/*!
\fn void Q3IconViewItem::dropped(QDropEvent *e, const Q3ValueList<Q3IconDragItem> &lst)
This function is called when something is dropped on the item. \a
e provides all the information about the drop. If the drag object
of the drop was a Q3IconDrag, \a lst contains the list of the
dropped items. You can get the data by calling
Q3IconDragItem::data() on each item. If the \a lst is empty, i.e.
the drag was not a Q3IconDrag, you must decode the data in \a e and
work with that.
The default implementation does nothing; subclasses may
reimplement this function.
*/
void Q3IconViewItem::dropped(QDropEvent *, const Q3ValueList<Q3IconDragItem> &)
{
}
#endif
/*!
This function is called when a drag enters the item's bounding
rectangle.
The default implementation does nothing; subclasses may
reimplement this function.
*/
void Q3IconViewItem::dragEntered()
{
}
/*!
This function is called when a drag leaves the item's bounding
rectangle.
The default implementation does nothing; subclasses may
reimplement this function.
*/
void Q3IconViewItem::dragLeft()
{
}
/*!
Sets the bounding rectangle of the whole item to \a r. This
function is provided for subclasses which reimplement calcRect(),
so that they can set the calculated rectangle. \e{Any other use is
discouraged.}
\sa calcRect() textRect() setTextRect() pixmapRect() setPixmapRect()
*/
void Q3IconViewItem::setItemRect(const QRect &r)
{
itemRect = r;
checkRect();
if (view)
view->updateItemContainer(this);
}
/*!
Sets the bounding rectangle of the item's text to \a r. This
function is provided for subclasses which reimplement calcRect(),
so that they can set the calculated rectangle. \e{Any other use is
discouraged.}
\sa calcRect() textRect() setItemRect() setPixmapRect()
*/
void Q3IconViewItem::setTextRect(const QRect &r)
{
itemTextRect = r;
if (view)
view->updateItemContainer(this);
}
/*!
Sets the bounding rectangle of the item's icon to \a r. This
function is provided for subclasses which reimplement calcRect(),
so that they can set the calculated rectangle. \e{Any other use is
discouraged.}
\sa calcRect() pixmapRect() setItemRect() setTextRect()
*/
void Q3IconViewItem::setPixmapRect(const QRect &r)
{
itemIconRect = r;
if (view)
view->updateItemContainer(this);
}
/*!
\internal
*/
void Q3IconViewItem::calcTmpText()
{
if (!view || view->d->wordWrapIconText || !wordWrapDirty)
return;
wordWrapDirty = false;
int w = iconView()->maxItemWidth() - (iconView()->itemTextPos() == Q3IconView::Bottom ? 0 :
pixmapRect().width());
if (view->d->fm->width(itemText) < w) {
tmpText = itemText;
return;
}
tmpText = QLatin1String("...");
int i = 0;
while (view->d->fm->width(tmpText + itemText[i]) < w)
tmpText += itemText[i++];
tmpText.remove((uint)0, 3);
tmpText += QLatin1String("...");
}
/*! \internal */
QString Q3IconViewItem::tempText() const
{
return tmpText;
}
void Q3IconViewItem::checkRect()
{
int x = itemRect.x();
int y = itemRect.y();
int w = itemRect.width();
int h = itemRect.height();
bool changed = false;
if (x < 0) {
x = 0;
changed = true;
}
if (y < 0) {
y = 0;
changed = true;
}
if (changed)
itemRect.setRect(x, y, w, h);
}
/*!
\class Q3IconView
\brief The Q3IconView class provides an area with movable labelled icons.
\compat
A Q3IconView can display and manage a grid or other 2D layout of
labelled icons. Each labelled icon is a Q3IconViewItem. Items
(Q3IconViewItems) can be added or deleted at any time; items can be
moved within the Q3IconView. Single or multiple items can be
selected. Items can be renamed in-place. Q3IconView also supports
\link #draganddrop drag and drop\endlink.
Each item contains a label string, a pixmap or picture (the icon
itself) and optionally a sort key. The sort key is used for
sorting the items and defaults to the label string. The label
string can be displayed below or to the right of the icon (see \l
ItemTextPos).
The simplest way to create a Q3IconView is to create a Q3IconView
object and create some Q3IconViewItems with the Q3IconView as their
parent, set the icon view's geometry and show it.
For example:
\snippet doc/src/snippets/code/src_qt3support_itemviews_q3iconview.cpp 4
The Q3IconViewItem call passes a pointer to the Q3IconView we wish to
populate, along with the label text and a QPixmap.
When an item is inserted the Q3IconView allocates a position for it.
Existing items are rearranged if autoArrange() is true. The
default arrangement is \l LeftToRight -- the Q3IconView fills up
the \e left-most column from top to bottom, then moves one column
\e right and fills that from top to bottom and so on. The
arrangement can be modified with any of the following approaches:
\list
\i Call setArrangement(), e.g. with \l TopToBottom which will fill
the \e top-most row from left to right, then moves one row \e down
and fills that row from left to right and so on.
\i Construct each Q3IconViewItem using a constructor which allows
you to specify which item the new one is to follow.
\i Call setSorting() or sort() to sort the items.
\endlist
The spacing between items is set with setSpacing(). Items can be
laid out using a fixed grid using setGridX() and setGridY(); by
default the Q3IconView calculates a grid dynamically. The position
of items' label text is set with setItemTextPos(). The text's
background can be set with setItemTextBackground(). The maximum
width of an item and of its text are set with setMaxItemWidth()
and setMaxItemTextLength(). The label text will be word-wrapped if
it is too long; this is controlled by setWordWrapIconText(). If
the label text is truncated, the user can still see the entire
text in a tool tip if they hover the mouse over the item. This is
controlled with setShowToolTips().
Items which are \link Q3IconViewItem::isSelectable()
selectable\endlink may be selected depending on the SelectionMode;
the default is \l Single. Because Q3IconView offers multiple
selection it must display keyboard focus and selection state
separately. Therefore there are functions to set the selection
state of an item (setSelected()) and to select which item displays
keyboard focus (setCurrentItem()). When multiple items may be
selected the icon view provides a rubberband, too.
When in-place renaming is enabled (it is disabled by default), the
user may change the item's label. They do this by selecting the item
(single clicking it or navigating to it with the arrow keys), then
single clicking it (or pressing F2), and entering their text. If no
key has been set with Q3IconViewItem::setKey() the new text will also
serve as the key. (See Q3IconViewItem::setRenameEnabled().)
You can control whether users can move items themselves with
setItemsMovable().
Because the internal structure used to store the icon view items is
linear, no iterator class is needed to iterate over all the items.
Instead we iterate by getting the first item from the \e{icon view}
and then each subsequent (\l Q3IconViewItem::nextItem()) from each
\e item in turn:
\snippet doc/src/snippets/code/src_qt3support_itemviews_q3iconview.cpp 5
Q3IconView also provides currentItem(). You can search for an item
using findItem() (searching by position or for label text) and
with findFirstVisibleItem() and findLastVisibleItem(). The number
of items is returned by count(). An item can be removed from an
icon view using takeItem(); to delete an item use \c delete. All
the items can be deleted with clear().
The Q3IconView emits a wide range of useful signals, including
selectionChanged(), currentChanged(), clicked(), moved() and
itemRenamed().
\target draganddrop
\section1 Drag and Drop
Q3IconView supports the drag and drop of items within the Q3IconView
itself. It also supports the drag and drop of items out of or into
the Q3IconView and drag and drop onto items themselves. The drag and
drop of items outside the Q3IconView can be achieved in a simple way
with basic functionality, or in a more sophisticated way which
provides more power and control.
The simple approach to dragging items out of the icon view is to
subclass Q3IconView and reimplement Q3IconView::dragObject().
\snippet doc/src/snippets/code/src_qt3support_itemviews_q3iconview.cpp 6
In this example we create a Q3TextDrag object, (derived from
Q3DragObject), containing the item's label and return it as the drag
object. We could just as easily have created a Q3ImageDrag from the
item's pixmap and returned that instead.
Q3IconViews and their Q3IconViewItems can also be the targets of drag
and drops. To make the Q3IconView itself able to accept drops connect
to the dropped() signal. When a drop occurs this signal will be
emitted with a QDragEvent and a QLinkedList of Q3IconDragItems. To
make a Q3IconViewItem into a drop target subclass Q3IconViewItem and
reimplement Q3IconViewItem::acceptDrop() and
Q3IconViewItem::dropped().
\snippet doc/src/snippets/code/src_qt3support_itemviews_q3iconview.cpp 7
If you want to use extended drag-and-drop or have drag shapes drawn
you must take a more sophisticated approach.
The first part is starting drags -- you should use a Q3IconDrag (or a
class derived from it) for the drag object. In dragObject() create the
drag object, populate it with Q3IconDragItems and return it. Normally
such a drag should offer each selected item's data. So in dragObject()
you should iterate over all the items, and create a Q3IconDragItem for
each selected item, and append these items with Q3IconDrag::append() to
the Q3IconDrag object. You can use Q3IconDragItem::setData() to set the
data of each item that should be dragged. If you want to offer the
data in additional mime-types, it's best to use a class derived from
Q3IconDrag, which implements additional encoding and decoding
functions.
When a drag enters the icon view, there is little to do. Simply
connect to the dropped() signal and reimplement
Q3IconViewItem::acceptDrop() and Q3IconViewItem::dropped(). If you've
used a Q3IconDrag (or a subclass of it) the second argument to the
dropped signal contains a QLinkedList of Q3IconDragItems -- you can
access their data by calling Q3IconDragItem::data() on each one.
For an example implementation of complex drag-and-drop look at the
fileiconview example (qt/examples/fileiconview).
\sa Q3IconViewItem::setDragEnabled(), Q3IconViewItem::setDropEnabled(),
Q3IconViewItem::acceptDrop(), Q3IconViewItem::dropped()
*/
/*! \enum Q3IconView::ResizeMode
This enum type is used to tell Q3IconView how it should treat the
positions of its icons when the widget is resized. The modes are:
\value Fixed The icons' positions are not changed.
\value Adjust The icons' positions are adjusted to be within the
new geometry, if possible.
*/
/*!
\enum Q3IconView::SelectionMode
This enumerated type is used by Q3IconView to indicate how it
reacts to selection by the user. It has four values:
\value Single When the user selects an item, any already-selected
item becomes unselected and the user cannot unselect the selected
item. This means that the user can never clear the selection. (The
application programmer can, using Q3IconView::clearSelection().)
\value Multi When the user selects an item, e.g. by navigating to
it with the keyboard arrow keys or by clicking it, the selection
status of that item is toggled and the other items are left alone.
\value Extended When the user selects an item the selection is
cleared and the new item selected. However, if the user presses
the Ctrl key when clicking on an item, the clicked item gets
toggled and all other items are left untouched. If the user
presses the Shift key while clicking on an item, all items between
the current item and the clicked item get selected or unselected,
depending on the state of the clicked item. Also, multiple items
can be selected by dragging the mouse while the left mouse button
stays pressed.
\value NoSelection Items cannot be selected.
To summarize: \c Single is a real single-selection icon view; \c
Multi a real multi-selection icon view; \c Extended is an icon
view in which users can select multiple items but usually want to
select either just one or a range of contiguous items; and \c
NoSelection mode is for an icon view where the user can look but
not touch.
*/
/*!
\enum Q3IconView::Arrangement
This enum type determines in which direction the items flow when
the view runs out of space.
\value LeftToRight Items which don't fit into the view go further
down (you get a vertical scroll bar)
\value TopToBottom Items which don't fit into the view go further
right (you get a horizontal scroll bar)
*/
/*!
\enum Q3IconView::ItemTextPos
This enum type specifies the position of the item text in relation
to the icon.
\value Bottom The text is drawn below the icon.
\value Right The text is drawn to the right of the icon.
*/
/*!
\fn void Q3IconView::dropped(QDropEvent *e, const Q3ValueList<Q3IconDragItem> &lst)
This signal is emitted when a drop event occurs in the viewport
(but not on any icon) which the icon view itself can't handle.
\a e provides all the information about the drop. If the drag
object of the drop was a Q3IconDrag, \a lst contains the list of
the dropped items. You can get the data using
Q3IconDragItem::data() on each item. If the \a lst is empty, i.e.
the drag was not a Q3IconDrag, you have to decode the data in \a e
and work with that.
Note Q3IconViewItems may be drop targets; if a drop event occurs on
an item the item handles the drop.
*/
/*!
\fn void Q3IconView::moved()
This signal is emitted after successfully dropping one (or more)
items of the icon view. If the items should be removed, it's best
to do so in a slot connected to this signal.
*/
/*!
\fn void Q3IconView::doubleClicked(Q3IconViewItem * item)
This signal is emitted when the user double-clicks on \a item.
*/
/*!
\fn void Q3IconView::returnPressed (Q3IconViewItem * item)
This signal is emitted if the user presses the Return or Enter
key. \a item is the currentItem() at the time of the keypress.
*/
/*!
\fn void Q3IconView::selectionChanged()
This signal is emitted when the selection has been changed. It's
emitted in each selection mode.
*/
/*!
\fn void Q3IconView::selectionChanged(Q3IconViewItem *item)
\overload
This signal is emitted when the selection changes. \a item is the
newly selected item. This signal is emitted only in single
selection mode.
*/
/*!
\fn void Q3IconView::currentChanged(Q3IconViewItem *item)
This signal is emitted when a new item becomes current. \a item is
the new current item (or 0 if no item is now current).
\sa currentItem()
*/
/*!
\fn void Q3IconView::onItem(Q3IconViewItem *item)
This signal is emitted when the user moves the mouse cursor onto
an \a item, similar to the QWidget::enterEvent() function.
*/
// ### bug here - enter/leave event aren't considered. move the mouse
// out of the window and back in, to the same item.
/*!
\fn void Q3IconView::onViewport()
This signal is emitted when the user moves the mouse cursor from
an item to an empty part of the icon view.
\sa onItem()
*/
/*!
\fn void Q3IconView::itemRenamed (Q3IconViewItem * item)
\overload
This signal is emitted when \a item has been renamed, usually by
in-place renaming.
\sa Q3IconViewItem::setRenameEnabled() Q3IconViewItem::rename()
*/
/*!
\fn void Q3IconView::itemRenamed (Q3IconViewItem * item, const QString &name)
This signal is emitted when \a item has been renamed to \a name,
usually by in-place renaming.
\sa Q3IconViewItem::setRenameEnabled() Q3IconViewItem::rename()
*/
/*!
\fn void Q3IconView::rightButtonClicked (Q3IconViewItem * item, const QPoint & pos)
This signal is emitted when the user clicks the right mouse
button. If \a item is non-null, the cursor is on \a item. If \a
item is null, the mouse cursor isn't on any item.
\a pos is the position of the mouse cursor in the global
coordinate system (QMouseEvent::globalPos()). (If the click's
press and release differ by a pixel or two, \a pos is the
position at release time.)
\sa rightButtonPressed() mouseButtonClicked() clicked()
*/
/*!
\fn void Q3IconView::contextMenuRequested(Q3IconViewItem *item, const QPoint & pos)
This signal is emitted when the user invokes a context menu with
the right mouse button or with special system keys, with \a item
being the item under the mouse cursor or the current item,
respectively.
\a pos is the position for the context menu in the global
coordinate system.
*/
/*!
\fn void Q3IconView::mouseButtonPressed(int button, Q3IconViewItem *item, const QPoint &pos)
This signal is emitted when the user presses mouse button \a
button. If \a item is non-null, the cursor is on \a item. If \a
item is null, the mouse cursor isn't on any item.
\a pos is the position of the mouse cursor in the global
coordinate system (QMouseEvent::globalPos()).
\sa rightButtonClicked() mouseButtonClicked() pressed()
*/
/*!
\fn void Q3IconView::mouseButtonClicked (int button, Q3IconViewItem * item, const QPoint & pos)
This signal is emitted when the user clicks mouse button \a
button. If \a item is non-null, the cursor is on \a item. If \a
item is null, the mouse cursor isn't on any item.
\a pos is the position of the mouse cursor in the global
coordinate system (QMouseEvent::globalPos()). (If the click's
press and release differ by a pixel or two, \a pos is the
position at release time.)
\sa mouseButtonPressed() rightButtonClicked() clicked()
*/
/*!
\fn void Q3IconView::clicked (Q3IconViewItem * item, const QPoint & pos)
\overload
This signal is emitted when the user clicks any mouse button on an
icon view item. \a item is a pointer to the item that has been
clicked.
\a pos is the position of the mouse cursor in the global coordinate
system (QMouseEvent::globalPos()). (If the click's press and release
differ by a pixel or two, \a pos is the position at release time.)
\sa mouseButtonClicked() rightButtonClicked() pressed()
*/
/*!
\fn void Q3IconView::pressed (Q3IconViewItem * item, const QPoint & pos)
\overload
This signal is emitted when the user presses any mouse button. If
\a item is non-null, the cursor is on \a item. If \a item is null,
the mouse cursor isn't on any item.
\a pos is the position of the mouse cursor in the global
coordinate system (QMouseEvent::globalPos()). (If the click's
press and release differ by a pixel or two, \a pos is the
position at release time.)
\sa mouseButtonPressed() rightButtonPressed() clicked()
*/
/*!
\fn void Q3IconView::clicked (Q3IconViewItem * item)
This signal is emitted when the user clicks any mouse button. If
\a item is non-null, the cursor is on \a item. If \a item is null,
the mouse cursor isn't on any item.
\sa mouseButtonClicked() rightButtonClicked() pressed()
*/
/*!
\fn void Q3IconView::pressed (Q3IconViewItem * item)
This signal is emitted when the user presses any mouse button. If
\a item is non-null, the cursor is on \a item. If \a item is null,
the mouse cursor isn't on any item.
\sa mouseButtonPressed() rightButtonPressed() clicked()
*/
/*!
\fn void Q3IconView::rightButtonPressed(Q3IconViewItem * item, const QPoint & pos)
This signal is emitted when the user presses the right mouse
button. If \a item is non-null, the cursor is on \a item. If \a
item is null, the mouse cursor isn't on any item.
\a pos is the position of the mouse cursor in the global
coordinate system (QMouseEvent::globalPos()).
*/
/*!
Constructs an empty icon view called \a name, with parent \a
parent and using the widget flags \a f.
*/
Q3IconView::Q3IconView(QWidget *parent, const char *name, Qt::WindowFlags f)
: Q3ScrollView(parent, name, Qt::WStaticContents | Qt::WNoAutoErase | f)
{
if (!unknown_icon) {
unknown_icon = new QPixmap((const char **)unknown_xpm);
qiv_pixmaps()->append(unknown_icon);
}
d = new Q3IconViewPrivate;
d->dragging = false;
d->firstItem = 0;
d->lastItem = 0;
d->count = 0;
d->mousePressed = false;
d->selectionMode = Single;
d->currentItem = 0;
d->highlightedItem = 0;
d->rubber = 0;
d->scrollTimer = 0;
d->startDragItem = 0;
d->tmpCurrentItem = 0;
d->rastX = d->rastY = -1;
d->spacing = 5;
d->cleared = false;
d->arrangement = LeftToRight;
d->resizeMode = Fixed;
d->dropped = false;
d->adjustTimer = new QTimer(this, "iconview adjust timer");
d->isIconDrag = false;
d->inMenuMode = false;
#ifndef QT_NO_DRAGANDDROP
d->iconDragData.clear();
#endif
d->numDragItems = 0;
d->updateTimer = new QTimer(this, "iconview update timer");
d->cachedW = d->cachedH = 0;
d->maxItemWidth = 100;
d->maxItemTextLength = 255;
d->inputTimer = new QTimer(this, "iconview input timer");
d->currInputString.clear();
d->dirty = false;
d->rearrangeEnabled = true;
d->itemTextPos = Bottom;
d->reorderItemsWhenInsert = true;
#ifndef QT_NO_CURSOR
d->oldCursor = Qt::ArrowCursor;
#endif
d->resortItemsWhenInsert = false;
d->sortDirection = true;
d->wordWrapIconText = true;
d->cachedContentsX = d->cachedContentsY = -1;
d->clearing = false;
d->fullRedrawTimer = new QTimer(this, "iconview full redraw timer");
d->itemTextBrush = Qt::NoBrush;
d->drawAllBack = true;
d->fm = new QFontMetrics(font());
d->minLeftBearing = d->fm->minLeftBearing();
d->minRightBearing = d->fm->minRightBearing();
d->firstContainer = d->lastContainer = 0;
d->containerUpdateLocked = false;
d->firstSizeHint = false;
d->selectAnchor = 0;
d->renamingItem = 0;
d->drawActiveSelection = true;
d->drawDragShapes = false;
connect(d->adjustTimer, SIGNAL(timeout()),
this, SLOT(adjustItems()));
connect(d->updateTimer, SIGNAL(timeout()),
this, SLOT(slotUpdate()));
connect(d->fullRedrawTimer, SIGNAL(timeout()),
this, SLOT(updateContents()));
connect(this, SIGNAL(contentsMoving(int,int)),
this, SLOT(movedContents(int,int)));
setAcceptDrops(true);
viewport()->setAcceptDrops(true);
setMouseTracking(true);
viewport()->setMouseTracking(true);
viewport()->setBackgroundRole(QPalette::Base);
viewport()->setFocusProxy(this);
viewport()->setFocusPolicy(Qt::WheelFocus);
setFocusPolicy(Qt::WheelFocus);
d->showTips = true;
}
/*!
\reimp
*/
void Q3IconView::changeEvent(QEvent *ev)
{
if(ev->type() == QEvent::StyleChange) {
*d->fm = QFontMetrics(font());
d->minLeftBearing = d->fm->minLeftBearing();
d->minRightBearing = d->fm->minRightBearing();
Q3IconViewItem *item = d->firstItem;
for (; item; item = item->next) {
item->wordWrapDirty = true;
item->calcRect();
}
#if !defined(Q_WS_X11)
delete qiv_selection;
qiv_selection = 0;
#endif
} else if(ev->type() == QEvent::ActivationChange) {
if (!isActiveWindow() && d->scrollTimer)
d->scrollTimer->stop();
if(isVisible() && !palette().isEqual(QPalette::Active, QPalette::Inactive))
repaintSelectedItems();
}
Q3ScrollView::changeEvent(ev);
if (ev->type() == QEvent::ApplicationFontChange || ev->type() == QEvent::FontChange) {
*d->fm = QFontMetrics(font());
d->minLeftBearing = d->fm->minLeftBearing();
d->minRightBearing = d->fm->minRightBearing();
Q3IconViewItem *item = d->firstItem;
for (; item; item = item->next) {
item->wordWrapDirty = true;
item->calcRect();
}
}
}
/*!
Destroys the icon view and deletes all items.
*/
Q3IconView::~Q3IconView()
{
Q3IconViewItem *tmp, *item = d->firstItem;
d->clearing = true;
Q3IconViewPrivate::ItemContainer *c = d->firstContainer, *tmpc;
while (c) {
tmpc = c->n;
delete c;
c = tmpc;
}
while (item) {
tmp = item->next;
delete item;
item = tmp;
}
delete d->fm;
d->fm = 0;
delete d;
}
/*!
Inserts the icon view item \a item after \a after. If \a after is
0, \a item is appended after the last item.
\e{You should never need to call this function.} Instead create
Q3IconViewItem's and associate them with your icon view like this:
\snippet doc/src/snippets/code/src_qt3support_itemviews_q3iconview.cpp 8
*/
void Q3IconView::insertItem(Q3IconViewItem *item, Q3IconViewItem *after)
{
if (!item)
return;
if (d->firstItem == item || item->prev || item->next)
return;
if (!item->view)
item->view = this;
if (!d->firstItem) {
d->firstItem = d->lastItem = item;
item->prev = 0;
item->next = 0;
} else {
if (!after || after == d->lastItem) {
d->lastItem->next = item;
item->prev = d->lastItem;
item->next = 0;
d->lastItem = item;
} else {
Q3IconViewItem *i = d->firstItem;
while (i != after)
i = i->next;
if (i) {
Q3IconViewItem *next = i->next;
item->next = next;
item->prev = i;
i->next = item;
next->prev = item;
}
}
}
if (isVisible()) {
if (d->reorderItemsWhenInsert) {
if (d->updateTimer->isActive())
d->updateTimer->stop();
d->fullRedrawTimer->stop();
// #### uncomment this ASA insertInGrid uses cached values and is efficient
//insertInGrid(item);
d->cachedW = qMax(d->cachedW, item->x() + item->width());
d->cachedH= qMax(d->cachedH, item->y() + item->height());
d->updateTimer->start(0, true);
} else {
insertInGrid(item);
viewport()->update(item->x() - contentsX(),
item->y() - contentsY(),
item->width(), item->height());
}
} else if (!autoArrange()) {
item->dirty = false;
}
d->count++;
d->dirty = true;
}
/*!
This slot is used for a slightly-delayed update.
The icon view is not redrawn immediately after inserting a new item
but after a very small delay using a QTimer. This means that when
many items are inserted in a loop the icon view is probably redrawn
only once at the end of the loop. This makes the insertions both
flicker-free and faster.
*/
void Q3IconView::slotUpdate()
{
d->updateTimer->stop();
d->fullRedrawTimer->stop();
if (!d->firstItem || !d->lastItem)
return;
// #### remove that ASA insertInGrid uses cached values and is efficient
if (d->resortItemsWhenInsert)
sort(d->sortDirection);
else {
int y = d->spacing;
Q3IconViewItem *item = d->firstItem;
int w = 0, h = 0;
while (item) {
bool changed;
Q3IconViewItem *next = makeRowLayout(item, y, changed);
if (!next || !next->next)
break;
if(!QApplication::reverseLayout())
item = next;
w = qMax(w, item->x() + item->width());
h = qMax(h, item->y() + item->height());
item = next;
if (d->arrangement == LeftToRight)
h = qMax(h, y);
item = item->next;
}
if (d->lastItem && d->arrangement == TopToBottom) {
item = d->lastItem;
int x = item->x();
while (item && item->x() >= x) {
w = qMax(w, item->x() + item->width());
h = qMax(h, item->y() + item->height());
item = item->prev;
}
}
w = qMax(qMax(d->cachedW, w), d->lastItem->x() + d->lastItem->width());
h = qMax(qMax(d->cachedH, h), d->lastItem->y() + d->lastItem->height());
if (d->arrangement == TopToBottom)
w += d->spacing;
else
h += d->spacing;
viewport()->setUpdatesEnabled(false);
resizeContents(w, h);
viewport()->setUpdatesEnabled(true);
viewport()->repaint();
}
int cx = d->cachedContentsX == -1 ? contentsX() : d->cachedContentsX;
int cy = d->cachedContentsY == -1 ? contentsY() : d->cachedContentsY;
if (cx != contentsX() || cy != contentsY())
setContentsPos(cx, cy);
d->cachedContentsX = d->cachedContentsY = -1;
d->cachedW = d->cachedH = 0;
}
/*!
Takes the icon view item \a item out of the icon view and causes
an update of the screen display. The item is not deleted. You
should normally not need to call this function because
Q3IconViewItem::~Q3IconViewItem() calls it. The normal way to delete
an item is to delete it.
*/
void Q3IconView::takeItem(Q3IconViewItem *item)
{
if (!item)
return;
if (item->d->container1)
item->d->container1->items.removeAll(item);
if (item->d->container2)
item->d->container2->items.removeAll(item);
item->d->container2 = 0;
item->d->container1 = 0;
bool block = signalsBlocked();
blockSignals(d->clearing);
QRect r = item->rect();
if (d->currentItem == item) {
if (item->prev) {
d->currentItem = item->prev;
emit currentChanged(d->currentItem);
repaintItem(d->currentItem);
} else if (item->next) {
d->currentItem = item->next;
emit currentChanged(d->currentItem);
repaintItem(d->currentItem);
} else {
d->currentItem = 0;
emit currentChanged(d->currentItem);
}
}
if (item->isSelected()) {
item->selected = false;
emit selectionChanged();
}
if (item == d->firstItem) {
d->firstItem = d->firstItem->next;
if (d->firstItem)
d->firstItem->prev = 0;
} else if (item == d->lastItem) {
d->lastItem = d->lastItem->prev;
if (d->lastItem)
d->lastItem->next = 0;
} else {
Q3IconViewItem *i = item;
if (i) {
if (i->prev)
i->prev->next = i->next;
if (i->next)
i->next->prev = i->prev;
}
}
if (d->selectAnchor == item)
d->selectAnchor = d->currentItem;
if (!d->clearing)
repaintContents(r.x(), r.y(), r.width(), r.height());
item->view = 0;
item->prev = 0;
item->next = 0;
d->count--;
blockSignals(block);
}
/*!
Returns the index of \a item, or -1 if \a item doesn't exist in
this icon view.
*/
int Q3IconView::index(const Q3IconViewItem *item) const
{
if (!item)
return -1;
if (item == d->firstItem)
return 0;
else if (item == d->lastItem)
return d->count - 1;
else {
Q3IconViewItem *i = d->firstItem;
int j = 0;
while (i && i != item) {
i = i->next;
++j;
}
return i ? j : -1;
}
}
/*!
Returns a pointer to the first item of the icon view, or 0 if
there are no items in the icon view.
\sa lastItem() currentItem()
*/
Q3IconViewItem *Q3IconView::firstItem() const
{
return d->firstItem;
}
/*!
Returns a pointer to the last item of the icon view, or 0 if there
are no items in the icon view.
\sa firstItem() currentItem()
*/
Q3IconViewItem *Q3IconView::lastItem() const
{
return d->lastItem;
}
/*!
Returns a pointer to the current item of the icon view, or 0 if no
item is current.
\sa setCurrentItem() firstItem() lastItem()
*/
Q3IconViewItem *Q3IconView::currentItem() const
{
return d->currentItem;
}
/*!
\reimp
*/
QVariant Q3IconView::inputMethodQuery(Qt::InputMethodQuery query) const
{
if (query == Qt::ImMicroFocus) {
return d->currentItem ? d->currentItem->rect() : QRect();
}
return QWidget::inputMethodQuery(query);
}
/*!
Makes \a item the new current item of the icon view.
*/
void Q3IconView::setCurrentItem(Q3IconViewItem *item)
{
if (!item || item == d->currentItem)
return;
Q3IconViewItem *old = d->currentItem;
d->currentItem = item;
emit currentChanged(d->currentItem);
if (d->selectionMode == Single) {
bool changed = false;
if (old && old->selected) {
old->selected = false;
changed = true;
}
if (item && !item->selected && item->isSelectable() && d->selectionMode != NoSelection) {
item->selected = true;
changed = true;
emit selectionChanged(item);
}
if (changed)
emit selectionChanged();
}
if (old)
repaintItem(old);
repaintItem(d->currentItem);
}
/*!
Selects or unselects \a item depending on \a s, and may also
unselect other items, depending on Q3IconView::selectionMode() and
\a cb.
If \a s is false, \a item is unselected.
If \a s is true and Q3IconView::selectionMode() is \l Single, \a
item is selected, and the item which was selected is unselected.
If \a s is true and Q3IconView::selectionMode() is \l Extended, \a
item is selected. If \a cb is true, the selection state of the
icon view's other items is left unchanged. If \a cb is false (the
default) all other items are unselected.
If \a s is true and Q3IconView::selectionMode() is \l Multi \a item
is selected.
Note that \a cb is used only if Q3IconView::selectionMode() is \l
Extended. \a cb defaults to false.
All items whose selection status is changed repaint themselves.
*/
void Q3IconView::setSelected(Q3IconViewItem *item, bool s, bool cb)
{
if (!item)
return;
item->setSelected(s, cb);
}
/*!
\property Q3IconView::count
\brief the number of items in the icon view
*/
uint Q3IconView::count() const
{
return d->count;
}
/*!
Performs autoscrolling when selecting multiple icons with the
rubber band.
*/
void Q3IconView::doAutoScroll()
{
QRect oldRubber = QRect(*d->rubber);
QPoint vp = viewport()->mapFromGlobal(QCursor::pos());
QPoint pos = viewportToContents(vp);
if (pos == d->rubber->bottomRight())
return;
d->rubber->setRight(pos.x());
d->rubber->setBottom(pos.y());
int minx = contentsWidth(), miny = contentsHeight();
int maxx = 0, maxy = 0;
bool changed = false;
bool block = signalsBlocked();
QRect rr;
QRegion region(0, 0, visibleWidth(), visibleHeight());
blockSignals(true);
viewport()->setUpdatesEnabled(false);
bool alreadyIntersected = false;
QRect nr = d->rubber->normalized();
QRect rubberUnion = nr.united(oldRubber.normalized());
Q3IconViewPrivate::ItemContainer *c = d->firstContainer;
for (; c; c = c->n) {
if (c->rect.intersects(rubberUnion)) {
alreadyIntersected = true;
for (int i = 0; i < c->items.size(); ++i) {
Q3IconViewItem *item = c->items.at(i);
if (d->selectedItems.contains(item))
continue;
if (!item->intersects(nr)) {
if (item->isSelected()) {
item->setSelected(false);
changed = true;
rr = rr.united(item->rect());
}
} else if (item->intersects(nr)) {
if (!item->isSelected() && item->isSelectable()) {
item->setSelected(true, true);
changed = true;
rr = rr.united(item->rect());
} else {
region = region.subtracted(QRect(contentsToViewport(item->pos()),
item->size()));
}
minx = qMin(minx, item->x() - 1);
miny = qMin(miny, item->y() - 1);
maxx = qMax(maxx, item->x() + item->width() + 1);
maxy = qMax(maxy, item->y() + item->height() + 1);
}
}
} else {
if (alreadyIntersected)
break;
}
}
viewport()->setUpdatesEnabled(true);
blockSignals(block);
QRect r = *d->rubber;
*d->rubber = oldRubber;
d->dragging = false;
*d->rubber = r;
if (changed) {
d->drawAllBack = false;
d->clipRegion = region;
repaintContents(rr);
d->drawAllBack = true;
}
ensureVisible(pos.x(), pos.y());
d->dragging = true;
if (changed) {
emit selectionChanged();
if (d->selectionMode == Single)
emit selectionChanged(d->currentItem);
}
if (!QRect(50, 50, viewport()->width()-100, viewport()->height()-100).contains(vp) &&
!d->scrollTimer) {
d->scrollTimer = new QTimer(this);
connect(d->scrollTimer, SIGNAL(timeout()),
this, SLOT(doAutoScroll()));
d->scrollTimer->start(100, false);
} else if (QRect(50, 50, viewport()->width()-100, viewport()->height()-100).contains(vp) &&
d->scrollTimer) {
disconnect(d->scrollTimer, SIGNAL(timeout()),
this, SLOT(doAutoScroll()));
d->scrollTimer->stop();
delete d->scrollTimer;
d->scrollTimer = 0;
}
}
/*!
\reimp
*/
void Q3IconView::drawContents(QPainter *p, int cx, int cy, int cw, int ch)
{
if (d->dragging && d->rubber)
drawRubber(p);
QRect r = QRect(cx, cy, cw, ch);
Q3IconViewPrivate::ItemContainer *c = d->firstContainer;
QRegion remaining(QRect(cx, cy, cw, ch));
bool alreadyIntersected = false;
while (c) {
if (c->rect.intersects(r)) {
p->save();
p->resetXForm();
QRect r2 = c->rect;
r2 = r2.intersected(r);
QRect r3(contentsToViewport(QPoint(r2.x(), r2.y())), QSize(r2.width(), r2.height()));
if (d->drawAllBack) {
p->setClipRect(r3);
} else {
QRegion reg = d->clipRegion.intersected(r3);
p->setClipRegion(reg);
}
drawBackground(p, r3);
remaining = remaining.subtracted(r3);
p->restore();
QPalette pal = palette();
d->drawActiveSelection = hasFocus() || d->inMenuMode
|| !style()->styleHint(QStyle::SH_ItemView_ChangeHighlightOnFocus, 0, this);
if (!d->drawActiveSelection)
pal.setCurrentColorGroup(QPalette::Inactive);
// clip items to the container rect by default... this
// prevents icons with alpha channels from being painted
// twice when they are in 2 containers
//
// NOTE: the item could override this cliprect in its
// paintItem() implementation, which makes this useless
p->setClipRect(r2);
for (int i = 0; i < c->items.size(); ++i) {
Q3IconViewItem *item = c->items.at(i);
if (item->rect().intersects(r) && !item->dirty) {
p->save();
p->setFont(font());
item->paintItem(p, pal);
p->restore();
}
}
alreadyIntersected = true;
} else {
if (alreadyIntersected)
break;
}
c = c->n;
}
if (!remaining.isEmpty()) {
p->save();
p->resetXForm();
if (d->drawAllBack) {
p->setClipRegion(remaining);
} else {
remaining = d->clipRegion.intersected(remaining);
p->setClipRegion(remaining);
}
drawBackground(p, remaining.boundingRect());
p->restore();
}
if ((hasFocus() || viewport()->hasFocus()) && d->currentItem &&
d->currentItem->rect().intersects(r)) {
d->currentItem->paintFocus(p, palette());
}
if (d->dragging && d->rubber)
drawRubber(p);
}
/*!
\overload
Arranges all the items in the grid specified by gridX() and gridY().
Even if sorting() is enabled, the items are not sorted by this
function. If you want to sort or rearrange the items, use
iconview->sort(iconview->sortDirection()).
If \a update is true (the default), the viewport is repainted as
well.
\sa Q3IconView::setGridX(), Q3IconView::setGridY(), Q3IconView::sort()
*/
void Q3IconView::arrangeItemsInGrid(bool update)
{
if (!d->firstItem || !d->lastItem)
return;
d->containerUpdateLocked = true;
int w = 0, h = 0, y = d->spacing;
Q3IconViewItem *item = d->firstItem;
bool changedLayout = false;
while (item) {
bool changed;
Q3IconViewItem *next = makeRowLayout(item, y, changed);
changedLayout = changed || changedLayout;
if(!QApplication::reverseLayout())
item = next;
w = qMax(w, item->x() + item->width());
h = qMax(h, item->y() + item->height());
item = next;
if (d->arrangement == LeftToRight)
h = qMax(h, y);
if (!item || !item->next)
break;
item = item->next;
}
if (d->lastItem && d->arrangement == TopToBottom) {
item = d->lastItem;
int x = item->x();
while (item && item->x() >= x) {
w = qMax(w, item->x() + item->width());
h = qMax(h, item->y() + item->height());
item = item->prev;
}
}
d->containerUpdateLocked = false;
w = qMax(qMax(d->cachedW, w), d->lastItem->x() + d->lastItem->width());
h = qMax(qMax(d->cachedH, h), d->lastItem->y() + d->lastItem->height());
if (d->arrangement == TopToBottom)
w += d->spacing;
else
h += d->spacing;
bool ue = updatesEnabled();
if (ue)
viewport()->setUpdatesEnabled(false);
int vw = visibleWidth();
int vh = visibleHeight();
resizeContents(w, h);
bool doAgain = false;
if (d->arrangement == LeftToRight)
doAgain = visibleWidth() != vw;
if (d->arrangement == TopToBottom)
doAgain = visibleHeight() != vh;
if (doAgain) // in the case that the visibleExtend changed because of the resizeContents (scroll bar show/hide), redo layout again
arrangeItemsInGrid(false);
if (ue)
viewport()->setUpdatesEnabled(true);
d->dirty = !isVisible();
rebuildContainers();
if (update && (!optimize_layout || changedLayout))
repaintContents(contentsX(), contentsY(), viewport()->width(), viewport()->height());
}
/*!
This variant uses \a grid instead of (gridX(), gridY()). If \a
grid is invalid (see QSize::isValid()), arrangeItemsInGrid()
calculates a valid grid itself and uses that.
If \a update is true (the default) the viewport is repainted.
*/
void Q3IconView::arrangeItemsInGrid(const QSize &grid, bool update)
{
d->containerUpdateLocked = true;
QSize grid_(grid);
if (!grid_.isValid()) {
int w = 0, h = 0;
Q3IconViewItem *item = d->firstItem;
for (; item; item = item->next) {
w = qMax(w, item->width());
h = qMax(h, item->height());
}
grid_ = QSize(qMax(d->rastX + d->spacing, w),
qMax(d->rastY + d->spacing, h));
}
int w = 0, h = 0;
Q3IconViewItem *item = d->firstItem;
for (; item; item = item->next) {
int nx = item->x() / grid_.width();
int ny = item->y() / grid_.height();
item->move(nx * grid_.width(),
ny * grid_.height());
w = qMax(w, item->x() + item->width());
h = qMax(h, item->y() + item->height());
item->dirty = false;
}
d->containerUpdateLocked = false;
resizeContents(w, h);
rebuildContainers();
if (update)
repaintContents(contentsX(), contentsY(), viewport()->width(), viewport()->height());
}
/*!
\reimp
*/
void Q3IconView::setContentsPos(int x, int y)
{
if (d->updateTimer->isActive()) {
d->cachedContentsX = x;
d->cachedContentsY = y;
} else {
d->cachedContentsY = d->cachedContentsX = -1;
Q3ScrollView::setContentsPos(x, y);
}
}
/*!
\reimp
*/
void Q3IconView::showEvent(QShowEvent *)
{
if (d->dirty) {
resizeContents(qMax(contentsWidth(), viewport()->width()),
qMax(contentsHeight(), viewport()->height()));
if (d->resortItemsWhenInsert)
sort(d->sortDirection);
if (autoArrange())
arrangeItemsInGrid(false);
}
Q3ScrollView::show();
}
/*!
\property Q3IconView::selectionMode
\brief the selection mode of the icon view
This can be \l Single (the default), \l Extended, \l Multi or \l
NoSelection.
*/
void Q3IconView::setSelectionMode(SelectionMode m)
{
d->selectionMode = m;
}
Q3IconView::SelectionMode Q3IconView::selectionMode() const
{
return d->selectionMode;
}
/*!
Returns a pointer to the item that contains point \a pos, which is
given in contents coordinates, or 0 if no item contains point \a
pos.
*/
Q3IconViewItem *Q3IconView::findItem(const QPoint &pos) const
{
if (!d->firstItem)
return 0;
Q3IconViewPrivate::ItemContainer *c = d->lastContainer;
for (; c; c = c->p) {
if (c->rect.contains(pos))
for (int i = c->items.size()-1; i >= 0; --i)
if (c->items.at(i)->contains(pos))
return c->items.at(i);
}
return 0;
}
/*!
\overload
Returns a pointer to the first item whose text begins with \a
text, or 0 if no such item could be found. Use the \a compare flag
to control the comparison behavior.
*/
Q3IconViewItem *Q3IconView::findItem(const QString &text, ComparisonFlags compare) const
{
if (!d->firstItem)
return 0;
if (compare == CaseSensitive || compare == 0)
compare |= ExactMatch;
QString itmtxt;
QString comtxt = text;
if (! (compare & CaseSensitive))
comtxt = text.toLower();
Q3IconViewItem *item;
if (d->currentItem)
item = d->currentItem;
else
item = d->firstItem;
Q3IconViewItem *beginsWithItem = 0;
Q3IconViewItem *endsWithItem = 0;
Q3IconViewItem *containsItem = 0;
if (item) {
for (; item; item = item->next) {
if (!(compare & CaseSensitive))
itmtxt = item->text().toLower();
else
itmtxt = item->text();
if ((compare & ExactMatch)==ExactMatch && itmtxt == comtxt)
return item;
if (compare & BeginsWith && !beginsWithItem && itmtxt.startsWith(comtxt))
beginsWithItem = containsItem = item;
if (compare & EndsWith && !endsWithItem && itmtxt.endsWith(comtxt))
endsWithItem = containsItem = item;
if ((compare & ExactMatch)==0 && !containsItem && itmtxt.contains(comtxt))
containsItem = item;
}
if (d->currentItem && d->firstItem) {
item = d->firstItem;
for (; item && item != d->currentItem; item = item->next) {
if (!(compare & CaseSensitive))
itmtxt = item->text().toLower();
else
itmtxt = item->text();
if ((compare & ExactMatch)==ExactMatch && itmtxt == comtxt)
return item;
if (compare & BeginsWith && !beginsWithItem && itmtxt.startsWith(comtxt))
beginsWithItem = containsItem = item;
if (compare & EndsWith && !endsWithItem && itmtxt.endsWith(comtxt))
endsWithItem = containsItem = item;
if ((compare & ExactMatch)==0 && !containsItem && itmtxt.contains(comtxt))
containsItem = item;
}
}
}
// Obey the priorities
if (beginsWithItem)
return beginsWithItem;
else if (endsWithItem)
return endsWithItem;
else if (containsItem)
return containsItem;
return 0;
}
/*!
Unselects all the items.
*/
void Q3IconView::clearSelection()
{
selectAll(false);
}
/*!
In Multi and Extended modes, this function sets all items to be
selected if \a select is true, and to be unselected if \a select
is false.
In Single and NoSelection modes, this function only changes the
selection status of currentItem().
*/
void Q3IconView::selectAll(bool select)
{
if (d->selectionMode == NoSelection)
return;
if (d->selectionMode == Single) {
if (d->currentItem)
d->currentItem->setSelected(select);
return;
}
bool b = signalsBlocked();
blockSignals(true);
Q3IconViewItem *item = d->firstItem;
Q3IconViewItem *i = d->currentItem;
bool changed = false;
bool ue = viewport()->updatesEnabled();
if (ue)
viewport()->setUpdatesEnabled(false);
QRect rr;
for (; item; item = item->next) {
if (select != item->isSelected()) {
item->setSelected(select, true);
rr = rr.united(item->rect());
changed = true;
}
}
if (ue)
viewport()->setUpdatesEnabled(true);
// we call updateContents not repaintContents because of possible previous updateContents
Q3ScrollView::updateContents(rr);
QApplication::sendPostedEvents(viewport(), QEvent::Paint);
if (i)
setCurrentItem(i);
blockSignals(b);
if (changed) {
emit selectionChanged();
}
}
/*!
Inverts the selection. Works only in Multi and Extended selection
mode.
*/
void Q3IconView::invertSelection()
{
if (d->selectionMode == Single ||
d->selectionMode == NoSelection)
return;
bool b = signalsBlocked();
blockSignals(true);
Q3IconViewItem *item = d->firstItem;
for (; item; item = item->next)
item->setSelected(!item->isSelected(), true);
blockSignals(b);
emit selectionChanged();
}
/*!
Repaints the \a item.
*/
void Q3IconView::repaintItem(Q3IconViewItem *item)
{
if (!item || item->dirty)
return;
if (QRect(contentsX(), contentsY(), visibleWidth(), visibleHeight()).
intersects(QRect(item->x() - 1, item->y() - 1, item->width() + 2, item->height() + 2)))
repaintContents(item->x() - 1, item->y() - 1, item->width() + 2, item->height() + 2);
}
/*!
Repaints the selected items.
*/
void Q3IconView::repaintSelectedItems()
{
if (selectionMode() == NoSelection)
return;
if (selectionMode() == Single) {
if (!currentItem() || !currentItem()->isSelected())
return;
QRect itemRect = currentItem()->rect(); //rect in contents coordinates
itemRect.moveBy(-contentsX(), -contentsY());
viewport()->update(itemRect);
} else {
// check if any selected items are visible
Q3IconViewItem *item = firstItem();
const QRect vr = QRect(contentsX(), contentsY(), visibleWidth(), visibleHeight());
while (item) {
if (item->isSelected() && item->rect().intersects(vr))
repaintItem(item);
item = item->nextItem();
}
}
}
/*!
Makes sure that \a item is entirely visible. If necessary,
ensureItemVisible() scrolls the icon view.
\sa ensureVisible()
*/
void Q3IconView::ensureItemVisible(Q3IconViewItem *item)
{
if (!item)
return;
if ((d->updateTimer && d->updateTimer->isActive())
|| (d->fullRedrawTimer && d->fullRedrawTimer->isActive()))
slotUpdate();
int w = item->width();
int h = item->height();
ensureVisible(item->x() + w / 2, item->y() + h / 2,
w / 2 + 1, h / 2 + 1);
}
/*!
Finds the first item whose bounding rectangle overlaps \a r and
returns a pointer to that item. \a r is given in content
coordinates. Returns 0 if no item overlaps \a r.
If you want to find all items that touch \a r, you will need to
use this function and nextItem() in a loop ending at
findLastVisibleItem() and test Q3IconViewItem::rect() for each of
these items.
\sa findLastVisibleItem() Q3IconViewItem::rect()
*/
Q3IconViewItem* Q3IconView::findFirstVisibleItem(const QRect &r) const
{
Q3IconViewPrivate::ItemContainer *c = d->firstContainer;
Q3IconViewItem *i = 0;
bool alreadyIntersected = false;
for (; c; c = c->n) {
if (c->rect.intersects(r)) {
alreadyIntersected = true;
for (int j = 0; j < c->items.size(); ++j) {
Q3IconViewItem *item = c->items.at(j);
if (r.intersects(item->rect())) {
if (!i) {
i = item;
} else {
QRect r2 = item->rect();
QRect r3 = i->rect();
if (r2.y() < r3.y())
i = item;
else if (r2.y() == r3.y() &&
r2.x() < r3.x())
i = item;
}
}
}
} else {
if (alreadyIntersected)
break;
}
}
return i;
}
/*!
Finds the last item whose bounding rectangle overlaps \a r and
returns a pointer to that item. \a r is given in content
coordinates. Returns 0 if no item overlaps \a r.
\sa findFirstVisibleItem()
*/
Q3IconViewItem* Q3IconView::findLastVisibleItem(const QRect &r) const
{
Q3IconViewPrivate::ItemContainer *c = d->firstContainer;
Q3IconViewItem *i = 0;
bool alreadyIntersected = false;
for (; c; c = c->n) {
if (c->rect.intersects(r)) {
alreadyIntersected = true;
for (int j = 0; j < c->items.size(); ++j) {
Q3IconViewItem *item = c->items.at(j);
if (r.intersects(item->rect())) {
if (!i) {
i = item;
} else {
QRect r2 = item->rect();
QRect r3 = i->rect();
if (r2.y() > r3.y())
i = item;
else if (r2.y() == r3.y() &&
r2.x() > r3.x())
i = item;
}
}
}
} else {
if (alreadyIntersected)
break;
}
}
return i;
}
/*!
Clears the icon view. All items are deleted.
*/
void Q3IconView::clear()
{
setContentsPos(0, 0);
d->clearing = true;
bool block = signalsBlocked();
blockSignals(true);
clearSelection();
blockSignals(block);
setContentsPos(0, 0);
d->currentItem = 0;
if (!d->firstItem) {
d->clearing = false;
return;
}
Q3IconViewItem *item = d->firstItem, *tmp;
d->firstItem = 0;
while (item) {
tmp = item->next;
delete item;
item = tmp;
}
Q3IconViewPrivate::ItemContainer *c = d->firstContainer, *tmpc;
while (c) {
tmpc = c->n;
delete c;
c = tmpc;
}
d->firstContainer = d->lastContainer = 0;
d->count = 0;
d->lastItem = 0;
setCurrentItem(0);
d->highlightedItem = 0;
d->tmpCurrentItem = 0;
d->drawDragShapes = false;
resizeContents(0, 0);
// maybe we don't need this update, so delay it
d->fullRedrawTimer->start(0, true);
d->cleared = true;
d->clearing = false;
}
/*!
\property Q3IconView::gridX
\brief the horizontal grid of the icon view
If the value is -1, (the default), Q3IconView computes suitable
column widths based on the icon view's contents.
Note that setting a grid width overrides setMaxItemWidth().
*/
void Q3IconView::setGridX(int rx)
{
d->rastX = rx >= 0 ? rx : -1;
}
/*!
\property Q3IconView::gridY
\brief the vertical grid of the icon view
If the value is -1, (the default), Q3IconView computes suitable
column heights based on the icon view's contents.
*/
void Q3IconView::setGridY(int ry)
{
d->rastY = ry >= 0 ? ry : -1;
}
int Q3IconView::gridX() const
{
return d->rastX;
}
int Q3IconView::gridY() const
{
return d->rastY;
}
/*!
\property Q3IconView::spacing
\brief the space in pixels between icon view items
The default is 5 pixels.
Negative values for spacing are illegal.
*/
void Q3IconView::setSpacing(int sp)
{
d->spacing = sp;
}
int Q3IconView::spacing() const
{
return d->spacing;
}
/*!
\property Q3IconView::itemTextPos
\brief the position where the text of each item is drawn.
Valid values are \l Bottom or \l Right. The default is \l Bottom.
*/
void Q3IconView::setItemTextPos(ItemTextPos pos)
{
if (pos == d->itemTextPos || (pos != Bottom && pos != Right))
return;
d->itemTextPos = pos;
Q3IconViewItem *item = d->firstItem;
for (; item; item = item->next) {
item->wordWrapDirty = true;
item->calcRect();
}
arrangeItemsInGrid(true);
}
Q3IconView::ItemTextPos Q3IconView::itemTextPos() const
{
return d->itemTextPos;
}
/*!
\property Q3IconView::itemTextBackground
\brief the brush to use when drawing the background of an item's text.
By default this brush is set to Qt::NoBrush, meaning that only the
normal icon view background is used.
*/
void Q3IconView::setItemTextBackground(const QBrush &brush)
{
d->itemTextBrush = brush;
}
QBrush Q3IconView::itemTextBackground() const
{
return d->itemTextBrush;
}
/*!
\property Q3IconView::arrangement
\brief the arrangement mode of the icon view
This can be \l LeftToRight or \l TopToBottom. The default is \l
LeftToRight.
*/
void Q3IconView::setArrangement(Arrangement am)
{
if (d->arrangement == am)
return;
d->arrangement = am;
viewport()->setUpdatesEnabled(false);
resizeContents(viewport()->width(), viewport()->height());
viewport()->setUpdatesEnabled(true);
arrangeItemsInGrid(true);
}
Q3IconView::Arrangement Q3IconView::arrangement() const
{
return d->arrangement;
}
/*!
\property Q3IconView::resizeMode
\brief the resize mode of the icon view
This can be \l Fixed or \l Adjust. The default is \l Fixed.
See \l ResizeMode.
*/
void Q3IconView::setResizeMode(ResizeMode rm)
{
if (d->resizeMode == rm)
return;
d->resizeMode = rm;
}
Q3IconView::ResizeMode Q3IconView::resizeMode() const
{
return d->resizeMode;
}
/*!
\property Q3IconView::maxItemWidth
\brief the maximum width that an item may have.
The default is 100 pixels.
Note that if the gridX() value is set Q3IconView will ignore
this property.
*/
void Q3IconView::setMaxItemWidth(int w)
{
d->maxItemWidth = w;
}
/*!
\property Q3IconView::maxItemTextLength
\brief the maximum length (in characters) that an item's text may have.
The default is 255 characters.
*/
void Q3IconView::setMaxItemTextLength(int w)
{
d->maxItemTextLength = w;
}
int Q3IconView::maxItemWidth() const
{
if (d->rastX != -1)
return d->rastX - 2;
else
return d->maxItemWidth;
}
int Q3IconView::maxItemTextLength() const
{
return d->maxItemTextLength;
}
/*!
\property Q3IconView::itemsMovable
\brief whether the user is allowed to move items around in the icon view
The default is true.
*/
void Q3IconView::setItemsMovable(bool b)
{
d->rearrangeEnabled = b;
}
bool Q3IconView::itemsMovable() const
{
return d->rearrangeEnabled;
}
/*!
\property Q3IconView::autoArrange
\brief whether the icon view rearranges its items when a new item is inserted.
The default is true.
Note that if the icon view is not visible at the time of
insertion, Q3IconView defers all position-related work until it is
shown and then calls arrangeItemsInGrid().
*/
void Q3IconView::setAutoArrange(bool b)
{
d->reorderItemsWhenInsert = b;
}
bool Q3IconView::autoArrange() const
{
return d->reorderItemsWhenInsert;
}
/*!
If \a sort is true, this function sets the icon view to sort items
when a new item is inserted. If \a sort is false, the icon view
will not be sorted.
Note that autoArrange() must be true for sorting to take place.
If \a ascending is true (the default), items are sorted in
ascending order. If \a ascending is false, items are sorted in
descending order.
Q3IconViewItem::compare() is used to compare pairs of items. The
sorting is based on the items' keys; these default to the items'
text unless specifically set to something else.
\sa Q3IconView::setAutoArrange(), Q3IconView::autoArrange(),
sortDirection(), sort(), Q3IconViewItem::setKey()
*/
void Q3IconView::setSorting(bool sort, bool ascending)
{
d->resortItemsWhenInsert = sort;
d->sortDirection = ascending;
}
/*!
\property Q3IconView::sorting
\brief whether the icon view sorts on insertion
The default is false, i.e. no sorting on insertion.
To set the sorting, use setSorting().
*/
bool Q3IconView::sorting() const
{
return d->resortItemsWhenInsert;
}
/*!
\property Q3IconView::sortDirection
\brief whether the sort direction for inserting new items is ascending;
The default is true (i.e. ascending). This sort direction is only
meaningful if both sorting() and autoArrange() are true.
To set the sort direction, use setSorting()
*/
bool Q3IconView::sortDirection() const
{
return d->sortDirection;
}
/*!
\property Q3IconView::wordWrapIconText
\brief whether the item text will be word-wrapped if it is too long
The default is true.
If this property is false, icon text that is too long is
truncated, and an ellipsis (...) appended to indicate that
truncation has occurred. The full text can still be seen by the
user if they hover the mouse because the full text is shown in a
tooltip; see setShowToolTips().
*/
void Q3IconView::setWordWrapIconText(bool b)
{
if (d->wordWrapIconText == (uint)b)
return;
d->wordWrapIconText = b;
for (Q3IconViewItem *item = d->firstItem; item; item = item->next) {
item->wordWrapDirty = true;
item->calcRect();
}
arrangeItemsInGrid(true);
}
bool Q3IconView::wordWrapIconText() const
{
return d->wordWrapIconText;
}
/*!
\property Q3IconView::showToolTips
\brief whether the icon view will display a tool tip with the complete text for any truncated item text
The default is true. Note that this has no effect if
setWordWrapIconText() is true, as it is by default.
*/
void Q3IconView::setShowToolTips(bool b)
{
d->showTips = b;
}
bool Q3IconView::showToolTips() const
{
return d->showTips;
}
/*!
\reimp
*/
void Q3IconView::contentsMousePressEvent(QMouseEvent *e)
{
contentsMousePressEventEx(e);
}
void Q3IconView::contentsMousePressEventEx(QMouseEvent *e)
{
if (d->rubber) {
d->dragging = false;
delete d->rubber;
d->rubber = 0;
viewport()->update();
if (d->scrollTimer) {
disconnect(d->scrollTimer, SIGNAL(timeout()), this, SLOT(doAutoScroll()));
d->scrollTimer->stop();
delete d->scrollTimer;
d->scrollTimer = 0;
}
}
d->dragStartPos = e->pos();
Q3IconViewItem *item = findItem(e->pos());
d->pressedItem = item;
if (item)
d->selectAnchor = item;
#ifndef QT_NO_TEXTEDIT
if (d->renamingItem)
d->renamingItem->renameItem();
#endif
if (!d->currentItem && !item && d->firstItem) {
d->currentItem = d->firstItem;
repaintItem(d->firstItem);
}
if (item && item->dragEnabled())
d->startDragItem = item;
else
d->startDragItem = 0;
if (e->button() == Qt::LeftButton && !(e->state() & Qt::ShiftButton) &&
!(e->state() & Qt::ControlButton) && item && item->isSelected() &&
item->textRect(false).contains(e->pos())) {
if (!item->renameEnabled()) {
d->mousePressed = true;
#ifndef QT_NO_TEXTEDIT
} else {
ensureItemVisible(item);
setCurrentItem(item);
item->rename();
goto emit_signals;
#endif
}
}
d->pressedSelected = item && item->isSelected();
if (item && item->isSelectable()) {
if (d->selectionMode == Single)
item->setSelected(true, e->state() & Qt::ControlButton);
else if (d->selectionMode == Multi && !item->isSelected())
item->setSelected(true, e->state() & Qt::ControlButton);
else if (d->selectionMode == Extended) {
if (e->state() & Qt::ShiftButton) {
d->pressedSelected = false;
bool block = signalsBlocked();
blockSignals(true);
viewport()->setUpdatesEnabled(false);
QRect r;
bool select = true;
if (d->currentItem)
r = QRect(qMin(d->currentItem->x(), item->x()),
qMin(d->currentItem->y(), item->y()),
0, 0);
else
r = QRect(0, 0, 0, 0);
if (d->currentItem) {
if (d->currentItem->x() < item->x())
r.setWidth(item->x() - d->currentItem->x() + item->width());
else
r.setWidth(d->currentItem->x() - item->x() + d->currentItem->width());
if (d->currentItem->y() < item->y())
r.setHeight(item->y() - d->currentItem->y() + item->height());
else
r.setHeight(d->currentItem->y() - item->y() + d->currentItem->height());
r = r.normalized();
Q3IconViewPrivate::ItemContainer *c = d->firstContainer;
bool alreadyIntersected = false;
QRect redraw;
for (; c; c = c->n) {
if (c->rect.intersects(r)) {
alreadyIntersected = true;
for (int i = 0; i < c->items.size(); ++i) {
Q3IconViewItem *item = c->items.at(i);
if (r.intersects(item->rect())) {
redraw = redraw.united(item->rect());
item->setSelected(select, true);
}
}
} else {
if (alreadyIntersected)
break;
}
}
redraw = redraw.united(item->rect());
viewport()->setUpdatesEnabled(true);
repaintContents(redraw);
}
blockSignals(block);
viewport()->setUpdatesEnabled(true);
item->setSelected(select, true);
emit selectionChanged();
} else if (e->state() & Qt::ControlButton) {
d->pressedSelected = false;
item->setSelected(!item->isSelected(), e->state() & Qt::ControlButton);
} else {
item->setSelected(true, e->state() & Qt::ControlButton);
}
}
} else if ((d->selectionMode != Single || e->button() == Qt::RightButton)
&& !(e->state() & Qt::ControlButton))
selectAll(false);
setCurrentItem(item);
if (e->button() == Qt::LeftButton) {
if (!item && (d->selectionMode == Multi ||
d->selectionMode == Extended)) {
d->tmpCurrentItem = d->currentItem;
d->currentItem = 0;
repaintItem(d->tmpCurrentItem);
if (d->rubber)
delete d->rubber;
d->rubber = 0;
d->rubber = new QRect(e->x(), e->y(), 0, 0);
d->selectedItems.clear();
if ((e->state() & Qt::ControlButton) == Qt::ControlButton) {
for (Q3IconViewItem *i = firstItem(); i; i = i->nextItem())
if (i->isSelected())
d->selectedItems.insert(i, i);
}
}
d->mousePressed = true;
}
emit_signals:
if (!d->rubber) {
emit mouseButtonPressed(e->button(), item, e->globalPos());
emit pressed(item);
emit pressed(item, e->globalPos());
if (e->button() == Qt::RightButton)
emit rightButtonPressed(item, e->globalPos());
}
}
/*!
\reimp
*/
void Q3IconView::contentsContextMenuEvent(QContextMenuEvent *e)
{
if (!receivers(SIGNAL(contextMenuRequested(Q3IconViewItem*,QPoint)))) {
e->ignore();
return;
}
if (e->reason() == QContextMenuEvent::Keyboard) {
Q3IconViewItem *item = currentItem();
QRect r = item ? item->rect() : QRect(0, 0, visibleWidth(), visibleHeight());
emit contextMenuRequested(item, viewport()->mapToGlobal(contentsToViewport(r.center())));
} else {
d->mousePressed = false;
Q3IconViewItem *item = findItem(e->pos());
emit contextMenuRequested(item, e->globalPos());
}
}
/*!
\reimp
*/
void Q3IconView::contentsMouseReleaseEvent(QMouseEvent *e)
{
Q3IconViewItem *item = findItem(e->pos());
d->selectedItems.clear();
bool emitClicked = true;
d->mousePressed = false;
d->startDragItem = 0;
if (d->rubber) {
d->dragging = false;
viewport()->update();
if ((d->rubber->topLeft() - d->rubber->bottomRight()).manhattanLength() >
QApplication::startDragDistance())
emitClicked = false;
delete d->rubber;
d->rubber = 0;
d->currentItem = d->tmpCurrentItem;
d->tmpCurrentItem = 0;
if (d->currentItem)
repaintItem(d->currentItem);
}
if (d->scrollTimer) {
disconnect(d->scrollTimer, SIGNAL(timeout()), this, SLOT(doAutoScroll()));
d->scrollTimer->stop();
delete d->scrollTimer;
d->scrollTimer = 0;
}
if ((d->selectionMode == Extended || d->selectionMode == Multi) &&
d->currentItem == d->pressedItem &&
d->pressedSelected && d->currentItem) {
if (d->selectionMode == Extended) {
bool block = signalsBlocked();
blockSignals(true);
clearSelection();
blockSignals(block);
}
if (d->currentItem->isSelectable()) {
d->currentItem->selected = (d->selectionMode == Extended);
repaintItem(d->currentItem);
}
emit selectionChanged();
}
d->pressedItem = 0;
if (emitClicked) {
emit mouseButtonClicked(e->button(), item, e->globalPos());
emit clicked(item);
emit clicked(item, e->globalPos());
if (e->button() == Qt::RightButton)
emit rightButtonClicked(item, e->globalPos());
}
}
/*!
\reimp
*/
void Q3IconView::contentsMouseMoveEvent(QMouseEvent *e)
{
Q3IconViewItem *item = findItem(e->pos());
if (d->highlightedItem != item) {
if (item)
emit onItem(item);
else
emit onViewport();
d->highlightedItem = item;
}
if (d->mousePressed && e->state() == Qt::NoButton)
d->mousePressed = false;
if (d->startDragItem)
item = d->startDragItem;
if (d->mousePressed && d->startDragItem && item && item == d->currentItem &&
(item->isSelected() || d->selectionMode == NoSelection) && item->dragEnabled()) {
if ((d->dragStartPos - e->pos()).manhattanLength() > QApplication::startDragDistance()) {
d->mousePressed = false;
d->cleared = false;
#ifndef QT_NO_DRAGANDDROP
startDrag();
#endif
if (d->tmpCurrentItem)
repaintItem(d->tmpCurrentItem);
}
} else if (d->mousePressed && !d->currentItem && d->rubber) {
doAutoScroll();
}
}
/*!
\reimp
*/
void Q3IconView::contentsMouseDoubleClickEvent(QMouseEvent *e)
{
Q3IconViewItem *item = findItem(e->pos());
if (item) {
selectAll(false);
item->setSelected(true, true);
emit doubleClicked(item);
}
}
/*!
\reimp
*/
#ifndef QT_NO_DRAGANDDROP
void Q3IconView::contentsDragEnterEvent(QDragEnterEvent *e)
{
d->dragging = true;
d->drawDragShapes = true;
d->tmpCurrentItem = 0;
initDragEnter(e);
d->oldDragPos = e->pos();
d->oldDragAcceptAction = false;
drawDragShapes(e->pos());
d->dropped = false;
e->accept();
}
/*!
\reimp
*/
void Q3IconView::contentsDragMoveEvent(QDragMoveEvent *e)
{
if (e->pos() == d->oldDragPos) {
if (d->oldDragAcceptAction)
e->acceptAction();
else
e->ignore();
return;
}
drawDragShapes(d->oldDragPos);
d->dragging = false;
Q3IconViewItem *old = d->tmpCurrentItem;
d->tmpCurrentItem = 0;
Q3IconViewItem *item = findItem(e->pos());
if (item) {
if (old &&
old->rect().contains(d->oldDragPos) &&
!old->rect().contains(e->pos())) {
old->dragLeft();
repaintItem(old);
}
if (!item->rect().contains(d->oldDragPos))
item->dragEntered();
if (item->acceptDrop(e) || (item->isSelected() && e->source() == viewport())) {
d->oldDragAcceptAction = true;
e->acceptAction();
} else {
d->oldDragAcceptAction = false;
e->ignore();
}
d->tmpCurrentItem = item;
viewport()->update();
} else {
e->acceptAction();
d->oldDragAcceptAction = true;
if (old) {
old->dragLeft();
repaintItem(old);
}
}
d->oldDragPos = e->pos();
drawDragShapes(e->pos());
d->dragging = true;
}
/*!
\reimp
*/
void Q3IconView::contentsDragLeaveEvent(QDragLeaveEvent *)
{
if (!d->dropped)
drawDragShapes(d->oldDragPos);
d->dragging = false;
if (d->tmpCurrentItem) {
repaintItem(d->tmpCurrentItem);
d->tmpCurrentItem->dragLeft();
}
d->tmpCurrentItem = 0;
d->isIconDrag = false;
d->iconDragData.clear();
}
/*!
\reimp
*/
void Q3IconView::contentsDropEvent(QDropEvent *e)
{
d->dropped = true;
d->dragging = false;
drawDragShapes(d->oldDragPos);
if (d->tmpCurrentItem)
repaintItem(d->tmpCurrentItem);
Q3IconViewItem *i = findItem(e->pos());
if ((!i || i->isSelected()) && e->source() == viewport() && d->currentItem && !d->cleared) {
if (!d->rearrangeEnabled)
return;
QRect r = d->currentItem->rect();
d->currentItem->move(e->pos() - d->dragStart);
int w = d->currentItem->x() + d->currentItem->width() + 1;
int h = d->currentItem->y() + d->currentItem->height() + 1;
repaintItem(d->currentItem);
repaintContents(r.x(), r.y(), r.width(), r.height());
int dx = d->currentItem->x() - r.x();
int dy = d->currentItem->y() - r.y();
Q3IconViewItem *item = d->firstItem;
QRect rr;
for (; item; item = item->next) {
if (item->isSelected() && item != d->currentItem) {
rr = rr.united(item->rect());
item->moveBy(dx, dy);
rr = rr.united(item->rect());
}
w = qMax(w, item->x() + item->width() + 1);
h = qMax(h, item->y() + item->height() + 1);
}
repaintContents(rr);
bool fullRepaint = false;
if (w > contentsWidth() ||
h > contentsHeight())
fullRepaint = true;
int oldw = contentsWidth();
int oldh = contentsHeight();
resizeContents(w, h);
if (fullRepaint) {
repaintContents(oldw, 0, contentsWidth() - oldw, contentsHeight());
repaintContents(0, oldh, contentsWidth(), contentsHeight() - oldh);
}
e->acceptAction();
} else if (!i && (e->source() != viewport() || d->cleared)) {
QLinkedList<Q3IconDragItem> lst;
if (Q3IconDrag::canDecode(e)) {
QLinkedList<Q3IconDragDataItem> l;
Q3IconDragPrivate::decode(e, l);
QLinkedList<Q3IconDragDataItem>::Iterator it = l.begin();
for (; it != l.end(); ++it)
lst << (*it).data;
}
emit dropped(e, lst);
} else if (i) {
QLinkedList<Q3IconDragItem> lst;
if (Q3IconDrag::canDecode(e)) {
QLinkedList<Q3IconDragDataItem> l;
Q3IconDragPrivate::decode(e, l);
QLinkedList<Q3IconDragDataItem>::Iterator it = l.begin();
for (; it != l.end(); ++it)
lst << (*it).data;
}
i->dropped(e, lst);
}
d->isIconDrag = false;
}
#endif
/*!
\reimp
*/
void Q3IconView::resizeEvent(QResizeEvent* e)
{
Q3ScrollView::resizeEvent(e);
if (d->resizeMode == Adjust) {
optimize_layout = true;
adjustItems();
optimize_layout = false;
#if 0 // no need for timer delay anymore
d->oldSize = e->oldSize();
if (d->adjustTimer->isActive())
d->adjustTimer->stop();
d->adjustTimer->start(0, true);
#endif
}
}
/*!
Adjusts the positions of the items to the geometry of the icon
view.
*/
void Q3IconView::adjustItems()
{
d->adjustTimer->stop();
if (d->resizeMode == Adjust)
arrangeItemsInGrid(true);
}
/*!
\reimp
*/
void Q3IconView::keyPressEvent(QKeyEvent *e)
{
if (!d->firstItem)
return;
if (!d->currentItem) {
setCurrentItem(d->firstItem);
if (d->selectionMode == Single)
d->currentItem->setSelected(true, true);
return;
}
bool selectCurrent = true;
switch (e->key()) {
case Qt::Key_Escape:
e->ignore();
break;
#ifndef QT_NO_TEXTEDIT
case Qt::Key_F2: {
if (d->currentItem->renameEnabled()) {
d->currentItem->renameItem();
d->currentItem->rename();
return;
}
} break;
#endif
case Qt::Key_Home: {
d->currInputString.clear();
if (!d->firstItem)
break;
selectCurrent = false;
Q3IconViewItem *item = 0;
Q3IconViewPrivate::ItemContainer *c = d->firstContainer;
while (!item && c) {
QList<Q3IconViewItem*> &list = c->items;
for (int j = 0; j < list.size(); ++j) {
Q3IconViewItem *i = list.at(j);
if (!item) {
item = i;
} else {
if (d->arrangement == LeftToRight) {
// we use pixmap so the items textlength are ignored
// find topmost, leftmost item
if (i->pixmapRect(false).y() < item->pixmapRect(false).y() ||
(i->pixmapRect(false).y() == item->pixmapRect(false).y() &&
i->pixmapRect(false).x() < item->pixmapRect(false).x()))
item = i;
} else {
// find leftmost, topmost item
if (i->pixmapRect(false).x() < item->pixmapRect(false).x() ||
(i->pixmapRect(false).x() == item->pixmapRect(false).x() &&
i->pixmapRect(false).y() < item->pixmapRect(false).y()))
item = i;
}
}
}
c = c->n;
}
if (item) {
Q3IconViewItem *old = d->currentItem;
setCurrentItem(item);
ensureItemVisible(item);
handleItemChange(old, e->state() & Qt::ShiftButton,
e->state() & Qt::ControlButton, true);
}
} break;
case Qt::Key_End: {
d->currInputString.clear();
if (!d->lastItem)
break;
selectCurrent = false;
Q3IconViewItem *item = 0;
Q3IconViewPrivate::ItemContainer *c = d->lastContainer;
while (!item && c) {
QList<Q3IconViewItem*> &list = c->items;
for (int j = 0; j < list.size(); ++j) {
Q3IconViewItem *i = list.at(j);
if (!item) {
item = i;
} else {
if (d->arrangement == LeftToRight) {
// find bottommost, rightmost item
if (i->pixmapRect(false).bottom() > item->pixmapRect(false).bottom() ||
(i->pixmapRect(false).bottom() == item->pixmapRect(false).bottom() &&
i->pixmapRect(false).right() > item->pixmapRect(false).right()))
item = i;
} else {
// find rightmost, bottommost item
if (i->pixmapRect(false).right() > item->pixmapRect(false).right() ||
(i->pixmapRect(false).right() == item->pixmapRect(false).right() &&
i->pixmapRect(false).bottom() > item->pixmapRect(false).bottom()))
item = i;
}
}
}
c = c->p;
}
if (item) {
Q3IconViewItem *old = d->currentItem;
setCurrentItem(item);
ensureItemVisible(item);
handleItemChange(old, e->state() & Qt::ShiftButton,
e->state() & Qt::ControlButton, true);
}
} break;
case Qt::Key_Right: {
d->currInputString.clear();
Q3IconViewItem *item;
selectCurrent = false;
Direction dir = DirRight;
QRect r(0, d->currentItem->y(), contentsWidth(), d->currentItem->height());
item = findItem(dir, d->currentItem->rect().center(), r);
// search the row below from the right
while (!item && r.y() < contentsHeight()) {
r.moveBy(0, d->currentItem->height());
item = findItem(dir, QPoint(0, r.center().y()), r);
}
if (item) {
Q3IconViewItem *old = d->currentItem;
setCurrentItem(item);
ensureItemVisible(item);
handleItemChange(old, e->state() & Qt::ShiftButton, e->state() & Qt::ControlButton);
}
} break;
case Qt::Key_Left: {
d->currInputString.clear();
Q3IconViewItem *item;
selectCurrent = false;
Direction dir = DirLeft;
QRect r(0, d->currentItem->y(), contentsWidth(), d->currentItem->height());
item = findItem(dir, d->currentItem->rect().center(), r);
// search the row above from the left
while (!item && r.y() >= 0) {
r.moveBy(0, - d->currentItem->height());
item = findItem(dir, QPoint(contentsWidth(), r.center().y()), r);
}
if (item) {
Q3IconViewItem *old = d->currentItem;
setCurrentItem(item);
ensureItemVisible(item);
handleItemChange(old, e->state() & Qt::ShiftButton, e->state() & Qt::ControlButton);
}
} break;
case Qt::Key_Space: {
d->currInputString.clear();
if (d->selectionMode == Single)
break;
d->currentItem->setSelected(!d->currentItem->isSelected(), true);
} break;
case Qt::Key_Enter: case Qt::Key_Return:
d->currInputString.clear();
emit returnPressed(d->currentItem);
break;
case Qt::Key_Down: {
d->currInputString.clear();
Q3IconViewItem *item;
selectCurrent = false;
Direction dir = DirDown;
QRect r(d->currentItem->x(), 0, d->currentItem->width(), contentsHeight());
item = findItem(dir, d->currentItem->rect().center(), r);
// finding the closest item below and to the right
while (!item && r.x() < contentsWidth()) {
r.moveBy(r.width() , 0);
item = findItem(dir, QPoint(r.center().x(), 0), r);
}
Q3IconViewItem *i = d->currentItem;
setCurrentItem(item);
item = i;
handleItemChange(item, e->state() & Qt::ShiftButton, e->state() & Qt::ControlButton);
} break;
case Qt::Key_Up: {
d->currInputString.clear();
Q3IconViewItem *item;
selectCurrent = false;
Direction dir = DirUp;
QRect r(d->currentItem->x(), 0, d->currentItem->width(), contentsHeight());
item = findItem(dir, d->currentItem->rect().center(), r);
// finding the closest item above and to the left
while (!item && r.x() >= 0) {
r.moveBy(- r.width(), 0);
item = findItem(dir, QPoint(r.center().x(), contentsHeight()), r);
}
Q3IconViewItem *i = d->currentItem;
setCurrentItem(item);
item = i;
handleItemChange(item, e->state() & Qt::ShiftButton, e->state() & Qt::ControlButton);
} break;
case Qt::Key_Next: {
d->currInputString.clear();
selectCurrent = false;
QRect r;
if (d->arrangement == LeftToRight)
r = QRect(0, d->currentItem->y() + visibleHeight(), contentsWidth(), visibleHeight());
else
r = QRect(d->currentItem->x() + visibleWidth(), 0, visibleWidth(), contentsHeight());
Q3IconViewItem *item = d->currentItem;
Q3IconViewItem *ni = findFirstVisibleItem(r );
if (!ni) {
if (d->arrangement == LeftToRight)
r = QRect(0, d->currentItem->y() + d->currentItem->height(), contentsWidth(), contentsHeight());
else
r = QRect(d->currentItem->x() + d->currentItem->width(), 0, contentsWidth(), contentsHeight());
ni = findLastVisibleItem(r );
}
if (ni) {
setCurrentItem(ni);
handleItemChange(item, e->state() & Qt::ShiftButton, e->state() & Qt::ControlButton);
}
} break;
case Qt::Key_Prior: {
d->currInputString.clear();
selectCurrent = false;
QRect r;
if (d->arrangement == LeftToRight)
r = QRect(0, d->currentItem->y() - visibleHeight(), contentsWidth(), visibleHeight());
else
r = QRect(d->currentItem->x() - visibleWidth(), 0, visibleWidth(), contentsHeight());
Q3IconViewItem *item = d->currentItem;
Q3IconViewItem *ni = findFirstVisibleItem(r );
if (!ni) {
if (d->arrangement == LeftToRight)
r = QRect(0, 0, contentsWidth(), d->currentItem->y());
else
r = QRect(0, 0, d->currentItem->x(), contentsHeight());
ni = findFirstVisibleItem(r );
}
if (ni) {
setCurrentItem(ni);
handleItemChange(item, e->state() & Qt::ShiftButton, e->state() & Qt::ControlButton);
}
} break;
default:
if (!e->text().isEmpty() && e->text()[0].isPrint()) {
selectCurrent = false;
Q3IconViewItem *i = d->currentItem;
if (!i)
i = d->firstItem;
if (!d->inputTimer->isActive()) {
d->currInputString = e->text();
i = i->next;
if (!i)
i = d->firstItem;
i = findItemByName(i);
} else {
d->inputTimer->stop();
d->currInputString += e->text();
i = findItemByName(i);
if (!i) {
d->currInputString = e->text();
if (d->currentItem && d->currentItem->next)
i = d->currentItem->next;
else
i = d->firstItem;
i = findItemByName(i);
}
}
if (i) {
setCurrentItem(i);
if (d->selectionMode == Extended) {
bool changed = false;
bool block = signalsBlocked();
blockSignals(true);
selectAll(false);
blockSignals(block);
if (!i->selected && i->isSelectable()) {
changed = true;
i->selected = true;
repaintItem(i);
}
if (changed)
emit selectionChanged();
}
}
d->inputTimer->start(400, true);
} else {
selectCurrent = false;
d->currInputString.clear();
if (e->state() & Qt::ControlButton) {
switch (e->key()) {
case Qt::Key_A:
selectAll(true);
break;
}
}
e->ignore();
return;
}
}
if (!(e->state() & Qt::ShiftButton) || !d->selectAnchor)
d->selectAnchor = d->currentItem;
if (d->currentItem && !d->currentItem->isSelected() &&
d->selectionMode == Single && selectCurrent) {
d->currentItem->setSelected(true);
}
ensureItemVisible(d->currentItem);
}
/*
Finds the closest item in the Direction \a dir relative from the point \a relativeTo
which intersects with the searchRect.
The function chooses the closest item with its center in the \a searchRect.
*/
Q3IconViewItem* Q3IconView::findItem(Direction dir,
const QPoint &relativeTo,
const QRect &searchRect) const
{
Q3IconViewItem *centerMatch = 0;
int centerMatchML = 0;
// gets list of containers with potential items
QList<Q3IconViewPrivate::ItemContainer * >* cList =
d->findContainers(dir, relativeTo, searchRect);
for (int i = 0; i < cList->size() && !centerMatch; ++i) {
QList<Q3IconViewItem *> &list = (cList->at(i))->items;
for (int j = 0; j < list.size(); ++j) {
Q3IconViewItem *item = list.at(j);
if (neighbourItem(dir, relativeTo, item) &&
searchRect.contains(item->rect().center()) && item != currentItem()) {
int ml = (relativeTo - item->rect().center()).manhattanLength();
if (centerMatch) {
if (ml < centerMatchML) {
centerMatch = item;
centerMatchML = ml;
}
} else {
centerMatch = item;
centerMatchML = ml;
}
}
}
}
return centerMatch;
}
/*
Returns true if the items orientation compared to
the point \a relativeTo is correct.
*/
bool Q3IconView::neighbourItem(Direction dir,
const QPoint &relativeTo,
const Q3IconViewItem *item) const
{
switch (dir) {
case DirUp:
if (item->rect().center().y() < relativeTo.y())
return true;
break;
case DirDown:
if (item->rect().center().y() > relativeTo.y())
return true;
break;
case DirLeft:
if (item->rect().center().x() < relativeTo.x())
return true;
break;
case DirRight:
if (item->rect().center().x() > relativeTo.x())
return true;
break;
default:
// nothing
break;
}
return false;
}
/*!
\reimp
*/
void Q3IconView::focusInEvent(QFocusEvent *e)
{
d->mousePressed = false;
d->inMenuMode = false;
if (d->currentItem) {
repaintItem(d->currentItem);
} else if (d->firstItem && e->reason() != Qt::MouseFocusReason) {
d->currentItem = d->firstItem;
emit currentChanged(d->currentItem);
repaintItem(d->currentItem);
}
if (style()->styleHint(QStyle::SH_ItemView_ChangeHighlightOnFocus, 0, this))
repaintSelectedItems();
}
/*!
\reimp
*/
void Q3IconView::focusOutEvent(QFocusEvent *e)
{
if (style()->styleHint(QStyle::SH_ItemView_ChangeHighlightOnFocus, 0, this)) {
d->inMenuMode =
e->reason() == Qt::PopupFocusReason ||
(qApp->focusWidget() && qApp->focusWidget()->inherits("QMenuBar"));
if (!d->inMenuMode)
repaintSelectedItems();
}
if (d->currentItem)
repaintItem(d->currentItem);
}
/*!
Draws the rubber band using the painter \a p.
*/
void Q3IconView::drawRubber(QPainter *p)
{
if (!p || !d->rubber)
return;
QStyleOptionRubberBand opt;
opt.rect = d->rubber->normalized();
opt.shape = QRubberBand::Rectangle;
opt.palette = palette();
opt.state = QStyle::State_None;
style()->drawControl(QStyle::CE_RubberBand, &opt, p, this);
}
/*!
Returns the Q3DragObject that should be used for drag-and-drop.
This function is called by the icon view when starting a drag to
get the dragobject that should be used for the drag. Subclasses
may reimplement this.
\sa Q3IconDrag
*/
#ifndef QT_NO_DRAGANDDROP
Q3DragObject *Q3IconView::dragObject()
{
if (!d->currentItem)
return 0;
QPoint orig = d->dragStartPos;
Q3IconDrag *drag = new Q3IconDrag(viewport());
drag->setPixmap((d->currentItem->pixmap() ?
*d->currentItem->pixmap() : QPixmap()), // ### QPicture
QPoint(d->currentItem->pixmapRect().width() / 2,
d->currentItem->pixmapRect().height() / 2));
if (d->selectionMode == NoSelection) {
Q3IconViewItem *item = d->currentItem;
drag->append(Q3IconDragItem(),
QRect(item->pixmapRect(false).x() - orig.x(),
item->pixmapRect(false).y() - orig.y(),
item->pixmapRect().width(), item->pixmapRect().height()),
QRect(item->textRect(false).x() - orig.x(),
item->textRect(false).y() - orig.y(),
item->textRect().width(), item->textRect().height()));
} else {
for (Q3IconViewItem *item = d->firstItem; item; item = item->next) {
if (item->isSelected()) {
drag->append(Q3IconDragItem(),
QRect(item->pixmapRect(false).x() - orig.x(),
item->pixmapRect(false).y() - orig.y(),
item->pixmapRect().width(), item->pixmapRect().height()),
QRect(item->textRect(false).x() - orig.x(),
item->textRect(false).y() - orig.y(),
item->textRect().width(), item->textRect().height()));
}
}
}
return drag;
}
/*!
Starts a drag.
*/
void Q3IconView::startDrag()
{
if (!d->startDragItem)
return;
QPoint orig = d->dragStartPos;
d->dragStart = QPoint(orig.x() - d->startDragItem->x(),
orig.y() - d->startDragItem->y());
d->startDragItem = 0;
d->mousePressed = false;
d->pressedItem = 0;
d->pressedSelected = 0;
Q3DragObject *drag = dragObject();
if (!drag)
return;
if (drag->drag())
if (drag->target() != viewport())
emit moved();
}
#endif
/*!
Inserts the Q3IconViewItem \a item in the icon view's grid. \e{You
should never need to call this function.} Instead, insert
Q3IconViewItems by creating them with a pointer to the Q3IconView
that they are to be inserted into.
*/
void Q3IconView::insertInGrid(Q3IconViewItem *item)
{
if (!item)
return;
if (d->reorderItemsWhenInsert) {
// #### make this efficient - but it's not too dramatic
int y = d->spacing;
item->dirty = false;
if (item == d->firstItem) {
bool dummy;
makeRowLayout(item, y, dummy);
return;
}
Q3IconViewItem *begin = rowBegin(item);
y = begin->y();
while (begin) {
bool dummy;
begin = makeRowLayout(begin, y, dummy);
if (!begin || !begin->next)
break;
begin = begin->next;
}
item->dirty = false;
} else {
QRegion r(QRect(0, 0, qMax(contentsWidth(), visibleWidth()),
qMax(contentsHeight(), visibleHeight())));
int y = -1;
for (Q3IconViewItem *i = d->firstItem; i; i = i->next) {
r = r.subtracted(i->rect());
y = qMax(y, i->y() + i->height());
}
QVector<QRect> rects = r.rects();
bool foundPlace = false;
for (int j = 0; j < rects.size(); ++j) {
const QRect rect = rects.at(j);
if (rect.width() >= item->width() &&
rect.height() >= item->height()) {
int sx = 0, sy = 0;
if (rect.width() >= item->width() + d->spacing)
sx = d->spacing;
if (rect.height() >= item->height() + d->spacing)
sy = d->spacing;
item->move(rect.x() + sx, rect.y() + sy);
foundPlace = true;
break;
}
}
if (!foundPlace)
item->move(d->spacing, y + d->spacing);
resizeContents(qMax(contentsWidth(), item->x() + item->width()),
qMax(contentsHeight(), item->y() + item->height()));
item->dirty = false;
}
}
/*!
Emits a signal to indicate selection changes. \a i is the
Q3IconViewItem that was selected or de-selected.
\e{You should never need to call this function.}
*/
void Q3IconView::emitSelectionChanged(Q3IconViewItem *i)
{
emit selectionChanged();
if (d->selectionMode == Single)
emit selectionChanged(i ? i : d->currentItem);
}
/*!
\internal
*/
void Q3IconView::emitRenamed(Q3IconViewItem *item)
{
if (!item)
return;
emit itemRenamed(item, item->text());
emit itemRenamed(item);
}
/*!
If a drag enters the icon view the shapes of the objects which the
drag contains are drawn, usnig \a pos as origin.
*/
void Q3IconView::drawDragShapes(const QPoint &pos)
{
#ifndef QT_NO_DRAGANDDROP
if (pos == QPoint(-1, -1))
return;
if (!d->drawDragShapes) {
d->drawDragShapes = true;
return;
}
d->dragPos = pos;
viewport()->update();
#endif
}
/*!
When a drag enters the icon view, this function is called to
initialize it. Initializing in this context means getting
information about the drag, for example so that the icon view
knows enough about the drag to be able to draw drag shapes for the
drag data (e.g. shapes of icons which are dragged), etc.
*/
#ifndef QT_NO_DRAGANDDROP
void Q3IconView::initDragEnter(QDropEvent *e)
{
if (Q3IconDrag::canDecode(e)) {
Q3IconDragPrivate::decode(e, d->iconDragData);
d->isIconDrag = true;
} else if (Q3UriDrag::canDecode(e)) {
Q3StrList lst;
Q3UriDrag::decode(e, lst);
d->numDragItems = lst.count();
} else {
d->numDragItems = 0;
}
}
#endif
/*!
This function is called to draw the rectangle \a r of the
background using the painter \a p.
The default implementation fills \a r with the viewport's
backgroundBrush(). Subclasses can reimplement this to draw custom
backgrounds.
\sa drawContents()
*/
void Q3IconView::drawBackground(QPainter *p, const QRect &r)
{
p->fillRect(r, viewport()->backgroundBrush());
}
/*!
\reimp
*/
bool Q3IconView::eventFilter(QObject * o, QEvent * e)
{
if (o == viewport()) {
switch(e->type()) {
case QEvent::FocusIn:
focusInEvent((QFocusEvent*)e);
return true;
case QEvent::FocusOut:
focusOutEvent((QFocusEvent*)e);
return true;
case QEvent::Enter:
enterEvent(e);
return true;
case QEvent::Paint:
if (o == viewport()) {
viewportPaintEvent((QPaintEvent*)e);
QPainter p(viewport());
if (d->dragging) {
if (!d->rubber && d->drawDragShapes) {
p.setPen(QPen(Qt::color0));
QStyleOptionFocusRect opt;
opt.palette = palette();
opt.state = QStyle::State_KeyboardFocusChange;
opt.backgroundColor = palette().base().color();
if (d->isIconDrag) {
d->dragPos = contentsToViewport(d->dragPos);
QLinkedList<Q3IconDragDataItem>::Iterator it = d->iconDragData.begin();
for (; it != d->iconDragData.end(); ++it) {
QRect ir = (*it).item.pixmapRect();
QRect tr = (*it).item.textRect();
tr.moveBy(d->dragPos.x(), d->dragPos.y());
ir.moveBy(d->dragPos.x(), d->dragPos.y());
if (!ir.intersects(QRect(0, 0, visibleWidth(), visibleHeight())))
continue;
opt.rect = ir;
style()->drawPrimitive(QStyle::PE_FrameFocusRect, &opt, &p, this);
opt.rect = tr;
p.drawRect(tr);
style()->drawPrimitive(QStyle::PE_FrameFocusRect, &opt, &p, this);
}
} else if (d->numDragItems > 0) {
for (int i = 0; i < d->numDragItems; ++i) {
opt.rect.setRect(d->dragPos.x() + i * 40, d->dragPos.y(), 35, 35);
style()->drawPrimitive(QStyle::PE_FrameFocusRect, &opt, &p, this);
}
}
p.end();
}
} else {
p.translate(-contentsX(), -contentsY());
drawRubber(&p);
}
}
return true;
#ifndef QT_NO_TOOLTIP
case QHelpEvent::ToolTip:
{
if (wordWrapIconText() || !showToolTips())
return false;
QHelpEvent *he = static_cast<QHelpEvent *>(e);
Q3IconViewItem *item = findItem(viewportToContents(he->pos()));
if (!item || item->tmpText == item->itemText) {
QToolTip::showText(he->globalPos(), QString(), viewport());
return true;
}
QToolTip::showText(he->globalPos(), item->itemText, viewport());
return true;
}
#endif
default:
// nothing
break;
}
}
return Q3ScrollView::eventFilter(o, e);
}
/*!
\reimp
*/
QSize Q3IconView::minimumSizeHint() const
{
return Q3ScrollView::minimumSizeHint();
}
/*!
\internal
Finds the next item after the start item beginning
with \a text.
*/
Q3IconViewItem* Q3IconView::findItemByName(Q3IconViewItem *start)
{
if (!start)
return 0;
QString match = d->currInputString.toLower();
if (match.length() < 1)
return start;
QString curText;
Q3IconViewItem *i = start;
do {
curText = i->text().toLower();
if (curText.startsWith(match))
return i;
i = i->next;
if (!i)
i = d->firstItem;
} while (i != start);
return 0;
}
/*!
Lays out a row of icons (if Arrangement == \l TopToBottom this is
a column). Starts laying out with the item \a begin. \a y is the
starting coordinate. Returns the last item of the row (column) and
sets the new starting coordinate to \a y. The \a changed parameter
is used internally.
\warning This function may be made private in a future version of
Qt. We do not recommend calling it.
*/
Q3IconViewItem *Q3IconView::makeRowLayout(Q3IconViewItem *begin, int &y, bool &changed)
{
Q3IconViewItem *end = 0;
bool reverse = QApplication::reverseLayout();
changed = false;
if (d->arrangement == LeftToRight) {
if (d->rastX == -1) {
// first calculate the row height
int h = 0;
int x = 0;
int ih = 0;
Q3IconViewItem *item = begin;
for (;;) {
x += d->spacing + item->width();
if (x > visibleWidth() && item != begin) {
item = item->prev;
break;
}
h = qMax(h, item->height());
ih = qMax(ih, item->pixmapRect().height());
Q3IconViewItem *old = item;
item = item->next;
if (!item) {
item = old;
break;
}
}
end = item;
if (d->rastY != -1)
h = qMax(h, d->rastY);
// now move the items
item = begin;
for (;;) {
item->dirty = false;
int x;
if (item == begin) {
if (reverse)
x = visibleWidth() - d->spacing - item->width();
else
x = d->spacing;
} else {
if (reverse)
x = item->prev->x() - item->width() - d->spacing;
else
x = item->prev->x() + item->prev->width() + d->spacing;
}
changed = item->move(x, y + ih - item->pixmapRect().height()) || changed;
if (y + h < item->y() + item->height())
h = qMax(h, ih + item->textRect().height());
if (item == end)
break;
item = item->next;
}
y += h + d->spacing;
} else {
// first calculate the row height
int h = begin->height();
int x = d->spacing;
int ih = begin->pixmapRect().height();
Q3IconViewItem *item = begin;
int i = 0;
int sp = 0;
for (;;) {
int r = calcGridNum(item->width(), d->rastX);
if (item == begin) {
i += r;
sp += r;
x = d->spacing + d->rastX * r;
} else {
sp += r;
i += r;
x = i * d->rastX + sp * d->spacing;
}
if (x > visibleWidth() && item != begin) {
item = item->prev;
break;
}
h = qMax(h, item->height());
ih = qMax(ih, item->pixmapRect().height());
Q3IconViewItem *old = item;
item = item->next;
if (!item) {
item = old;
break;
}
}
end = item;
if (d->rastY != -1)
h = qMax(h, d->rastY);
// now move the items
item = begin;
i = 0;
sp = 0;
for (;;) {
item->dirty = false;
int r = calcGridNum(item->width(), d->rastX);
if (item == begin) {
if (d->itemTextPos == Bottom)
changed = item->move(d->spacing + (r * d->rastX - item->width()) / 2,
y + ih - item->pixmapRect().height()) || changed;
else
changed = item->move(d->spacing, y + ih - item->pixmapRect().height()) || changed;
i += r;
sp += r;
} else {
sp += r;
int x = i * d->rastX + sp * d->spacing;
if (d->itemTextPos == Bottom)
changed = item->move(x + (r * d->rastX - item->width()) / 2,
y + ih - item->pixmapRect().height()) || changed;
else
changed = item->move(x, y + ih - item->pixmapRect().height()) || changed;
i += r;
}
if (y + h < item->y() + item->height())
h = qMax(h, ih + item->textRect().height());
if (item == end)
break;
item = item->next;
}
y += h + d->spacing;
}
} else { // -------------------------------- SOUTH ------------------------------
int x = y;
{
int w = 0;
int y = 0;
Q3IconViewItem *item = begin;
for (;;) {
y += d->spacing + item->height();
if (y > visibleHeight() && item != begin) {
item = item->prev;
break;
}
w = qMax(w, item->width());
Q3IconViewItem *old = item;
item = item->next;
if (!item) {
item = old;
break;
}
}
end = item;
if (d->rastX != -1)
w = qMax(w, d->rastX);
// now move the items
item = begin;
for (;;) {
item->dirty = false;
if (d->itemTextPos == Bottom) {
if (item == begin)
changed = item->move(x + (w - item->width()) / 2, d->spacing) || changed;
else
changed = item->move(x + (w - item->width()) / 2,
item->prev->y() + item->prev->height() + d->spacing) || changed;
} else {
if (item == begin)
changed = item->move(x, d->spacing) || changed;
else
changed = item->move(x, item->prev->y() + item->prev->height() + d->spacing) || changed;
}
if (item == end)
break;
item = item->next;
}
x += w + d->spacing;
}
y = x;
}
return end;
}
/*!
\internal
Calculates how many cells an item of width \a w needs in a grid with of
\a x and returns the result.
*/
int Q3IconView::calcGridNum(int w, int x) const
{
float r = (float)w / (float)x;
if ((w / x) * x != w)
r += 1.0;
return (int)r;
}
/*!
\internal
Returns the first item of the row which contains \a item.
*/
Q3IconViewItem *Q3IconView::rowBegin(Q3IconViewItem *) const
{
// #### todo
return d->firstItem;
}
/*!
Sorts and rearranges all the items in the icon view. If \a
ascending is true, the items are sorted in increasing order,
otherwise they are sorted in decreasing order.
Q3IconViewItem::compare() is used to compare pairs of items. The
sorting is based on the items' keys; these default to the items'
text unless specifically set to something else.
Note that this function sets the sort order to \a ascending.
\sa Q3IconViewItem::key(), Q3IconViewItem::setKey(),
Q3IconViewItem::compare(), Q3IconView::setSorting(),
Q3IconView::sortDirection()
*/
void Q3IconView::sort(bool ascending)
{
if (count() == 0)
return;
d->sortDirection = ascending;
Q3IconViewPrivate::SortableItem *items = new Q3IconViewPrivate::SortableItem[count()];
Q3IconViewItem *item = d->firstItem;
int i = 0;
for (; item; item = item->next)
items[i++].item = item;
qsort(items, count(), sizeof(Q3IconViewPrivate::SortableItem), cmpIconViewItems);
Q3IconViewItem *prev = 0;
item = 0;
if (ascending) {
for (i = 0; i < (int)count(); ++i) {
item = items[i].item;
if (item) {
item->prev = prev;
if (item->prev)
item->prev->next = item;
item->next = 0;
}
if (i == 0)
d->firstItem = item;
if (i == (int)count() - 1)
d->lastItem = item;
prev = item;
}
} else {
for (i = (int)count() - 1; i >= 0 ; --i) {
item = items[i].item;
if (item) {
item->prev = prev;
if (item->prev)
item->prev->next = item;
item->next = 0;
}
if (i == (int)count() - 1)
d->firstItem = item;
if (i == 0)
d->lastItem = item;
prev = item;
}
}
delete [] items;
arrangeItemsInGrid(true);
}
/*!
\reimp
*/
QSize Q3IconView::sizeHint() const
{
ensurePolished();
if (!d->firstItem)
return Q3ScrollView::sizeHint();
if (d->dirty && d->firstSizeHint) {
((Q3IconView*)this)->resizeContents(qMax(400, contentsWidth()),
qMax(400, contentsHeight()));
if (autoArrange())
((Q3IconView*)this)->arrangeItemsInGrid(false);
d->firstSizeHint = false;
}
d->dirty = true;
const QScrollBar *sb = verticalScrollBar();
QStyleOptionSlider opt;
opt.init(sb);
opt.orientation = sb->orientation();
int extra = style()->pixelMetric(QStyle::PM_ScrollBarExtent, &opt, sb) + 2 * frameWidth();
QSize s(qMin(400, contentsWidth() + extra),
qMin(400, contentsHeight() + extra));
return s;
}
/*!
\internal
*/
void Q3IconView::updateContents()
{
viewport()->update();
}
/*!
\reimp
*/
void Q3IconView::enterEvent(QEvent *e)
{
Q3ScrollView::enterEvent(e);
emit onViewport();
}
/*!
\internal
This function is always called when the geometry of an item changes.
This function moves the item into the correct area in the internal
data structure.
*/
void Q3IconView::updateItemContainer(Q3IconViewItem *item)
{
if (!item || d->containerUpdateLocked || (!isVisible() && autoArrange()))
return;
if (item->d->container1 && d->firstContainer) {
//Special-case to check if we can use removeLast otherwise use removeAll (slower)
if (item->d->container1->items.last() == item)
item->d->container1->items.removeLast();
else
item->d->container1->items.removeAll(item);
}
item->d->container1 = 0;
if (item->d->container2 && d->firstContainer) {
//Special-case to check if we can use removeLast otherwise use removeAll (slower)
if (item->d->container2->items.last() == item)
item->d->container2->items.removeLast();
else
item->d->container2->items.removeAll(item);
}
item->d->container2 = 0;
Q3IconViewPrivate::ItemContainer *c = d->firstContainer;
if (!c) {
appendItemContainer();
c = d->firstContainer;
}
const QRect irect = item->rect();
bool contains = false;
for (;;) {
if (c->rect.intersects(irect)) {
contains = c->rect.contains(irect);
break;
}
c = c->n;
if (!c) {
appendItemContainer();
c = d->lastContainer;
}
}
if (!c) {
qWarning("Q3IconViewItem::updateItemContainer(): No fitting container found!");
return;
}
c->items.append(item);
item->d->container1 = c;
if (!contains) {
c = c->n;
if (!c) {
appendItemContainer();
c = d->lastContainer;
}
c->items.append(item);
item->d->container2 = c;
}
if (contentsWidth() < irect.right() || contentsHeight() < irect.bottom())
resizeContents(qMax(contentsWidth(), irect.right()), qMax(contentsHeight(), irect.bottom()));
}
/*!
\internal
Appends a new rect area to the internal data structure of the items.
*/
void Q3IconView::appendItemContainer()
{
QSize s;
// #### We have to find out which value is best here
if (d->arrangement == LeftToRight)
s = QSize(INT_MAX - 1, RECT_EXTENSION);
else
s = QSize(RECT_EXTENSION, INT_MAX - 1);
if (!d->firstContainer) {
d->firstContainer = new Q3IconViewPrivate::ItemContainer(0, 0, QRect(QPoint(0, 0), s));
d->lastContainer = d->firstContainer;
} else {
if (d->arrangement == LeftToRight)
d->lastContainer = new Q3IconViewPrivate::ItemContainer(
d->lastContainer, 0, QRect(d->lastContainer->rect.bottomLeft(), s));
else
d->lastContainer = new Q3IconViewPrivate::ItemContainer(
d->lastContainer, 0, QRect(d->lastContainer->rect.topRight(), s));
}
}
/*! \internal
Rebuilds the whole internal data structure. This is done when it's
likely that most/all items change their geometry (e.g. in
arrangeItemsInGrid()), because calling this is then more efficient
than calling updateItemContainer() for each item.
*/
void Q3IconView::rebuildContainers()
{
Q3IconViewPrivate::ItemContainer *c = d->firstContainer, *tmpc;
while (c) {
tmpc = c->n;
delete c;
c = tmpc;
}
d->firstContainer = d->lastContainer = 0;
Q3IconViewItem *item = d->firstItem;
appendItemContainer();
c = d->lastContainer;
while (item) {
if (c->rect.contains(item->rect())) {
item->d->container1 = c;
item->d->container2 = 0;
c->items.append(item);
item = item->next;
} else if (c->rect.intersects(item->rect())) {
item->d->container1 = c;
c->items.append(item);
c = c->n;
if (!c) {
appendItemContainer();
c = d->lastContainer;
}
c->items.append(item);
item->d->container2 = c;
item = item->next;
c = c->p;
} else {
if (d->arrangement == LeftToRight) {
if (item->y() < c->rect.y() && c->p) {
c = c->p;
continue;
}
} else {
if (item->x() < c->rect.x() && c->p) {
c = c->p;
continue;
}
}
c = c->n;
if (!c) {
appendItemContainer();
c = d->lastContainer;
}
}
}
}
/*!
\internal
*/
void Q3IconView::movedContents(int, int)
{
if (d->drawDragShapes) {
drawDragShapes(d->oldDragPos);
d->oldDragPos = QPoint(-1, -1);
}
}
void Q3IconView::handleItemChange(Q3IconViewItem *old, bool shift,
bool control, bool homeend)
{
if (d->selectionMode == Single) {
bool block = signalsBlocked();
blockSignals(true);
if (old)
old->setSelected(false);
blockSignals(block);
d->currentItem->setSelected(true, true);
} else if (d->selectionMode == Extended) {
if (shift) {
if (!d->selectAnchor) {
if (old && !old->selected && old->isSelectable()) {
old->selected = true;
repaintItem(old);
}
d->currentItem->setSelected(true, true);
} else {
Q3IconViewItem *from = d->selectAnchor, *to = d->currentItem;
if (!from || !to)
return;
// checking if it's downwards and if we span rows
bool downwards = false;
bool spanning = false;
if (d->arrangement == LeftToRight) {
if (from->rect().center().y() < to->rect().center().y())
downwards = true;
} else {
if (from->rect().center().x() < to->rect().center().x())
downwards = true;
}
QRect fr = from->rect();
QRect tr = to->rect();
if (d->arrangement == LeftToRight) {
fr.moveTopLeft(QPoint(tr.x(), fr.y()));
if (!tr.intersects(fr))
spanning = true;
} else {
fr.moveTopLeft(QPoint(fr.x(), tr.y()));
if (!tr.intersects(fr))
spanning = true;
}
// finding the rectangles
QRect topRect, bottomRect, midRect;
if (!spanning) {
midRect = from->rect().united(to->rect());
} else {
if (downwards) {
topRect = from->rect();
bottomRect = to->rect();
} else {
topRect = to->rect();
bottomRect = from->rect();
}
if (d->arrangement == LeftToRight) {
topRect.setRight(contentsWidth());
bottomRect.setLeft(0);
midRect.setRect(0, topRect.bottom(),
contentsWidth(),
bottomRect.top() - topRect.bottom());
} else {
topRect.setBottom(contentsHeight());
bottomRect.setTop(0);
midRect.setRect(topRect.right(),
0,
bottomRect.left() - topRect.right(),
contentsHeight());
}
}
// finding contained items and selecting them
Q3IconViewItem *item = 0;
bool changed = false;
bool midValid = midRect.isValid();
bool topValid = topRect.isValid();
bool bottomValid = bottomRect.isValid();
QRect selectedRect, unselectedRect;
for (item = d->firstItem; item; item = item->next) {
bool contained = false;
QPoint itemCenter = item->rect().center();
if (midValid && midRect.contains(itemCenter))
contained = true;
if (!contained && topValid && topRect.contains(itemCenter))
contained = true;
if (!contained && bottomValid && bottomRect.contains(itemCenter))
contained = true;
if (contained) {
if (!item->selected && item->isSelectable()) {
changed = true;
item->selected = true;
selectedRect = selectedRect.united(item->rect());
}
} else if (item->selected && !control) {
item->selected = false;
unselectedRect = unselectedRect.united(item->rect());
changed = true;
}
}
QRect viewRect(contentsX(), contentsY(),
visibleWidth(), visibleHeight());
if (viewRect.intersects(selectedRect)) {
if (homeend)
Q3ScrollView::updateContents(viewRect.intersected(selectedRect));
else
repaintContents(viewRect.intersected(selectedRect));
}
if (viewRect.intersects(unselectedRect)) {
if (homeend)
Q3ScrollView::updateContents(viewRect.intersected(unselectedRect));
else
repaintContents(viewRect.intersected(unselectedRect));
}
if (changed)
emit selectionChanged();
}
} else if (!control) {
blockSignals(true);
selectAll(false);
blockSignals(false);
d->currentItem->setSelected(true, true);
}
} else {
if (shift)
d->currentItem->setSelected(!d->currentItem->isSelected(), true);
}
}
QBitmap Q3IconView::mask(QPixmap *pix) const
{
QBitmap m;
if (d->maskCache.find(QString::number(pix->serialNumber()), m))
return m;
if (pix->hasAlphaChannel())
m = pix->mask();
else
m = pix->createHeuristicMask();
d->maskCache.insert(QString::number(pix->serialNumber()), m);
return m;
}
/*!
Returns true if an iconview item is being renamed; otherwise
returns false.
*/
bool Q3IconView::isRenaming() const
{
#ifndef QT_NO_TEXTEDIT
return d->renamingItem && d->renamingItem->renameBox;
#else
return false;
#endif
}
/*!
\enum Q3IconView::StringComparisonMode
This enum type is used to set the string comparison mode when
searching for an item. We'll refer to the string being searched
as the 'target' string.
\value CaseSensitive The strings must match case sensitively.
\value ExactMatch The target and search strings must match exactly.
\value BeginsWith The target string begins with the search string.
\value EndsWith The target string ends with the search string.
\value Contains The target string contains the search string.
If you OR these flags together (excluding \c CaseSensitive), the
search criteria be applied in the following order: \c ExactMatch,
\c BeginsWith, \c EndsWith, \c Contains.
Matching is case-insensitive unless \c CaseSensitive is set. \c
CaseSensitive can be OR-ed with any combination of the other
flags.
\sa ComparisonFlags
*/
/*!
\typedef Q3IconView::ComparisonFlags
This typedef is used in Q3IconView's API for values that are OR'd
combinations of \l StringComparisonMode values.
\sa StringComparisonMode
*/
QT_END_NAMESPACE
#endif // QT_NO_ICONVIEW