/**************************************************************************** ** ** Implementation of QIconView widget class ** ** Created : 990707 ** ** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved. ** ** This file is part of the iconview module of the Qt GUI Toolkit. ** ** This file may be used under the terms of the GNU General ** Public License versions 2.0 or 3.0 as published by the Free ** Software Foundation and appearing in the files LICENSE.GPL2 ** and LICENSE.GPL3 included in the packaging of this file. ** Alternatively you may (at your option) use any later version ** of the GNU General Public License if such license has been ** publicly approved by Trolltech ASA (or its successors, if any) ** and the KDE Free Qt Foundation. ** ** Please review the following information to ensure GNU General ** Public Licensing requirements will be met: ** http://trolltech.com/products/qt/licenses/licensing/opensource/. ** If you are unsure which license is appropriate for your use, please ** review the following information: ** http://trolltech.com/products/qt/licenses/licensing/licensingoverview ** or contact the sales department at sales@trolltech.com. ** ** This file may be used under the terms of the Q Public License as ** defined by Trolltech ASA and appearing in the file LICENSE.QPL ** included in the packaging of this file. Licensees holding valid Qt ** Commercial licenses may use this file in accordance with the Qt ** Commercial License Agreement provided with the Software. ** ** This file is provided "AS IS" with NO WARRANTY OF ANY KIND, ** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR ** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted ** herein. ** **********************************************************************/ #include "qglobal.h" #if defined(Q_CC_BOR) // needed for qsort() because of a std namespace problem on Borland #include "qplatformdefs.h" #endif #include "qiconview.h" #ifndef QT_NO_ICONVIEW #include "qfontmetrics.h" #include "qpainter.h" #include "qevent.h" #include "qpalette.h" #include "qmime.h" #include "qimage.h" #include "qpen.h" #include "qbrush.h" #include "qtimer.h" #include "qcursor.h" #include "qapplication.h" #include "qtextedit.h" #include "qmemarray.h" #include "qptrlist.h" #include "qvbox.h" #include "qtooltip.h" #include "qbitmap.h" #include "qpixmapcache.h" #include "qptrdict.h" #include "qstringlist.h" #include "qcleanuphandler.h" #include "private/qrichtext_p.h" #include "qstyle.h" #include #include #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 QCleanupHandler qiv_cleanup_pixmap; #if !defined(Q_WS_X11) static void createSelectionPixmap( const QColorGroup &cg ) { QBitmap m( 2, 2 ); m.fill( Qt::color1 ); QPainter p( &m ); p.setPen( Qt::color0 ); for ( int j = 0; j < 2; ++j ) { p.drawPoint( j % 2, j ); } p.end(); qiv_selection = new QPixmap( 2, 2 ); qiv_cleanup_pixmap.add( &qiv_selection ); qiv_selection->fill( Qt::color0 ); qiv_selection->setMask( m ); qiv_selection->fill( cg.highlight() ); } #endif static QPixmap *get_qiv_buffer_pixmap( const QSize &s ) { if ( !qiv_buffer_pixmap ) { qiv_buffer_pixmap = new QPixmap( s ); qiv_cleanup_pixmap.add( &qiv_buffer_pixmap ); return qiv_buffer_pixmap; } qiv_buffer_pixmap->resize( s ); return qiv_buffer_pixmap; } #ifndef QT_NO_DRAGANDDROP class QM_EXPORT_ICONVIEW QIconDragData { public: QIconDragData(); QIconDragData( 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 QIconDragData &i ) const; }; class QM_EXPORT_ICONVIEW QIconDragDataItem { public: QIconDragDataItem() {} QIconDragDataItem( const QIconDragItem &i1, const QIconDragData &i2 ) : data( i1 ), item( i2 ) {} QIconDragItem data; QIconDragData item; bool operator== ( const QIconDragDataItem& ) const; }; class QIconDragPrivate { public: QValueList items; static bool decode( QMimeSource* e, QValueList &lst ); }; #endif class QIconViewToolTip; class QIconViewPrivate { public: QIconViewItem *firstItem, *lastItem; uint count; QIconView::SelectionMode selectionMode; QIconViewItem *currentItem, *tmpCurrentItem, *highlightedItem, *startDragItem, *pressedItem, *selectAnchor, *renamingItem; QRect *rubber; QPixmap *backBuffer; QTimer *scrollTimer, *adjustTimer, *updateTimer, *inputTimer, *fullRedrawTimer; int rastX, rastY, spacing; int dragItems; QPoint oldDragPos; QIconView::Arrangement arrangement; QIconView::ResizeMode resizeMode; QSize oldSize; #ifndef QT_NO_DRAGANDDROP QValueList iconDragData; #endif int numDragItems, cachedW, cachedH; int maxItemWidth, maxItemTextLength; QPoint dragStart; QString currInputString; QIconView::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; QIconViewToolTip *toolTip; QPixmapCache maskCache; QPixmap *backrubber; QPtrDict selectedItems; struct ItemContainer { ItemContainer( ItemContainer *pr, ItemContainer *nx, const QRect &r ) : p( pr ), n( nx ), rect( r ) { items.setAutoDelete( FALSE ); if ( p ) p->n = this; if ( n ) n->p = this; } ItemContainer *p, *n; QRect rect; QPtrList items; } *firstContainer, *lastContainer; struct SortableItem { QIconViewItem *item; }; public: /* finds the containers that intersect with \a searchRect in the direction \a dir relative to \a relativeTo */ QPtrList* findContainers( QIconView:: Direction dir, const QPoint &relativeTo, const QRect &searchRect ) const; // friend int cmpIconViewItems( const void *n1, const void *n2 ); }; QPtrList* QIconViewPrivate::findContainers( QIconView:: Direction dir, const QPoint &relativeTo, const QRect &searchRect ) const { QPtrList* list = new QPtrList(); if ( arrangement == QIconView::LeftToRight ) { if ( dir == QIconView::DirLeft || dir == QIconView::DirRight ) { ItemContainer *c = firstContainer; for ( ; c; c = c->n ) if ( c->rect.intersects( searchRect ) ) list->append( c ); } else { if ( dir == QIconView::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 == QIconView::DirUp || dir == QIconView::DirDown ) { ItemContainer *c = firstContainer; for ( ; c; c = c->n ) if ( c->rect.intersects( searchRect ) ) list->append( c ); } else { if ( dir == QIconView::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_TEMP 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; QIconViewPrivate::SortableItem *i1 = (QIconViewPrivate::SortableItem *)n1; QIconViewPrivate::SortableItem *i2 = (QIconViewPrivate::SortableItem *)n2; return i1->item->compare( i2->item ); } #if defined(Q_C_CALLBACKS) } #endif #ifndef QT_NO_TOOLTIP class QIconViewToolTip : public QToolTip { public: QIconViewToolTip( QWidget *parent, QIconView *iv ); virtual ~QIconViewToolTip(); void maybeTip( const QPoint &pos ); private: QIconView *view; }; QIconViewToolTip::QIconViewToolTip( QWidget *parent, QIconView *iv ) : QToolTip( parent ), view( iv ) { } QIconViewToolTip::~QIconViewToolTip() { } void QIconViewToolTip::maybeTip( const QPoint &pos ) { if ( !parentWidget() || !view || view->wordWrapIconText() || !view->showToolTips() ) return; QIconViewItem *item = view->findItem( view->viewportToContents( pos ) ); if ( !item || item->tmpText == item->itemText ) return; QRect r( item->textRect( FALSE ) ); QRect r2 = item->pixmapRect( FALSE ); /* this probably should be | r, but QToolTip does not handle that * well */ // At this point the rectangle is too small (it is the width of the icon) // since we need it to be bigger than that, extend it here. r.setWidth( view->d->fm->boundingRect( item->itemText ).width() + 4 ); r = QRect( view->contentsToViewport( QPoint( r.x(), r.y() ) ), QSize( r.width(), r.height() ) ); r2 = QRect( view->contentsToViewport( QPoint( r2.x(), r2.y() ) ), QSize( r2.width(), r2.height() ) ); tip( r2, item->itemText, r ); } #endif class QIconViewItemPrivate { public: QIconViewPrivate::ItemContainer *container1, *container2; }; #ifndef QT_NO_TEXTEDIT class QIconViewItemLineEdit : public QTextEdit { friend class QIconViewItem; public: QIconViewItemLineEdit( const QString &text, QWidget *parent, QIconViewItem *theItem, const char* name=0 ); protected: void keyPressEvent( QKeyEvent *e ); void focusOutEvent( QFocusEvent *e ); protected: QIconViewItem *item; QString startText; private: #if defined(Q_DISABLE_COPY) // Disabled copy constructor and operator= QIconViewItemLineEdit( const QIconViewItemLineEdit & ); QIconViewItemLineEdit &operator=( const QIconViewItemLineEdit & ); #endif }; QIconViewItemLineEdit::QIconViewItemLineEdit( const QString &text, QWidget *parent, QIconViewItem *theItem, const char *name ) : QTextEdit( 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() == QIconView::Bottom ? 0 : item->pixmapRect().width() ) ); document()->formatter()->setAllowBreakInWords( TRUE ); resize( 200, 200 ); // ### some size, there should be a forceReformat() setTextFormat( PlainText ); setText( text ); setAlignment( Qt::AlignCenter ); resize( wrapColumnOrWidth() + 2, heightForWidth( wrapColumnOrWidth() ) + 2 ); } void QIconViewItemLineEdit::keyPressEvent( QKeyEvent *e ) { if ( e->key() == Key_Escape ) { item->QIconViewItem::setText( startText ); item->cancelRenameItem(); } else if ( e->key() == Key_Enter || e->key() == Key_Return ) { item->renameItem(); } else { QTextEdit::keyPressEvent( e ); sync(); resize( width(), document()->height() + 2 ); } } void QIconViewItemLineEdit::focusOutEvent( QFocusEvent *e ) { Q_UNUSED(e) // I need this to get rid of a Borland warning if ( e->reason() != QFocusEvent::Popup ) item->cancelRenameItem(); } #endif #ifndef QT_NO_DRAGANDDROP /*! \class QIconDragItem qiconview.h \ingroup draganddrop \brief The QIconDragItem class encapsulates a drag item. \module iconview The QIconDrag class uses a list of QIconDragItems to support drag and drop operations. In practice a QIconDragItem object (or an object of a class derived from QIconDragItem) is created for each icon view item which is dragged. Each of these QIconDragItems is stored in a QIconDrag object. See QIconView::dragObject() for more information. See the \l fileiconview/qfileiconview.cpp and \l iconview/simple_dd/main.cpp examples. */ /*! Constructs a QIconDragItem with no data. */ QIconDragItem::QIconDragItem() : ba( (int)strlen( "no data" ) ) { memcpy( ba.data(), "no data", strlen( "no data" ) ); } /*! Destructor. */ QIconDragItem::~QIconDragItem() { } /*! Returns the data contained in the QIconDragItem. */ QByteArray QIconDragItem::data() const { return ba; } /*! Sets the data for the QIconDragItem to the data stored in the QByteArray \a d. */ void QIconDragItem::setData( const QByteArray &d ) { ba = d; } /*! \reimp */ bool QIconDragItem::operator==( const QIconDragItem &i ) const { return ba == i.ba; } /*! \reimp */ bool QIconDragDataItem::operator==( const QIconDragDataItem &i ) const { return ( i.item == item && i.data == data ); } /*! \reimp */ bool QIconDragData::operator==( const QIconDragData &i ) const { return key_ == i.key_; } /*! \class QIconDrag qiconview.h \brief The QIconDrag class supports drag and drop operations within a QIconView. \ingroup draganddrop \module iconview A QIconDrag object is used to maintain information about the positions of dragged items and the data associated with the dragged items. QIconViews are able to use this information to paint the dragged items in the correct positions. Internally QIconDrag stores the data associated with drag items in QIconDragItem objects. If you want to use the extended drag-and-drop functionality of QIconView, create a QIconDrag object in a reimplementation of QIconView::dragObject(). Then create a QIconDragItem for each item which should be dragged, set the data it represents with QIconDragItem::setData(), and add each QIconDragItem to the drag object using append(). The data in QIconDragItems is stored in a QByteArray and is mime-typed (see QMimeSource and the \link http://doc.trolltech.com/dnd.html Drag and Drop\endlink overview). If you want to use your own mime-types derive a class from QIconDrag and reimplement format(), encodedData() and canDecode(). The fileiconview example program demonstrates the use of the QIconDrag class including subclassing and reimplementing dragObject(), format(), encodedData() and canDecode(). See the files \c qt/examples/fileiconview/qfileiconview.h and \c qt/examples/fileiconview/qfileiconview.cpp. \sa QMimeSource::format() */ // ### consider using \dontinclude and friends there // ### Not here in the module overview instead... /*! 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. */ QIconDrag::QIconDrag( QWidget * dragSource, const char* name ) : QDragObject( dragSource, name ) { d = new QIconDragPrivate; } /*! Destructor. */ QIconDrag::~QIconDrag() { delete d; } /*! Append the QIconDragItem, \a i, to the QIconDrag object's list of items. You must also supply the geometry of the pixmap, \a pr, and the textual caption, \a tr. \sa QIconDragItem */ void QIconDrag::append( const QIconDragItem &i, const QRect &pr, const QRect &tr ) { d->items.append( QIconDragDataItem( i, QIconDragData( pr, tr ) ) ); } /*! \reimp */ const char* QIconDrag::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 QIconDrag::encodedData( const char* mime ) const { if ( d->items.count() <= 0 || QString( mime ) != "application/x-qiconlist" ) return QByteArray(); QValueList::ConstIterator it = d->items.begin(); QString s; for ( ; it != d->items.end(); ++it ) { QString k( "%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( (*it).data.data() ) + "$@@$"; s += k; } QByteArray a( s.length() + 1 ); memcpy( a.data(), s.latin1(), a.size() ); return a; } /*! Returns TRUE if \a e can be decoded by the QIconDrag, otherwise return FALSE. */ bool QIconDrag::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 QIconDragPrivate::decode( QMimeSource* e, QValueList &lst ) { QByteArray ba = e->encodedData( "application/x-qiconlist" ); if ( ba.size() ) { lst.clear(); QString s = ba.data(); QIconDragDataItem item; QRect ir, tr; QStringList l = QStringList::split( "$@@$", 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( ( *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; } QIconDragData::QIconDragData() : iconRect_(), textRect_() { } QIconDragData::QIconDragData( const QRect &ir, const QRect &tr ) : iconRect_( ir ), textRect_( tr ) { } QRect QIconDragData::textRect() const { return textRect_; } QRect QIconDragData::pixmapRect() const { return iconRect_; } void QIconDragData::setPixmapRect( const QRect &r ) { iconRect_ = r; } void QIconDragData::setTextRect( const QRect &r ) { textRect_ = r; } #endif /*! \class QIconViewItem qiconview.h \brief The QIconViewItem class provides a single item in a QIconView. \ingroup advanced \module iconview A QIconViewItem contains an icon, a string and optionally a sort key, and can display itself in a QIconView. The class is designed to be very similar to QListView and QListBox in use, both via instantiation and subclassing. The simplest way to create a QIconViewItem and insert it into a QIconView is to construct the item passing the constructor a pointer to the icon view, a string and an icon: \code (void) new QIconViewItem( iconView, // A pointer to a QIconView "This is the text of the item", aPixmap ); \endcode 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 QIconView::firstItem() and QIconViewItem::nextItem() functions provide a means of iterating over all the items in a QIconView: \code QIconViewItem *item; for ( item = iconView->firstItem(); item; item = item->nextItem() ) do_something_with( item ); \endcode 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 QIconViewItem 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. \target pixmap-size-limit Note: Pixmaps with individual dimensions larger than 300 pixels may not be displayed properly, depending on the \link QIconView::Arrangement arrangement in use\endlink. For example, pixmaps wider than 300 pixels will not be arranged correctly if the icon view uses a \l QIconView::TopToBottom arrangement, and pixmaps taller than 300 pixels will not be arranged correctly if the icon view uses a \l QIconView::LeftToRight arrangement. */ /*! Constructs a QIconViewItem and inserts it into icon view \a parent with no text and a default icon. */ QIconViewItem::QIconViewItem( QIconView *parent ) : view( parent ), itemText(), itemIcon( unknown_icon ) { init(); } /*! Constructs a QIconViewItem and inserts it into the icon view \a parent with no text and a default icon, after the icon view item \a after. */ QIconViewItem::QIconViewItem( QIconView *parent, QIconViewItem *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. */ QIconViewItem::QIconViewItem( QIconView *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. */ QIconViewItem::QIconViewItem( QIconView *parent, QIconViewItem *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. */ QIconViewItem::QIconViewItem( QIconView *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. \sa setPixmap() */ QIconViewItem::QIconViewItem( QIconView *parent, QIconViewItem *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 QIconViewItem::QIconViewItem( QIconView *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. */ QIconViewItem::QIconViewItem( QIconView *parent, QIconViewItem *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 QIconViewItem::init( QIconViewItem *after #ifndef QT_NO_PICTURE , QPicture *pic #endif ) { d = new QIconViewItemPrivate; d->container1 = 0; d->container2 = 0; prev = next = 0; allow_rename = FALSE; allow_drag = TRUE; allow_drop = TRUE; visible = 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. */ QIconViewItem::~QIconViewItem() { #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 QIconViewItem::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 QIconViewItem::rtti() const { return RTTI; } /*! If \a b is TRUE, the item is made visible; otherwise it is hidden. */ void QIconViewItem::setVisible( bool b ) { if ( b == (bool)visible ) return; QIconView *iv = iconView(); if ( !iv ) return; visible = b; if ( iv ) iv->updateContents(); } /*! Returns TRUE if the item is visible; otherwise returns FALSE. \sa setVisible() */ bool QIconViewItem::isVisible() const { return (bool)visible; } /*! 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 QIconViewItem::setText( const QString &text ) { if ( text == itemText ) return; wordWrapDirty = TRUE; itemText = text; if ( itemKey.isEmpty() ) itemKey = itemText; QRect oR = rect(); calcRect(); oR = oR.unite( 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, FALSE ); } } /*! Sets \a k as the sort key of the icon view item. By default text() is used for sorting. \sa compare() */ void QIconViewItem::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(). Note: Pixmaps with individual dimensions larger than 300 pixels may not be displayed properly, depending on the \link QIconView::Arrangement arrangement in use\endlink. See the \link #pixmap-size-limit main class documentation\endlink for details. \sa pixmap() */ void QIconViewItem::setPixmap( const QPixmap &icon ) { if (isVisible() == FALSE) return; if ( itemIcon && itemIcon == unknown_icon ) itemIcon = 0; if ( itemIcon ) *itemIcon = icon; else itemIcon = new QPixmap( icon ); QRect oR = rect(); calcRect(); oR = oR.unite( 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, FALSE ); } } /*! 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 QIconViewItem::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.unite( 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, FALSE ); } } #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 QIconViewItem::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. Note: Pixmaps with individual dimensions larger than 300 pixels may not be displayed properly, depending on the \link QIconView::Arrangement arrangement in use\endlink. See the \link #pixmap-size-limit main class documentation\endlink for details. \sa pixmap() */ void QIconViewItem::setPixmap( const QPixmap &icon, bool recalc, bool redraw ) { if (isVisible() == FALSE) return; 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.unite( 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, FALSE ); } } 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 QIconViewItem::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 QIconViewItem::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 QIconViewItem::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 QIconViewItem, 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 QIconViewItem::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 QIconViewItem::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 QIconViewItem, 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 *QIconViewItem::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 QIconViewItem, 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 *QIconViewItem::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 QIconViewItem::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 QIconViewItem::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 QIconViewItem::dropEnabled() const { return (bool)allow_drop; } /*! Returns a pointer to this item's icon view parent. */ QIconView *QIconViewItem::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() QIconView::firstItem() */ QIconViewItem *QIconViewItem::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 QIconView::firstItem(). Example: \code QIconViewItem *item; for ( item = iconView->firstItem(); item; item = item->nextItem() ) do_something_with( item ); \endcode \sa prevItem() */ QIconViewItem *QIconViewItem::nextItem() const { return next; } /*! Returns the index of this item in the icon view, or -1 if an error occurred. */ int QIconViewItem::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 QIconViewItem::setSelected( bool s ) { setSelected( s, FALSE ); } /*! Selects or unselects the item, depending on \a s; it may also unselect other items, depending on QIconView::selectionMode() and \a cb. If \a s is FALSE, the item is unselected. If \a s is TRUE and QIconView::selectionMode() is \c Single, the item is selected and the item previously selected is unselected. If \a s is TRUE and QIconView::selectionMode() is \c 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 QIconView::selectionMode() is \c Multi, the item is selected. Note that \a cb is used only if QIconView::selectionMode() is \c Extended; cb defaults to FALSE. All items whose selection status changes repaint themselves. */ void QIconViewItem::setSelected( bool s, bool cb ) { if ( !view ) return; if ( view->selectionMode() != QIconView::NoSelection && selectable && s != (bool)selected ) { if ( view->d->selectionMode == QIconView::Single && this != view->d->currentItem ) { QIconViewItem *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 == QIconView::Single && view->d->currentItem ) { view->d->currentItem->selected = FALSE; } if ( ( view->d->selectionMode == QIconView::Extended && !cb ) || view->d->selectionMode == QIconView::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 == QIconView::Single && s; QIconView *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 QIconViewItem::setSelectable( bool enable ) { selectable = (uint)enable; } /*! Returns TRUE if the item is selected; otherwise returns FALSE. \sa setSelected() */ bool QIconViewItem::isSelected() const { return (bool)selected; } /*! Returns TRUE if the item is selectable; otherwise returns FALSE. \sa setSelectable() */ bool QIconViewItem::isSelectable() const { return (bool)selectable; } /*! Repaints the item. */ void QIconViewItem::repaint() { if ( view ) view->repaintItem( this ); } /*! Moves the item to position (\a x, \a y) in the icon view (these are contents coordinates). */ bool QIconViewItem::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 QIconViewItem::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 QIconViewItem::move( const QPoint &pnt ) { return move( pnt.x(), pnt.y() ); } /*! \overload Moves the item by the x, y values in point \a pnt. */ void QIconViewItem::moveBy( const QPoint &pnt ) { moveBy( pnt.x(), pnt.y() ); } /*! Returns the bounding rectangle of the item (in contents coordinates). */ QRect QIconViewItem::rect() const { return itemRect; } /*! Returns the x-coordinate of the item (in contents coordinates). */ int QIconViewItem::x() const { return itemRect.x(); } /*! Returns the y-coordinate of the item (in contents coordinates). */ int QIconViewItem::y() const { return itemRect.y(); } /*! Returns the width of the item. */ int QIconViewItem::width() const { return QMAX( itemRect.width(), QApplication::globalStrut().width() ); } /*! Returns the height of the item. */ int QIconViewItem::height() const { return QMAX( itemRect.height(), QApplication::globalStrut().height() ); } /*! Returns the size of the item. */ QSize QIconViewItem::size() const { return QSize( itemRect.width(), itemRect.height() ); } /*! Returns the position of the item (in contents coordinates). */ QPoint QIconViewItem::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 QIconViewItem::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 QIconViewItem::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 QIconViewItem::contains( const QPoint& pnt ) const { QRect textArea = textRect( FALSE ); QRect pixmapArea = pixmapRect( FALSE ); if ( iconView()->itemTextPos() == QIconView::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 QIconViewItem::intersects( const QRect& r ) const { return ( textRect( FALSE ).intersects( r ) || pixmapRect( FALSE ).intersects( r ) ); } /*! \fn bool QIconViewItem::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 QIconViewItem and reimplement acceptDrop() to accept drops. */ bool QIconViewItem::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 QIconView::itemRenamed() will be emitted (unless the user canceled, e.g. by pressing the Escape key). \sa setRenameEnabled() */ void QIconViewItem::rename() { if ( !view ) return; if ( renameBox ) removeRenameBox(); oldRect = rect(); renameBox = new QIconViewItemLineEdit( 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: \code int MyIconViewItem::compare( QIconViewItem *i ) const { return key().compare( i->key() ); } \endcode \sa key() QString::localeAwareCompare() QString::compare() */ int QIconViewItem::compare( QIconViewItem *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 QIconViewItem::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, FALSE ); view->repaintContents( r.x() - 1, r.y() - 1, r.width() + 2, r.height() + 2, FALSE ); removeRenameBox(); view->emitRenamed( this ); } /*! Cancels in-place renaming. */ void QIconViewItem::cancelRenameItem() { if ( !view ) return; QRect r = itemRect; calcRect(); view->repaintContents( oldRect.x() - 1, oldRect.y() - 1, oldRect.width() + 2, oldRect.height() + 2, FALSE ); view->repaintContents( r.x() - 1, r.y() - 1, r.width() + 2, r.height() + 2, FALSE ); if ( !renameBox ) return; removeRenameBox(); } /*! Removes the editbox that is used for in-place renaming. */ void QIconViewItem::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 QString::null. */ void QIconViewItem::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() == QIconView::Bottom ? 0 : pixmapRect().width() ), 0xFFFFFFFF, AlignHCenter | WordBreak | 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() == QIconView::Bottom ? 0 : pixmapRect().width() ) ) r.setWidth( iconView()->maxItemWidth() - ( iconView()->itemTextPos() == QIconView::Bottom ? 0 : pixmapRect().width() ) ); tw = r.width(); th = r.height(); if ( tw < view->d->fm->width( "X" ) ) tw = view->d->fm->width( "X" ); itemTextRect.setWidth( tw ); itemTextRect.setHeight( th ); int w = 0; int h = 0; if ( view->itemTextPos() == QIconView::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 QIconViewItem::paintItem() with the changed values. */ void QIconViewItem::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->setBrush( QBrush( cg.highlight(), QBrush::Dense4Pattern ) ); p->setPen( QPen( cg.highlight(), QBrush::Dense4Pattern ) ); p->drawRoundRect( pixmapRect( FALSE ), 1000 / pixmapRect( FALSE ).width(), 1000 / pixmapRect( FALSE ).height() ); } p->drawPicture( x()-pic->boundingRect().x(), y()-pic->boundingRect().y(), *pic ); if ( isSelected() ) { p->setBrush( QBrush( cg.highlight() ) ); p->setPen( QPen( cg.highlight() ) ); p->drawRoundRect( textRect( FALSE ), 1000 / textRect( FALSE ).width(), 1000 / textRect( FALSE ).height() ); p->setPen( QPen( cg.highlightedText() ) ); } else if ( view->d->itemTextBrush != NoBrush ) { p->setBrush( view->d->itemTextBrush ); p->setPen( QPen( view->d->itemTextBrush.color() ) ); p->drawRoundRect( textRect( FALSE ), 1000 / textRect( FALSE ).width(), 1000 / textRect( FALSE ).height() ); } int align = view->itemTextPos() == QIconView::Bottom ? AlignHCenter : AlignAuto; if ( view->d->wordWrapIconText ) align |= WordBreak | BreakAnywhere; p->drawText( textRect( FALSE ), align, view->d->wordWrapIconText ? itemText : tmpText ); p->restore(); return; } #endif bool textOnBottom = ( view->itemTextPos() == QIconView::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(), white ); p2.drawPixmap( 0, 0, *pix ); p2.end(); buffer->setMask( mask ); p2.begin( buffer ); #if defined(Q_WS_X11) p2.fillRect( pix->rect(), QBrush( cg.highlight(), QBrush::Dense4Pattern) ); #else // in WIN32 Dense4Pattern doesn't work correctly (transparency problem), so work around it if ( iconView()->d->drawActiveSelection ) { if ( !qiv_selection ) createSelectionPixmap( cg ); p2.drawTiledPixmap( 0, 0, pix->width(), pix->height(), *qiv_selection ); } #endif p2.end(); 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->setBrush( QBrush( cg.highlight() ) ); p->setPen( QPen( cg.highlight() ) ); p->drawRoundRect( textRect( FALSE ), 1000 / textRect( FALSE ).width(), 1000 / textRect( FALSE ).height() ); p->setPen( QPen( cg.highlightedText() ) ); } else if ( view->d->itemTextBrush != NoBrush ) { p->setBrush( view->d->itemTextBrush ); p->setPen( QPen( view->d->itemTextBrush.color() ) ); p->drawRoundRect( textRect( FALSE ), 1000 / textRect( FALSE ).width(), 1000 / textRect( FALSE ).height() ); } int align = AlignHCenter; if ( view->d->wordWrapIconText ) align |= WordBreak | 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. The default implementation does nothing; subclasses may reimplement this function. */ void QIconViewItem::paintFocus( QPainter *, const QColorGroup & ) { } /*! \fn void QIconViewItem::dropped( QDropEvent *e, const QValueList &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 QIconDrag, \a lst contains the list of the dropped items. You can get the data by calling QIconDragItem::data() on each item. If the \a lst is empty, i.e. the drag was not a QIconDrag, you must decode the data in \a e and work with that. The default implementation does nothing; subclasses may reimplement this function. */ #ifndef QT_NO_DRAGANDDROP void QIconViewItem::dropped( QDropEvent *, const QValueList & ) { } #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 QIconViewItem::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 QIconViewItem::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 QIconViewItem::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 QIconViewItem::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 QIconViewItem::setPixmapRect( const QRect &r ) { itemIconRect = r; if ( view ) view->updateItemContainer( this ); } /*! \internal */ void QIconViewItem::calcTmpText() { if ( !view || view->d->wordWrapIconText || !wordWrapDirty ) return; wordWrapDirty = FALSE; int w = iconView()->maxItemWidth() - ( iconView()->itemTextPos() == QIconView::Bottom ? 0 : pixmapRect().width() ); if ( view->d->fm->width( itemText ) < w ) { tmpText = itemText; return; } tmpText = "..."; int i = 0; while ( view->d->fm->width( tmpText + itemText[ i ] ) < w ) tmpText += itemText[ i++ ]; tmpText.remove( (uint)0, 3 ); tmpText += "..."; } /*! \internal */ QString QIconViewItem::tempText() const { return tmpText; } void QIconViewItem::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 ); } /*! \file iconview/simple_dd/main.h */ /*! \file iconview/simple_dd/main.cpp */ /*! \class QIconView qiconview.h \brief The QIconView class provides an area with movable labelled icons. \module iconview \ingroup advanced \mainclass A QIconView can display and manage a grid or other 2D layout of labelled icons. Each labelled icon is a QIconViewItem. Items (QIconViewItems) can be added or deleted at any time; items can be moved within the QIconView. Single or multiple items can be selected. Items can be renamed in-place. QIconView 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 QIconView is to create a QIconView object and create some QIconViewItems with the QIconView as their parent, set the icon view's geometry and show it. For example: \code QIconView *iv = new QIconView( this ); QDir dir( path, "*.xpm" ); for ( uint i = 0; i < dir.count(); i++ ) { (void) new QIconViewItem( iv, dir[i], QPixmap( path + dir[i] ) ); } iv->resize( 600, 400 ); iv->show(); \endcode The QIconViewItem call passes a pointer to the QIconView we wish to populate, along with the label text and a QPixmap. When an item is inserted the QIconView allocates a position for it. Existing items are rearranged if autoArrange() is TRUE. The default arrangement is \c LeftToRight -- the QIconView 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 \c 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 QIconViewItem 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 QIconView 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 QIconViewItem::isSelectable() selectable\endlink may be selected depending on the SelectionMode; the default is \c Single. Because QIconView 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 QIconViewItem::setKey() the new text will also serve as the key. (See QIconViewItem::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 QIconViewItem::nextItem()) from each \e item in turn: \code for ( QIconViewItem *item = iv->firstItem(); item; item = item->nextItem() ) do_something( item ); \endcode QIconView 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 QIconView emits a wide range of useful signals, including selectionChanged(), currentChanged(), clicked(), moved() and itemRenamed(). \target draganddrop \section1 Drag and Drop QIconView supports the drag and drop of items within the QIconView itself. It also supports the drag and drop of items out of or into the QIconView and drag and drop onto items themselves. The drag and drop of items outside the QIconView 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 QIconView and reimplement QIconView::dragObject(). \code QDragObject *MyIconView::dragObject() { return new QTextDrag( currentItem()->text(), this ); } \endcode In this example we create a QTextDrag object, (derived from QDragObject), containing the item's label and return it as the drag object. We could just as easily have created a QImageDrag from the item's pixmap and returned that instead. QIconViews and their QIconViewItems can also be the targets of drag and drops. To make the QIconView itself able to accept drops connect to the dropped() signal. When a drop occurs this signal will be emitted with a QDragEvent and a QValueList of QIconDragItems. To make a QIconViewItem into a drop target subclass QIconViewItem and reimplement QIconViewItem::acceptDrop() and QIconViewItem::dropped(). \code bool MyIconViewItem::acceptDrop( const QMimeSource *mime ) const { if ( mime->provides( "text/plain" ) ) return TRUE; return FALSE; } void MyIconViewItem::dropped( QDropEvent *evt, const QValueList& ) { QString label; if ( QTextDrag::decode( evt, label ) ) setText( label ); } \endcode See \l iconview/simple_dd/main.h and \l iconview/simple_dd/main.cpp for a simple drag and drop example which demonstrates drag and drop between a QIconView and a QListBox. 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 QIconDrag (or a class derived from it) for the drag object. In dragObject() create the drag object, populate it with QIconDragItems 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 QIconDragItem for each selected item, and append these items with QIconDrag::append() to the QIconDrag object. You can use QIconDragItem::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 QIconDrag, 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 QIconViewItem::acceptDrop() and QIconViewItem::dropped(). If you've used a QIconDrag (or a subclass of it) the second argument to the dropped signal contains a QValueList of QIconDragItems -- you can access their data by calling QIconDragItem::data() on each one. For an example implementation of complex drag-and-drop look at the fileiconview example (qt/examples/fileiconview). \sa QIconViewItem::setDragEnabled(), QIconViewItem::setDropEnabled(), QIconViewItem::acceptDrop(), QIconViewItem::dropped(). */ /*! \enum QIconView::ResizeMode This enum type is used to tell QIconView 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 QIconView::SelectionMode This enumerated type is used by QIconView 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 QIconView::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. Also, multiple items can be selected by dragging the mouse while the left mouse button stays pressed. \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 summarise: \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 QIconView::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 cause the viewport to extend vertically (you get a vertical scrollbar). \value TopToBottom Items which don't fit into the view cause the viewport to extend horizontally (you get a horizontal scrollbar). */ /*! \enum QIconView::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 QIconView::dropped ( QDropEvent * e, const QValueList &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 QIconDrag, \a lst contains the list of the dropped items. You can get the data using QIconDragItem::data() on each item. If the \a lst is empty, i.e. the drag was not a QIconDrag, you have to decode the data in \a e and work with that. Note QIconViewItems may be drop targets; if a drop event occurs on an item the item handles the drop. */ /*! \fn void QIconView::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 QIconView::doubleClicked(QIconViewItem * item) This signal is emitted when the user double-clicks on \a item. */ /*! \fn void QIconView::returnPressed (QIconViewItem * 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 QIconView::selectionChanged() This signal is emitted when the selection has been changed. It's emitted in each selection mode. */ /*! \overload void QIconView::selectionChanged( QIconViewItem *item ) 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 QIconView::currentChanged( QIconViewItem *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 QIconView::onItem( QIconViewItem *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 QIconView::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() */ /*! \overload void QIconView::itemRenamed (QIconViewItem * item) This signal is emitted when \a item has been renamed, usually by in-place renaming. \sa QIconViewItem::setRenameEnabled() QIconViewItem::rename() */ /*! \fn void QIconView::itemRenamed (QIconViewItem * item, const QString &name) This signal is emitted when \a item has been renamed to \a name, usually by in-place renaming. \sa QIconViewItem::setRenameEnabled() QIconViewItem::rename() */ /*! \fn void QIconView::rightButtonClicked (QIconViewItem * 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 QIconView::contextMenuRequested( QIconViewItem *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 QIconView::mouseButtonPressed (int button, QIconViewItem * 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() mouseButtonPressed() pressed() */ /*! \fn void QIconView::mouseButtonClicked (int button, QIconViewItem * 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() */ /*! \overload void QIconView::clicked ( QIconViewItem * item, const QPoint & pos ) 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() */ /*! \overload void QIconView::pressed ( QIconViewItem * item, const QPoint & pos ) 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 QIconView::clicked ( QIconViewItem * 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 QIconView::pressed ( QIconViewItem * 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 QIconView::rightButtonPressed( QIconViewItem * 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. */ QIconView::QIconView( QWidget *parent, const char *name, WFlags f ) : QScrollView( parent, name, WStaticContents | WNoAutoErase | f ) { if ( !unknown_icon ) { unknown_icon = new QPixmap( (const char **)unknown_xpm ); qiv_cleanup_pixmap.add( &unknown_icon ); } d = new QIconViewPrivate; 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->backBuffer = 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 = QString::null; d->dirty = FALSE; d->rearrangeEnabled = TRUE; d->itemTextPos = Bottom; d->reorderItemsWhenInsert = TRUE; #ifndef QT_NO_CURSOR d->oldCursor = 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 = 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; d->backrubber = 0; 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()->setBackgroundMode( PaletteBase); setBackgroundMode( PaletteBackground, PaletteBase ); viewport()->setFocusProxy( this ); viewport()->setFocusPolicy( QWidget::WheelFocus ); #ifndef QT_NO_TOOLTIP d->toolTip = new QIconViewToolTip( viewport(), this ); #endif d->showTips = TRUE; } /*! \reimp */ void QIconView::styleChange( QStyle& old ) { QScrollView::styleChange( old ); *d->fm = QFontMetrics( font() ); d->minLeftBearing = d->fm->minLeftBearing(); d->minRightBearing = d->fm->minRightBearing(); QIconViewItem *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 } /*! \reimp */ void QIconView::setFont( const QFont & f ) { QScrollView::setFont( f ); *d->fm = QFontMetrics( font() ); d->minLeftBearing = d->fm->minLeftBearing(); d->minRightBearing = d->fm->minRightBearing(); QIconViewItem *item = d->firstItem; for ( ; item; item = item->next ) { item->wordWrapDirty = TRUE; item->calcRect(); } } /*! \reimp */ void QIconView::setPalette( const QPalette & p ) { QScrollView::setPalette( p ); *d->fm = QFontMetrics( font() ); d->minLeftBearing = d->fm->minLeftBearing(); d->minRightBearing = d->fm->minRightBearing(); QIconViewItem *item = d->firstItem; for ( ; item; item = item->next ) { item->wordWrapDirty = TRUE; item->calcRect(); } } /*! Destroys the icon view and deletes all items. */ QIconView::~QIconView() { QIconViewItem *tmp, *item = d->firstItem; d->clearing = TRUE; QIconViewPrivate::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->backBuffer; d->backBuffer = 0; delete d->fm; d->fm = 0; #ifndef QT_NO_TOOLTIP delete d->toolTip; d->toolTip = 0; #endif 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 QIconViewItem's and associate them with your icon view like this: \code (void) new QIconViewItem( myIconview, "The text of the item", aPixmap ); \endcode */ void QIconView::insertItem( QIconViewItem *item, QIconViewItem *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 { QIconViewItem *i = d->firstItem; while ( i != after ) i = i->next; if ( i ) { QIconViewItem *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 QIconView::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; QIconViewItem *item = d->firstItem; int w = 0, h = 0; while ( item ) { bool changed; QIconViewItem *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( FALSE ); } 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 QIconViewItem::~QIconViewItem() calls it. The normal way to delete an item is to delete it. */ void QIconView::takeItem( QIconViewItem *item ) { if ( !item ) return; if ( item->d->container1 ) item->d->container1->items.removeRef( item ); if ( item->d->container2 ) item->d->container2->items.removeRef( 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 { QIconViewItem *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(), TRUE ); 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 QIconView::index( const QIconViewItem *item ) const { if ( !item ) return -1; if ( item == d->firstItem ) return 0; else if ( item == d->lastItem ) return d->count - 1; else { QIconViewItem *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() */ QIconViewItem *QIconView::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() */ QIconViewItem *QIconView::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() */ QIconViewItem *QIconView::currentItem() const { return d->currentItem; } /*! Makes \a item the new current item of the icon view. */ void QIconView::setCurrentItem( QIconViewItem *item ) { if ( !item || item == d->currentItem ) return; setMicroFocusHint( item->x(), item->y(), item->width(), item->height(), FALSE ); QIconViewItem *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 QIconView::selectionMode() and \a cb. If \a s is FALSE, \a item is unselected. If \a s is TRUE and QIconView::selectionMode() is \c Single, \a item is selected, and the item which was selected is unselected. If \a s is TRUE and QIconView::selectionMode() is \c 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 QIconView::selectionMode() is \c Multi \a item is selected. Note that \a cb is used only if QIconView::selectionMode() is \c Extended. \a cb defaults to FALSE. All items whose selection status is changed repaint themselves. */ void QIconView::setSelected( QIconViewItem *item, bool s, bool cb ) { if ( !item ) return; item->setSelected( s, cb ); } /*! \property QIconView::count \brief the number of items in the icon view */ uint QIconView::count() const { return d->count; } /*! Performs autoscrolling when selecting multiple icons with the rubber band. */ void QIconView::doAutoScroll() { QRect oldRubber = *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; blockSignals( TRUE ); viewport()->setUpdatesEnabled( FALSE ); bool alreadyIntersected = FALSE; QRect nr = d->rubber->normalize(); QRect rubberUnion = nr.unite( oldRubber.normalize() ); QIconViewPrivate::ItemContainer *c = d->firstContainer; for ( ; c; c = c->n ) { if ( c->rect.intersects( rubberUnion ) ) { alreadyIntersected = TRUE; QIconViewItem *item = c->items.first(); for ( ; item; item = c->items.next() ) { if ( d->selectedItems.find( item ) ) continue; if ( !item->intersects( nr ) ) { if ( item->isSelected() ) { item->setSelected( FALSE ); changed = TRUE; rr = rr.unite( item->rect() ); } } else if ( item->intersects( nr ) ) { if ( !item->isSelected() && item->isSelectable() ) { item->setSelected( TRUE, TRUE ); changed = TRUE; rr = rr.unite( item->rect() ); } 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 ); // static bool drawAll; if ( d->backrubber == 0 ) { d->backrubber = new QPixmap( viewport()->rect().size() ); d->backrubber->fill( viewport(), viewport()->rect().topLeft() ); // drawAll = true; } // int oldX = 0, oldY = 0; // if ( !drawAll && d->scrollTimer ) { // oldX = contentsX(); // oldY = contentsY(); // } ensureVisible( pos.x(), pos.y() ); // if ( !drawAll && d->scrollTimer && ( oldX != contentsX() || oldY != contentsY() ) ) // drawAll = true; QRect allRect = oldRubber.normalize(); if ( changed ) allRect |= rr.normalize(); allRect |= d->rubber->normalize(); QPoint point = contentsToViewport( allRect.topLeft() ); allRect = QRect( point.x(), point.y(), allRect.width(), allRect.height() ); allRect &= viewport()->rect(); d->dragging = FALSE; QPainter p( d->backrubber ); p.translate( -contentsX(), -contentsY() ); #if 0 if ( !drawAll ) { oldRubber = oldRubber.normalize(); point = contentsToViewport( oldRubber.topLeft() ); oldRubber = QRect( point.x(), point.y(), oldRubber.width(), oldRubber.height() ); oldRubber &= viewport()->rect(); point = contentsToViewport( nr.topLeft() ); nr = QRect( point.x(), point.y(), nr.width(), nr.height() ); nr &= viewport()->rect(); QRegion region; if ( allRect != nr ) region = QRegion(allRect).subtract( QRegion( nr ) ); if ( allRect != oldRubber ) region += QRegion(allRect).subtract( QRegion( oldRubber ) ); QMemArray< QRect > ar = region.rects(); for ( uint i = 0; i < ar.size(); ++i ) { ar[i].addCoords( -2, -2, 4, 4 ); ar[i] = ar[i].normalize(); p.setClipRect( ar[i] ); drawContents( &p, contentsX() + ar[i].left(), contentsY() + ar[i].top(), ar[i].width(), ar[i].height() ); } } else #endif { drawContents( &p, contentsX() + allRect.left(), contentsY() + allRect.top(), allRect.width(), allRect.height() ); } p.end(); // drawAll = false; d->dragging = TRUE; bitBlt( viewport(), allRect.topLeft(), d->backrubber, allRect ); 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 QIconView::drawContents( QPainter *p, int cx, int cy, int cw, int ch ) { p->save(); QRect r = QRect( cx, cy, cw, ch ); QIconViewPrivate::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.intersect( 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.intersect( r3 ); p->setClipRegion( reg ); } drawBackground( p, r3 ); remaining = remaining.subtract( r3 ); p->restore(); QColorGroup cg; d->drawActiveSelection = hasFocus() || d->inMenuMode || !style().styleHint( QStyle::SH_ItemView_ChangeHighlightOnFocus, this ); if ( !d->drawActiveSelection ) cg = palette().inactive(); else cg = colorGroup(); QIconViewItem *item = c->items.first(); // 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 it's // paintItem() implementation, which makes this useless p->setClipRect( QRect( contentsToViewport( r2.topLeft() ), r2.size() ) ); for ( ; item; item = c->items.next() ) { if ( item->rect().intersects( r ) && !item->dirty ) { p->save(); p->setFont( font() ); item->paintItem( p, cg ); p->restore(); } } alreadyIntersected = TRUE; } else { if ( alreadyIntersected ) break; } c = c->n; } if ( !remaining.isNull() && !remaining.isEmpty() ) { p->save(); p->resetXForm(); if ( d->drawAllBack ) { p->setClipRegion( remaining ); } else { remaining = d->clipRegion.intersect( 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, colorGroup() ); } p->restore(); if ( d->rubber ) { p->save(); p->translate( contentsX(), contentsY() ); p->setRasterOp( NotROP ); p->setPen( QPen( color0, 1 ) ); p->setBrush( NoBrush ); drawRubber( p ); p->restore(); } } /*! \overload Arranges all the items in the grid given 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 QIconView::setGridX(), QIconView::setGridY(), QIconView::sort() */ void QIconView::arrangeItemsInGrid( bool update ) { if ( !d->firstItem || !d->lastItem ) return; d->containerUpdateLocked = TRUE; int w = 0, h = 0, y = d->spacing; QIconViewItem *item = d->firstItem; while (item && (item->isVisible() == FALSE)) { item = item->next; } bool changedLayout = FALSE; while ( item ) { bool changed; QIconViewItem *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; while (item && (item->isVisible() == FALSE)) { item = item->next; } } if ( d->lastItem && d->arrangement == TopToBottom ) { item = d->lastItem; while (item && (item->isVisible() == FALSE)) { item = item->prev; } int x = 0; if (item) 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; while (item && (item->isVisible() == FALSE)) { item = item->prev; } } } d->containerUpdateLocked = FALSE; QIconViewItem *lastVisibleItem = d->lastItem; while (lastVisibleItem->prev && (lastVisibleItem->isVisible() == FALSE)) { lastVisibleItem = lastVisibleItem->prev; } w = QMAX( QMAX( d->cachedW, w ), lastVisibleItem->x() + lastVisibleItem->width() ); h = QMAX( QMAX( d->cachedH, h ), lastVisibleItem->y() + lastVisibleItem->height() ); if ( d->arrangement == TopToBottom ) w += d->spacing; else h += d->spacing; bool ue = isUpdatesEnabled(); 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 (scrollbar show/hide), redo layout again arrangeItemsInGrid( FALSE ); viewport()->setUpdatesEnabled( ue ); d->dirty = !isVisible(); rebuildContainers(); if ( update && ( !optimize_layout || changedLayout ) ) repaintContents( contentsX(), contentsY(), viewport()->width(), viewport()->height(), FALSE ); } /*! 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 QIconView::arrangeItemsInGrid( const QSize &grid, bool update ) { d->containerUpdateLocked = TRUE; QSize grid_( grid ); if ( !grid_.isValid() ) { int w = 0, h = 0; QIconViewItem *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; QIconViewItem *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(), FALSE ); } /*! \reimp */ void QIconView::setContentsPos( int x, int y ) { if ( d->updateTimer->isActive() ) { d->cachedContentsX = x; d->cachedContentsY = y; } else { d->cachedContentsY = d->cachedContentsX = -1; QScrollView::setContentsPos( x, y ); } } /*! \reimp */ void QIconView::showEvent( QShowEvent * ) { if ( d->dirty ) { resizeContents( QMAX( contentsWidth(), viewport()->width() ), QMAX( contentsHeight(), viewport()->height() ) ); if ( d->resortItemsWhenInsert ) sort( d->sortDirection ); if ( autoArrange() ) arrangeItemsInGrid( FALSE ); } QScrollView::show(); } /*! \property QIconView::selectionMode \brief the selection mode of the icon view This can be \c Single (the default), \c Extended, \c Multi or \c NoSelection. */ void QIconView::setSelectionMode( SelectionMode m ) { d->selectionMode = m; } QIconView::SelectionMode QIconView::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. */ QIconViewItem *QIconView::findItem( const QPoint &pos ) const { if ( !d->firstItem ) return 0; QIconViewPrivate::ItemContainer *c = d->lastContainer; for ( ; c; c = c->p ) { if ( c->rect.contains( pos ) ) { QIconViewItem *item = c->items.last(); for ( ; item; item = c->items.prev() ) if ( item->contains( pos ) ) return item; } } 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 behaviour. (See \l {Qt::StringComparisonMode}.) */ QIconViewItem *QIconView::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.lower(); QIconViewItem *item; if ( d->currentItem ) item = d->currentItem; else item = d->firstItem; QIconViewItem *beginsWithItem = 0; QIconViewItem *endsWithItem = 0; QIconViewItem *containsItem = 0; if ( item ) { for ( ; item; item = item->next ) { if ( ! (compare & CaseSensitive) ) itmtxt = item->text().lower(); else itmtxt = item->text(); if ( compare & 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 & Contains && !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().lower(); else itmtxt = item->text(); if ( compare & 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 & Contains && !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 QIconView::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 QIconView::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 ); QIconViewItem *item = d->firstItem; QIconViewItem *i = d->currentItem; bool changed = FALSE; bool ue = viewport()->isUpdatesEnabled(); viewport()->setUpdatesEnabled( FALSE ); QRect rr; for ( ; item; item = item->next ) { if (item->isVisible()) { if ( select != item->isSelected() ) { item->setSelected( select, TRUE ); rr = rr.unite( item->rect() ); changed = TRUE; } else { if ( FALSE != item->isSelected() ) { item->setSelected( FALSE, TRUE ); changed = TRUE; } } } } viewport()->setUpdatesEnabled( ue ); // we call updateContents not repaintContents because of possible previous updateContents QScrollView::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 QIconView::invertSelection() { if ( d->selectionMode == Single || d->selectionMode == NoSelection ) return; bool b = signalsBlocked(); blockSignals( TRUE ); QIconViewItem *item = d->firstItem; for ( ; item; item = item->next ) item->setSelected( !item->isSelected(), TRUE ); blockSignals( b ); emit selectionChanged(); } /*! Repaints the \a item. */ void QIconView::repaintItem( QIconViewItem *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, FALSE ); } /*! Repaints the selected items. */ void QIconView::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 QIconViewItem *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 QIconView::ensureItemVisible( QIconViewItem *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 QIconViewItem::rect() for each of these items. \sa findLastVisibleItem() QIconViewItem::rect() */ QIconViewItem* QIconView::findFirstVisibleItem( const QRect &r ) const { QIconViewPrivate::ItemContainer *c = d->firstContainer; QIconViewItem *i = 0; bool alreadyIntersected = FALSE; for ( ; c; c = c->n ) { if ( c->rect.intersects( r ) ) { alreadyIntersected = TRUE; QIconViewItem *item = c->items.first(); for ( ; item; item = c->items.next() ) { 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() */ QIconViewItem* QIconView::findLastVisibleItem( const QRect &r ) const { QIconViewPrivate::ItemContainer *c = d->firstContainer; QIconViewItem *i = 0; bool alreadyIntersected = FALSE; for ( ; c; c = c->n ) { if ( c->rect.intersects( r ) ) { alreadyIntersected = TRUE; QIconViewItem *item = c->items.first(); for ( ; item; item = c->items.next() ) { 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 QIconView::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; } QIconViewItem *item = d->firstItem, *tmp; d->firstItem = 0; while ( item ) { tmp = item->next; delete item; item = tmp; } QIconViewPrivate::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 QIconView::gridX \brief the horizontal grid of the icon view If the value is -1, (the default), QIconView computes suitable column widths based on the icon view's contents. Note that setting a grid width overrides setMaxItemWidth(). */ void QIconView::setGridX( int rx ) { d->rastX = rx >= 0 ? rx : -1; } /*! \property QIconView::gridY \brief the vertical grid of the icon view If the value is -1, (the default), QIconView computes suitable column heights based on the icon view's contents. */ void QIconView::setGridY( int ry ) { d->rastY = ry >= 0 ? ry : -1; } int QIconView::gridX() const { return d->rastX; } int QIconView::gridY() const { return d->rastY; } /*! \property QIconView::spacing \brief the space in pixels between icon view items The default is 5 pixels. Negative values for spacing are illegal. */ void QIconView::setSpacing( int sp ) { d->spacing = sp; } int QIconView::spacing() const { return d->spacing; } /*! \property QIconView::itemTextPos \brief the position where the text of each item is drawn. Valid values are \c Bottom or \c Right. The default is \c Bottom. */ void QIconView::setItemTextPos( ItemTextPos pos ) { if ( pos == d->itemTextPos || ( pos != Bottom && pos != Right ) ) return; d->itemTextPos = pos; QIconViewItem *item = d->firstItem; for ( ; item; item = item->next ) { item->wordWrapDirty = TRUE; item->calcRect(); } arrangeItemsInGrid( TRUE ); } QIconView::ItemTextPos QIconView::itemTextPos() const { return d->itemTextPos; } /*! \property QIconView::itemTextBackground \brief the brush to use when drawing the background of an item's text. By default this brush is set to NoBrush, meaning that only the normal icon view background is used. */ void QIconView::setItemTextBackground( const QBrush &brush ) { d->itemTextBrush = brush; } QBrush QIconView::itemTextBackground() const { return d->itemTextBrush; } /*! \property QIconView::arrangement \brief the arrangement mode of the icon view This can be \c LeftToRight or \c TopToBottom. The default is \c LeftToRight. */ void QIconView::setArrangement( Arrangement am ) { if ( d->arrangement == am ) return; d->arrangement = am; viewport()->setUpdatesEnabled( FALSE ); resizeContents( viewport()->width(), viewport()->height() ); viewport()->setUpdatesEnabled( TRUE ); arrangeItemsInGrid( TRUE ); } QIconView::Arrangement QIconView::arrangement() const { return d->arrangement; } /*! \property QIconView::resizeMode \brief the resize mode of the icon view This can be \c Fixed or \c Adjust. The default is \c Fixed. See \l ResizeMode. */ void QIconView::setResizeMode( ResizeMode rm ) { if ( d->resizeMode == rm ) return; d->resizeMode = rm; } QIconView::ResizeMode QIconView::resizeMode() const { return d->resizeMode; } /*! \property QIconView::maxItemWidth \brief the maximum width that an item may have. The default is 100 pixels. Note that if the gridX() value is set QIconView will ignore this property. */ void QIconView::setMaxItemWidth( int w ) { d->maxItemWidth = w; } /*! \property QIconView::maxItemTextLength \brief the maximum length (in characters) that an item's text may have. The default is 255 characters. */ void QIconView::setMaxItemTextLength( int w ) { d->maxItemTextLength = w; } int QIconView::maxItemWidth() const { if ( d->rastX != -1 ) return d->rastX - 2; else return d->maxItemWidth; } int QIconView::maxItemTextLength() const { return d->maxItemTextLength; } /*! \property QIconView::itemsMovable \brief whether the user is allowed to move items around in the icon view The default is TRUE. */ void QIconView::setItemsMovable( bool b ) { d->rearrangeEnabled = b; } bool QIconView::itemsMovable() const { return d->rearrangeEnabled; } /*! \property QIconView::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, QIconView defers all position-related work until it is shown and then calls arrangeItemsInGrid(). */ void QIconView::setAutoArrange( bool b ) { d->reorderItemsWhenInsert = b; } bool QIconView::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. QIconViewItem::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 QIconView::setAutoArrange(), QIconView::autoArrange(), sortDirection(), sort(), QIconViewItem::setKey() */ void QIconView::setSorting( bool sort, bool ascending ) { d->resortItemsWhenInsert = sort; d->sortDirection = ascending; } /*! \property QIconView::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 QIconView::sorting() const { return d->resortItemsWhenInsert; } /*! \property QIconView::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 QIconView::sortDirection() const { return d->sortDirection; } /*! \property QIconView::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 QIconView::setWordWrapIconText( bool b ) { if ( d->wordWrapIconText == (uint)b ) return; d->wordWrapIconText = b; for ( QIconViewItem *item = d->firstItem; item; item = item->next ) { item->wordWrapDirty = TRUE; item->calcRect(); } arrangeItemsInGrid( TRUE ); } bool QIconView::wordWrapIconText() const { return d->wordWrapIconText; } /*! \property QIconView::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 QIconView::setShowToolTips( bool b ) { d->showTips = b; } bool QIconView::showToolTips() const { return d->showTips; } /*! \reimp */ void QIconView::contentsMousePressEvent( QMouseEvent *e ) { contentsMousePressEventEx( e ); } void QIconView::contentsMousePressEventEx( QMouseEvent *e ) { if ( d->rubber ) { QRect r( d->rubber->normalize() ); delete d->rubber; d->rubber = 0; repaintContents( r, FALSE ); d->dragging = FALSE; delete d->backrubber; d->backrubber = 0; if ( d->scrollTimer ) { disconnect( d->scrollTimer, SIGNAL( timeout() ), this, SLOT( doAutoScroll() ) ); d->scrollTimer->stop(); delete d->scrollTimer; d->scrollTimer = 0; } } d->dragStartPos = e->pos(); QIconViewItem *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() == LeftButton && !( e->state() & ShiftButton ) && !( e->state() & 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() & ControlButton ); else if ( d->selectionMode == Multi ) item->setSelected( !item->isSelected(), e->state() & ControlButton ); else if ( d->selectionMode == Extended ) { if ( e->state() & 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.normalize(); QIconViewPrivate::ItemContainer *c = d->firstContainer; bool alreadyIntersected = FALSE; QRect redraw; for ( ; c; c = c->n ) { if ( c->rect.intersects( r ) ) { alreadyIntersected = TRUE; QIconViewItem *i = c->items.first(); for ( ; i; i = c->items.next() ) { if ( r.intersects( i->rect() ) ) { redraw = redraw.unite( i->rect() ); i->setSelected( select, TRUE ); } } } else { if ( alreadyIntersected ) break; } } redraw = redraw.unite( item->rect() ); viewport()->setUpdatesEnabled( TRUE ); repaintContents( redraw, FALSE ); } blockSignals( block ); viewport()->setUpdatesEnabled( TRUE ); item->setSelected( select, TRUE ); emit selectionChanged(); } else if ( e->state() & ControlButton ) { d->pressedSelected = FALSE; item->setSelected( !item->isSelected(), e->state() & ControlButton ); } else { item->setSelected( TRUE, e->state() & ControlButton ); } } } else if ( ( d->selectionMode != Single || e->button() == RightButton ) && !( e->state() & ControlButton ) ) selectAll( FALSE ); setCurrentItem( item ); if ( e->button() == 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() & ControlButton ) == ControlButton ) { for ( QIconViewItem *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() == RightButton ) emit rightButtonPressed( item, e->globalPos() ); } } /*! \reimp */ void QIconView::contentsContextMenuEvent( QContextMenuEvent *e ) { if ( !receivers( SIGNAL(contextMenuRequested(QIconViewItem*,const QPoint&)) ) ) { e->ignore(); return; } if ( e->reason() == QContextMenuEvent::Keyboard ) { QIconViewItem *item = currentItem(); QRect r = item ? item->rect() : QRect( 0, 0, visibleWidth(), visibleHeight() ); emit contextMenuRequested( item, viewport()->mapToGlobal( contentsToViewport( r.center() ) ) ); } else { d->mousePressed = FALSE; QIconViewItem *item = findItem( e->pos() ); emit contextMenuRequested( item, e->globalPos() ); } } /*! \reimp */ void QIconView::contentsMouseReleaseEvent( QMouseEvent *e ) { QIconViewItem *item = findItem( e->pos() ); d->selectedItems.clear(); bool emitClicked = TRUE; d->mousePressed = FALSE; d->startDragItem = 0; if ( d->rubber ) { QRect r(d->rubber->normalize()); if ( ( d->rubber->topLeft() - d->rubber->bottomRight() ).manhattanLength() > QApplication::startDragDistance() ) emitClicked = FALSE; delete d->rubber; d->rubber = 0; repaintContents(r, FALSE); d->dragging = FALSE; delete d->backrubber; d->backrubber = 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->currentItem == d->pressedItem && d->pressedSelected && d->currentItem ) { bool block = signalsBlocked(); blockSignals( TRUE ); clearSelection(); blockSignals( block ); if ( d->currentItem->isSelectable() ) { d->currentItem->selected = TRUE; 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() == RightButton ) emit rightButtonClicked( item, e->globalPos() ); } } /*! \reimp */ void QIconView::contentsMouseMoveEvent( QMouseEvent *e ) { QIconViewItem *item = findItem( e->pos() ); if ( d->highlightedItem != item ) { if ( item ) emit onItem( item ); else emit onViewport(); d->highlightedItem = item; } if ( d->mousePressed && e->state() == NoButton ) d->mousePressed = FALSE; if ( d->startDragItem ) item = d->startDragItem; if ( d->mousePressed && item && item == d->currentItem && ( item->isSelected() || d->selectionMode == NoSelection ) && item->dragEnabled() ) { if ( !d->startDragItem ) { d->currentItem->setSelected( TRUE, TRUE ); d->startDragItem = item; } 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 QIconView::contentsMouseDoubleClickEvent( QMouseEvent *e ) { QIconViewItem *item = findItem( e->pos() ); if ( item ) { selectAll( FALSE ); item->setSelected( TRUE, TRUE ); emit doubleClicked( item ); } } /*! \reimp */ #ifndef QT_NO_DRAGANDDROP void QIconView::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; } /*! \reimp */ void QIconView::contentsDragMoveEvent( QDragMoveEvent *e ) { if ( e->pos() == d->oldDragPos ) { if (d->oldDragAcceptAction) e->acceptAction(); else e->ignore(); return; } drawDragShapes( d->oldDragPos ); d->dragging = FALSE; QIconViewItem *old = d->tmpCurrentItem; d->tmpCurrentItem = 0; QIconViewItem *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; QPainter p; p.begin( viewport() ); p.translate( -contentsX(), -contentsY() ); item->paintFocus( &p, colorGroup() ); p.end(); } else { e->acceptAction(); d->oldDragAcceptAction = TRUE; if ( old ) { old->dragLeft(); repaintItem( old ); } } d->oldDragPos = e->pos(); drawDragShapes( e->pos() ); d->dragging = TRUE; } /*! \reimp */ void QIconView::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 QIconView::contentsDropEvent( QDropEvent *e ) { d->dropped = TRUE; d->dragging = FALSE; drawDragShapes( d->oldDragPos ); if ( d->tmpCurrentItem ) repaintItem( d->tmpCurrentItem ); QIconViewItem *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(), FALSE ); int dx = d->currentItem->x() - r.x(); int dy = d->currentItem->y() - r.y(); QIconViewItem *item = d->firstItem; QRect rr; for ( ; item; item = item->next ) { if ( item->isSelected() && item != d->currentItem ) { rr = rr.unite( item->rect() ); item->moveBy( dx, dy ); rr = rr.unite( item->rect() ); } w = QMAX( w, item->x() + item->width() + 1 ); h = QMAX( h, item->y() + item->height() + 1 ); } repaintContents( rr, FALSE ); 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(), FALSE ); repaintContents( 0, oldh, contentsWidth(), contentsHeight() - oldh, FALSE ); } e->acceptAction(); } else if ( !i && ( e->source() != viewport() || d->cleared ) ) { QValueList lst; if ( QIconDrag::canDecode( e ) ) { QValueList l; QIconDragPrivate::decode( e, l ); QValueList::Iterator it = l.begin(); for ( ; it != l.end(); ++it ) lst << ( *it ).data; } emit dropped( e, lst ); } else if ( i ) { QValueList lst; if ( QIconDrag::canDecode( e ) ) { QValueList l; QIconDragPrivate::decode( e, l ); QValueList::Iterator it = l.begin(); for ( ; it != l.end(); ++it ) lst << ( *it ).data; } i->dropped( e, lst ); } d->isIconDrag = FALSE; } #endif /*! This function grabs all paintevents that otherwise would have been processed by the QScrollView::viewportPaintEvent(). Here we use a doublebuffer to reduce 'on-paint' flickering on QIconView (and of course its children). \sa QScrollView::viewportPaintEvent(), QIconView::drawContents() */ void QIconView::bufferedPaintEvent( QPaintEvent* pe ) { QWidget* vp = viewport(); QRect r = pe->rect() & vp->rect(); int ex = r.x() + contentsX(); int ey = r.y() + contentsY(); int ew = r.width(); int eh = r.height(); if ( !d->backBuffer ) d->backBuffer = new QPixmap(vp->size()); if ( d->backBuffer->size() != vp->size() ) { // Resize function (with hysteresis). Uses a good compromise between memory // consumption and speed (number) of resizes. float newWidth = (float)vp->width(); float newHeight = (float)vp->height(); if ( newWidth > d->backBuffer->width() || newHeight > d->backBuffer->height() ) { newWidth *= 1.1892; newHeight *= 1.1892; d->backBuffer->resize( (int)newWidth, (int)newHeight ); } else if ( 1.5*newWidth < d->backBuffer->width() || 1.5*newHeight < d->backBuffer->height() ) d->backBuffer->resize( (int)newWidth, (int)newHeight ); } QPainter p; p.begin(d->backBuffer, vp); drawContentsOffset(&p, contentsX(), contentsY(), ex, ey, ew, eh); p.end(); bitBlt(vp, r.x(), r.y(), d->backBuffer, r.x(), r.y(), ew, eh); } /*! \reimp */ void QIconView::resizeEvent( QResizeEvent* e ) { QScrollView::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 QIconView::adjustItems() { d->adjustTimer->stop(); if ( d->resizeMode == Adjust ) arrangeItemsInGrid( TRUE ); } /*! \reimp */ void QIconView::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 Key_Escape: e->ignore(); break; #ifndef QT_NO_TEXTEDIT case Key_F2: { if ( d->currentItem->renameEnabled() ) { d->currentItem->renameItem(); d->currentItem->rename(); return; } } break; #endif case Key_Home: { d->currInputString = QString::null; if ( !d->firstItem ) break; selectCurrent = FALSE; QIconViewItem *item = 0; QIconViewPrivate::ItemContainer *c = d->firstContainer; while ( !item && c ) { QPtrList &list = c->items; QIconViewItem *i = list.first(); while ( i ) { 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; } } i = list.next(); } c = c->n; } if ( item ) { QIconViewItem *old = d->currentItem; setCurrentItem( item ); ensureItemVisible( item ); handleItemChange( old, e->state() & ShiftButton, e->state() & ControlButton, TRUE ); } } break; case Key_End: { d->currInputString = QString::null; if ( !d->lastItem ) break; selectCurrent = FALSE; QIconViewItem *item = 0; QIconViewPrivate::ItemContainer *c = d->lastContainer; while ( !item && c ) { QPtrList &list = c->items; QIconViewItem *i = list.first(); while ( i ) { 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; } } i = list.next(); } c = c->p; } if ( item ) { QIconViewItem *old = d->currentItem; setCurrentItem( item ); ensureItemVisible( item ); handleItemChange( old, e->state() & ShiftButton, e->state() & ControlButton, TRUE ); } } break; case Key_Right: { d->currInputString = QString::null; QIconViewItem *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 ) { QIconViewItem *old = d->currentItem; setCurrentItem( item ); ensureItemVisible( item ); handleItemChange( old, e->state() & ShiftButton, e->state() & ControlButton ); } } break; case Key_Left: { d->currInputString = QString::null; QIconViewItem *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 ) { QIconViewItem *old = d->currentItem; setCurrentItem( item ); ensureItemVisible( item ); handleItemChange( old, e->state() & ShiftButton, e->state() & ControlButton ); } } break; case Key_Space: { d->currInputString = QString::null; if ( d->selectionMode == Single) break; d->currentItem->setSelected( !d->currentItem->isSelected(), TRUE ); } break; case Key_Enter: case Key_Return: d->currInputString = QString::null; emit returnPressed( d->currentItem ); break; case Key_Down: { d->currInputString = QString::null; QIconViewItem *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 ); } QIconViewItem *i = d->currentItem; setCurrentItem( item ); item = i; handleItemChange( item, e->state() & ShiftButton, e->state() & ControlButton ); } break; case Key_Up: { d->currInputString = QString::null; QIconViewItem *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 ); } QIconViewItem *i = d->currentItem; setCurrentItem( item ); item = i; handleItemChange( item, e->state() & ShiftButton, e->state() & ControlButton ); } break; case Key_Next: { d->currInputString = QString::null; 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() ); QIconViewItem *item = d->currentItem; QIconViewItem *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() & ShiftButton, e->state() & ControlButton ); } } break; case Key_Prior: { d->currInputString = QString::null; 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() ); QIconViewItem *item = d->currentItem; QIconViewItem *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() & ShiftButton, e->state() & ControlButton ); } } break; default: if ( !e->text().isEmpty() && e->text()[ 0 ].isPrint() ) { selectCurrent = FALSE; QIconViewItem *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 = QString::null; if ( e->state() & ControlButton ) { switch ( e->key() ) { case Key_A: selectAll( TRUE ); break; } } e->ignore(); return; } } if ( !( e->state() & 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 choses the closest item with its center in the searchRect. */ QIconViewItem* QIconView::findItem( Direction dir, const QPoint &relativeTo, const QRect &searchRect ) const { QIconViewItem *item; QIconViewItem *centerMatch = 0; int centerMatchML = 0; // gets list of containers with potential items QPtrList* cList = d->findContainers( dir, relativeTo, searchRect); cList->first(); while ( cList->current() && !centerMatch ) { QPtrList &list = (cList->current())->items; for ( item = list.first(); item; item = list.next() ) { 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; } } } cList->next(); } delete cList; return centerMatch; } /* Returns TRUE if the items orientation compared to the point \a relativeTo is correct. */ bool QIconView::neighbourItem( Direction dir, const QPoint &relativeTo, const QIconViewItem *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 QIconView::focusInEvent( QFocusEvent* ) { d->mousePressed = FALSE; d->inMenuMode = FALSE; if ( d->currentItem ) { repaintItem( d->currentItem ); } else if ( d->firstItem && QFocusEvent::reason() != QFocusEvent::Mouse ) { d->currentItem = d->firstItem; emit currentChanged( d->currentItem ); repaintItem( d->currentItem ); } if ( style().styleHint( QStyle::SH_ItemView_ChangeHighlightOnFocus, this ) ) repaintSelectedItems(); if ( d->currentItem ) setMicroFocusHint( d->currentItem->x(), d->currentItem->y(), d->currentItem->width(), d->currentItem->height(), FALSE ); } /*! \reimp */ void QIconView::focusOutEvent( QFocusEvent* ) { if (style().styleHint( QStyle::SH_ItemView_ChangeHighlightOnFocus, this )) { d->inMenuMode = QFocusEvent::reason() == QFocusEvent::Popup || (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 QIconView::drawRubber( QPainter *p ) { if ( !p || !d->rubber ) return; QPoint pnt( d->rubber->x(), d->rubber->y() ); pnt = contentsToViewport( pnt ); style().drawPrimitive( QStyle::PE_RubberBand, p, QRect( pnt.x(), pnt.y(), d->rubber->width(), d->rubber->height() ).normalize(), colorGroup(), QStyle::Style_Default, QStyleOption(colorGroup().base()) ); } /*! Returns the QDragObject 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 QIconDrag */ #ifndef QT_NO_DRAGANDDROP QDragObject *QIconView::dragObject() { if ( !d->currentItem ) return 0; QPoint orig = d->dragStartPos; QIconDrag *drag = new QIconDrag( 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 ) { QIconViewItem *item = d->currentItem; drag->append( QIconDragItem(), 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 ( QIconViewItem *item = d->firstItem; item; item = item->next ) { if ( item->isSelected() ) { drag->append( QIconDragItem(), 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 QIconView::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; QDragObject *drag = dragObject(); if ( !drag ) return; if ( drag->drag() ) if ( drag->target() != viewport() ) emit moved(); } #endif /*! Inserts the QIconViewItem \a item in the icon view's grid. \e{You should never need to call this function.} Instead, insert QIconViewItems by creating them with a pointer to the QIconView that they are to be inserted into. */ void QIconView::insertInGrid( QIconViewItem *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; } QIconViewItem *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() ) ) ); QIconViewItem *i = d->firstItem; int y = -1; for ( ; i; i = i->next ) { r = r.subtract( i->rect() ); y = QMAX( y, i->y() + i->height() ); } QMemArray rects = r.rects(); QMemArray::Iterator it = rects.begin(); bool foundPlace = FALSE; for ( ; it != rects.end(); ++it ) { QRect rect = *it; 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 QIconViewItem that was selected or de-selected. \e{You should never need to call this function.} */ void QIconView::emitSelectionChanged( QIconViewItem *i ) { emit selectionChanged(); if ( d->selectionMode == Single ) emit selectionChanged( i ? i : d->currentItem ); } /*! \internal */ void QIconView::emitRenamed( QIconViewItem *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 QIconView::drawDragShapes( const QPoint &pos ) { #ifndef QT_NO_DRAGANDDROP if ( pos == QPoint( -1, -1 ) ) return; if ( !d->drawDragShapes ) { d->drawDragShapes = TRUE; return; } QStyleOption opt(colorGroup().base()); QPainter p; p.begin( viewport() ); p.translate( -contentsX(), -contentsY() ); p.setRasterOp( NotROP ); p.setPen( QPen( color0 ) ); if ( d->isIconDrag ) { QValueList::Iterator it = d->iconDragData.begin(); for ( ; it != d->iconDragData.end(); ++it ) { QRect ir = (*it).item.pixmapRect(); QRect tr = (*it).item.textRect(); tr.moveBy( pos.x(), pos.y() ); ir.moveBy( pos.x(), pos.y() ); if ( !ir.intersects( QRect( contentsX(), contentsY(), visibleWidth(), visibleHeight() ) ) ) continue; style().drawPrimitive(QStyle::PE_FocusRect, &p, ir, colorGroup(), QStyle::Style_Default, opt); style().drawPrimitive(QStyle::PE_FocusRect, &p, tr, colorGroup(), QStyle::Style_Default, opt); } } else if ( d->numDragItems > 0 ) { for ( int i = 0; i < d->numDragItems; ++i ) { QRect r( pos.x() + i * 40, pos.y(), 35, 35 ); style().drawPrimitive(QStyle::PE_FocusRect, &p, r, colorGroup(), QStyle::Style_Default, opt); } } p.end(); #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 QIconView::initDragEnter( QDropEvent *e ) { if ( QIconDrag::canDecode( e ) ) { QIconDragPrivate::decode( e, d->iconDragData ); d->isIconDrag = TRUE; } else if ( QUriDrag::canDecode( e ) ) { QStrList lst; QUriDrag::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 may reimplement this to draw custom backgrounds. \sa contentsX() contentsY() drawContents() */ void QIconView::drawBackground( QPainter *p, const QRect &r ) { p->fillRect( r, viewport()->backgroundBrush() ); } /*! \reimp */ bool QIconView::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() ) { if ( d->dragging ) { if ( !d->rubber ) drawDragShapes( d->oldDragPos ); viewportPaintEvent( (QPaintEvent*)e ); if ( !d->rubber ) drawDragShapes( d->oldDragPos ); } else { bufferedPaintEvent( (QPaintEvent*)e ); } } return TRUE; default: // nothing break; } } return QScrollView::eventFilter( o, e ); } /*! \reimp */ QSize QIconView::minimumSizeHint() const { return QScrollView::minimumSizeHint(); } /*! \internal Finds the next item after the start item beginning with \a text. */ QIconViewItem* QIconView::findItemByName( QIconViewItem *start ) { if ( !start ) return 0; QString match = d->currInputString.lower(); if ( match.length() < 1 ) return start; QString curText; QIconViewItem *i = start; do { curText = i->text().lower(); 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 == \c 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. */ QIconViewItem *QIconView::makeRowLayout( QIconViewItem *begin, int &y, bool &changed ) { QIconViewItem *end = 0; // Find the first visible item while (begin->next && (begin->isVisible() == FALSE)) { begin = begin->next; } 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; QIconViewItem *item = begin; for (;;) { x += d->spacing + item->width(); if ( x > visibleWidth() && item != begin ) { item = item->prev; while (item && (item->isVisible() == FALSE)) { item = item->prev; } break; } h = QMAX( h, item->height() ); ih = QMAX( ih, item->pixmapRect().height() ); QIconViewItem *old = item; item = item->next; while (item && (item->isVisible() == FALSE)) { 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(); QIconViewItem *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; while (item && (item->isVisible() == FALSE)) { item = item->prev; } break; } h = QMAX( h, item->height() ); ih = QMAX( ih, item->pixmapRect().height() ); QIconViewItem *old = item; item = item->next; while (item && (item->isVisible() == FALSE)) { 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; while (item && (item->isVisible() == FALSE)) { item = item->next; } } y += h + d->spacing; } } else { // -------------------------------- SOUTH ------------------------------ int x = y; { int w = 0; int y = 0; QIconViewItem *item = begin; for (;;) { y += d->spacing + item->height(); if ( y > visibleHeight() && item != begin ) { item = item->prev; while (item && (item->isVisible() == FALSE)) { item = item->prev; } break; } w = QMAX( w, item->width() ); QIconViewItem *old = item; item = item->next; while (item && (item->isVisible() == FALSE)) { 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; while (item && (item->isVisible() == FALSE)) { 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 QIconView::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. */ QIconViewItem *QIconView::rowBegin( QIconViewItem * ) 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. QIconViewItem::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 QIconViewItem::key(), QIconViewItem::setKey(), QIconViewItem::compare(), QIconView::setSorting(), QIconView::sortDirection() */ void QIconView::sort( bool ascending ) { if ( count() == 0 ) return; d->sortDirection = ascending; QIconViewPrivate::SortableItem *items = new QIconViewPrivate::SortableItem[ count() ]; QIconViewItem *item = d->firstItem; int i = 0; for ( ; item; item = item->next ) items[ i++ ].item = item; qsort( items, count(), sizeof( QIconViewPrivate::SortableItem ), cmpIconViewItems ); QIconViewItem *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 QIconView::sizeHint() const { constPolish(); if ( !d->firstItem ) return QScrollView::sizeHint(); if ( d->dirty && d->firstSizeHint ) { ( (QIconView*)this )->resizeContents( QMAX( 400, contentsWidth() ), QMAX( 400, contentsHeight() ) ); if ( autoArrange() ) ( (QIconView*)this )->arrangeItemsInGrid( FALSE ); d->firstSizeHint = FALSE; } d->dirty = TRUE; // ######## warwick: I'm sure this is wrong. Fixed in 2.3. int extra = style().pixelMetric(QStyle::PM_ScrollBarExtent, verticalScrollBar()) + 2*frameWidth(); QSize s( QMIN(400, contentsWidth() + extra), QMIN(400, contentsHeight() + extra) ); return s; } /*! \internal */ void QIconView::updateContents() { viewport()->update(); } /*! \reimp */ void QIconView::enterEvent( QEvent *e ) { QScrollView::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 QIconView::updateItemContainer( QIconViewItem *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 removeRef (slower) if (item->d->container1->items.last() == item) item->d->container1->items.removeLast(); else item->d->container1->items.removeRef( item ); } item->d->container1 = 0; if ( item->d->container2 && d->firstContainer ) { //Special-case to check if we can use removeLast otherwise use removeRef (slower) if (item->d->container2->items.last() == item) item->d->container2->items.removeLast(); else item->d->container2->items.removeRef( item ); } item->d->container2 = 0; QIconViewPrivate::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 ) { #if defined(QT_CHECK_RANGE) qWarning( "QIconViewItem::updateItemContainer(): No fitting container found!" ); #endif return; } if (item->isVisible()) { 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 QIconView::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 QIconViewPrivate::ItemContainer( 0, 0, QRect( QPoint( 0, 0 ), s ) ); d->lastContainer = d->firstContainer; } else { if ( d->arrangement == LeftToRight ) d->lastContainer = new QIconViewPrivate::ItemContainer( d->lastContainer, 0, QRect( d->lastContainer->rect.bottomLeft(), s ) ); else d->lastContainer = new QIconViewPrivate::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 QIconView::rebuildContainers() { QIconViewPrivate::ItemContainer *c = d->firstContainer, *tmpc; while ( c ) { tmpc = c->n; delete c; c = tmpc; } d->firstContainer = d->lastContainer = 0; QIconViewItem *item = d->firstItem; appendItemContainer(); c = d->lastContainer; while ( item ) { if (item->isVisible()) { 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; } } } else { // Skip this hidden item item = item->next; } } } /*! \internal */ void QIconView::movedContents( int, int ) { if ( d->drawDragShapes ) { drawDragShapes( d->oldDragPos ); d->oldDragPos = QPoint( -1, -1 ); } } void QIconView::handleItemChange( QIconViewItem *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 { QIconViewItem *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().unite( 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 QIconViewItem *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.unite( item->rect() ); } } else if ( item->selected && !control ) { item->selected = FALSE; unselectedRect = unselectedRect.unite( item->rect() ); changed = TRUE; } } QRect viewRect( contentsX(), contentsY(), visibleWidth(), visibleHeight() ); if ( viewRect.intersects( selectedRect ) ) { if ( homeend ) QScrollView::updateContents( viewRect.intersect( selectedRect ) ); else repaintContents( viewRect.intersect( selectedRect ) ); } if ( viewRect.intersects( unselectedRect ) ) { if ( homeend ) QScrollView::updateContents( viewRect.intersect( unselectedRect ) ); else repaintContents( viewRect.intersect( 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 QIconView::mask( QPixmap *pix ) const { QBitmap m; if ( d->maskCache.find( QString::number( pix->serialNumber() ), m ) ) return m; m = pix->createHeuristicMask(); d->maskCache.insert( QString::number( pix->serialNumber() ), m ); return m; } /*! \reimp \internal (Implemented to get rid of a compiler warning.) */ void QIconView::drawContents( QPainter * ) { } /*! \reimp */ void QIconView::windowActivationChange( bool oldActive ) { if ( oldActive && d->scrollTimer ) d->scrollTimer->stop(); if ( !isVisible() ) return; if ( palette().active() == palette().inactive() ) return; repaintSelectedItems(); } /*! Returns TRUE if an iconview item is being renamed; otherwise returns FALSE. */ bool QIconView::isRenaming() const { #ifndef QT_NO_TEXTEDIT return d->renamingItem && d->renamingItem->renameBox; #else return FALSE; #endif } #endif // QT_NO_ICONVIEW