summaryrefslogtreecommitdiffstats
path: root/src/iconview/qiconview.h
diff options
context:
space:
mode:
authorTimothy Pearson <[email protected]>2011-07-10 15:24:15 -0500
committerTimothy Pearson <[email protected]>2011-07-10 15:24:15 -0500
commitbd0f3345a938b35ce6a12f6150373b0955b8dd12 (patch)
tree7a520322212d48ebcb9fbe1087e7fca28b76185c /src/iconview/qiconview.h
downloadqt3-bd0f3345a938b35ce6a12f6150373b0955b8dd12.tar.gz
qt3-bd0f3345a938b35ce6a12f6150373b0955b8dd12.zip
Add Qt3 development HEAD version
Diffstat (limited to 'src/iconview/qiconview.h')
-rw-r--r--src/iconview/qiconview.h514
1 files changed, 514 insertions, 0 deletions
diff --git a/src/iconview/qiconview.h b/src/iconview/qiconview.h
new file mode 100644
index 0000000..2da3ed0
--- /dev/null
+++ b/src/iconview/qiconview.h
@@ -0,0 +1,514 @@
+/****************************************************************************
+**
+** Definition 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 [email protected].
+**
+** 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.
+**
+**********************************************************************/
+
+#ifndef QICONVIEW_H
+#define QICONVIEW_H
+
+#ifndef QT_H
+#include "qscrollview.h"
+#include "qstring.h"
+#include "qrect.h"
+#include "qpoint.h"
+#include "qsize.h"
+#include "qfont.h" // QString->QFont conversion
+#include "qdragobject.h"
+#include "qbitmap.h"
+#include "qpicture.h"
+#endif // QT_H
+
+#ifndef QT_NO_ICONVIEW
+
+#if !defined( QT_MODULE_ICONVIEW ) || defined( QT_INTERNAL_ICONVIEW )
+#define QM_EXPORT_ICONVIEW
+#else
+#define QM_EXPORT_ICONVIEW Q_EXPORT
+#endif
+
+class QIconView;
+class QPainter;
+class QMimeSource;
+class QMouseEvent;
+class QDragEnterEvent;
+class QDragMoveEvent;
+class QDragLeaveEvent;
+class QKeyEvent;
+class QFocusEvent;
+class QShowEvent;
+class QIconViewItem;
+class QIconViewItemLineEdit;
+class QStringList;
+class QIconDragPrivate;
+
+#ifndef QT_NO_DRAGANDDROP
+
+class QM_EXPORT_ICONVIEW QIconDragItem
+{
+public:
+ QIconDragItem();
+ virtual ~QIconDragItem();
+ virtual QByteArray data() const;
+ virtual void setData( const QByteArray &d );
+ bool operator== ( const QIconDragItem& ) const;
+
+private:
+ QByteArray ba;
+
+};
+
+class QM_EXPORT_ICONVIEW QIconDrag : public QDragObject
+{
+ Q_OBJECT
+public:
+ QIconDrag( QWidget * dragSource, const char* name = 0 );
+ virtual ~QIconDrag();
+
+ void append( const QIconDragItem &item, const QRect &pr, const QRect &tr );
+
+ virtual const char* format( int i ) const;
+ static bool canDecode( QMimeSource* e );
+ virtual QByteArray encodedData( const char* mime ) const;
+
+private:
+ QIconDragPrivate *d;
+ QChar endMark;
+
+ friend class QIconView;
+ friend class QIconViewPrivate;
+#if defined(Q_DISABLE_COPY) // Disabled copy constructor and operator=
+ QIconDrag( const QIconDrag & );
+ QIconDrag &operator=( const QIconDrag & );
+#endif
+};
+
+#endif
+
+class QIconViewToolTip;
+class QIconViewItemPrivate;
+
+class QM_EXPORT_ICONVIEW QIconViewItem : public Qt
+{
+ friend class QIconView;
+ friend class QIconViewToolTip;
+ friend class QIconViewItemLineEdit;
+
+public:
+ QIconViewItem( QIconView *parent );
+ QIconViewItem( QIconView *parent, QIconViewItem *after );
+ QIconViewItem( QIconView *parent, const QString &text );
+ QIconViewItem( QIconView *parent, QIconViewItem *after, const QString &text );
+ QIconViewItem( QIconView *parent, const QString &text, const QPixmap &icon );
+ QIconViewItem( QIconView *parent, QIconViewItem *after, const QString &text, const QPixmap &icon );
+#ifndef QT_NO_PICTURE
+ QIconViewItem( QIconView *parent, const QString &text, const QPicture &picture );
+ QIconViewItem( QIconView *parent, QIconViewItem *after, const QString &text, const QPicture &picture );
+#endif
+ virtual ~QIconViewItem();
+
+ virtual void setRenameEnabled( bool allow );
+ virtual void setDragEnabled( bool allow );
+ virtual void setDropEnabled( bool allow );
+
+ virtual QString text() const;
+ virtual QPixmap *pixmap() const;
+#ifndef QT_NO_PICTURE
+ virtual QPicture *picture() const;
+#endif
+ virtual QString key() const;
+
+ bool renameEnabled() const;
+ bool dragEnabled() const;
+ bool dropEnabled() const;
+
+ QIconView *iconView() const;
+ QIconViewItem *prevItem() const;
+ QIconViewItem *nextItem() const;
+
+ int index() const;
+
+ virtual void setSelected( bool s, bool cb );
+ virtual void setSelected( bool s );
+ virtual void setSelectable( bool s );
+
+ bool isSelected() const;
+ bool isSelectable() const;
+
+ virtual void repaint();
+
+ virtual bool move( int x, int y );
+ virtual void moveBy( int dx, int dy );
+ virtual bool move( const QPoint &pnt );
+ virtual void moveBy( const QPoint &pnt );
+
+ QRect rect() const;
+ int x() const;
+ int y() const;
+ int width() const;
+ int height() const;
+ QSize size() const;
+ QPoint pos() const;
+ QRect textRect( bool relative = TRUE ) const;
+ QRect pixmapRect( bool relative = TRUE ) const;
+ bool contains( const QPoint& pnt ) const;
+ bool intersects( const QRect& r ) const;
+
+ virtual bool acceptDrop( const QMimeSource *mime ) const;
+
+#ifndef QT_NO_TEXTEDIT
+ void rename();
+#endif
+
+ virtual int compare( QIconViewItem *i ) const;
+
+ virtual void setText( const QString &text );
+ virtual void setPixmap( const QPixmap &icon );
+#ifndef QT_NO_PICTURE
+ virtual void setPicture( const QPicture &icon );
+#endif
+ virtual void setText( const QString &text, bool recalc, bool redraw = TRUE );
+ virtual void setPixmap( const QPixmap &icon, bool recalc, bool redraw = TRUE );
+ virtual void setKey( const QString &k );
+
+ virtual int rtti() const;
+ static int RTTI;
+
+protected:
+#ifndef QT_NO_TEXTEDIT
+ virtual void removeRenameBox();
+#endif
+ virtual void calcRect( const QString &text_ = QString::null );
+ virtual void paintItem( QPainter *p, const QColorGroup &cg );
+ virtual void paintFocus( QPainter *p, const QColorGroup &cg );
+#ifndef QT_NO_DRAGANDDROP
+ virtual void dropped( QDropEvent *e, const QValueList<QIconDragItem> &lst );
+#endif
+ virtual void dragEntered();
+ virtual void dragLeft();
+ void setItemRect( const QRect &r );
+ void setTextRect( const QRect &r );
+ void setPixmapRect( const QRect &r );
+ void calcTmpText();
+ QString tempText() const;
+
+private:
+ void init( QIconViewItem *after = 0
+#ifndef QT_NO_PICTURE
+ , QPicture *pic = 0
+#endif
+ );
+#ifndef QT_NO_TEXTEDIT
+ void renameItem();
+ void cancelRenameItem();
+#endif
+ void checkRect();
+
+ QIconView *view;
+ QString itemText, itemKey;
+ QString tmpText;
+ QPixmap *itemIcon;
+#ifndef QT_NO_PICTURE
+ QPicture *itemPic;
+#endif
+ QIconViewItem *prev, *next;
+ uint allow_rename : 1;
+ uint allow_drag : 1;
+ uint allow_drop : 1;
+ uint selected : 1;
+ uint selectable : 1;
+ uint dirty : 1;
+ uint wordWrapDirty : 1;
+ QRect itemRect, itemTextRect, itemIconRect;
+#ifndef QT_NO_TEXTEDIT
+ QIconViewItemLineEdit *renameBox;
+#endif
+ QRect oldRect;
+
+ QIconViewItemPrivate *d;
+
+};
+
+class QIconViewPrivate; /* don't touch */
+
+class QM_EXPORT_ICONVIEW QIconView : public QScrollView
+{
+ friend class QIconViewItem;
+ friend class QIconViewPrivate;
+ friend class QIconViewToolTip;
+
+ Q_OBJECT
+ // #### sorting and sort direction do not work
+ Q_ENUMS( SelectionMode ItemTextPos Arrangement ResizeMode )
+ Q_PROPERTY( bool sorting READ sorting )
+ Q_PROPERTY( bool sortDirection READ sortDirection )
+ Q_PROPERTY( SelectionMode selectionMode READ selectionMode WRITE setSelectionMode )
+ Q_PROPERTY( int gridX READ gridX WRITE setGridX )
+ Q_PROPERTY( int gridY READ gridY WRITE setGridY )
+ Q_PROPERTY( int spacing READ spacing WRITE setSpacing )
+ Q_PROPERTY( ItemTextPos itemTextPos READ itemTextPos WRITE setItemTextPos )
+ Q_PROPERTY( QBrush itemTextBackground READ itemTextBackground WRITE setItemTextBackground )
+ Q_PROPERTY( Arrangement arrangement READ arrangement WRITE setArrangement )
+ Q_PROPERTY( ResizeMode resizeMode READ resizeMode WRITE setResizeMode )
+ Q_PROPERTY( int maxItemWidth READ maxItemWidth WRITE setMaxItemWidth )
+ Q_PROPERTY( int maxItemTextLength READ maxItemTextLength WRITE setMaxItemTextLength )
+ Q_PROPERTY( bool autoArrange READ autoArrange WRITE setAutoArrange )
+ Q_PROPERTY( bool itemsMovable READ itemsMovable WRITE setItemsMovable )
+ Q_PROPERTY( bool wordWrapIconText READ wordWrapIconText WRITE setWordWrapIconText )
+ Q_PROPERTY( bool showToolTips READ showToolTips WRITE setShowToolTips )
+ Q_PROPERTY( uint count READ count )
+
+public:
+ enum SelectionMode {
+ Single = 0,
+ Multi,
+ Extended,
+ NoSelection
+ };
+ enum Arrangement {
+ LeftToRight = 0,
+ TopToBottom
+ };
+ enum ResizeMode {
+ Fixed = 0,
+ Adjust
+ };
+ enum ItemTextPos {
+ Bottom = 0,
+ Right
+ };
+
+ QIconView( QWidget* parent=0, const char* name=0, WFlags f = 0 );
+ virtual ~QIconView();
+
+ virtual void insertItem( QIconViewItem *item, QIconViewItem *after = 0L );
+ virtual void takeItem( QIconViewItem *item );
+
+ int index( const QIconViewItem *item ) const;
+
+ QIconViewItem *firstItem() const;
+ QIconViewItem *lastItem() const;
+ QIconViewItem *currentItem() const;
+ virtual void setCurrentItem( QIconViewItem *item );
+ virtual void setSelected( QIconViewItem *item, bool s, bool cb = FALSE );
+
+ uint count() const;
+
+public:
+ virtual void showEvent( QShowEvent * );
+
+ virtual void setSelectionMode( SelectionMode m );
+ SelectionMode selectionMode() const;
+
+ QIconViewItem *findItem( const QPoint &pos ) const;
+ QIconViewItem *findItem( const QString &text, ComparisonFlags compare = BeginsWith ) const;
+ virtual void selectAll( bool select );
+ virtual void clearSelection();
+ virtual void invertSelection();
+
+ virtual void repaintItem( QIconViewItem *item );
+ void repaintSelectedItems();
+
+ void ensureItemVisible( QIconViewItem *item );
+ QIconViewItem* findFirstVisibleItem( const QRect &r ) const;
+ QIconViewItem* findLastVisibleItem( const QRect &r ) const;
+
+ virtual void clear();
+
+ virtual void setGridX( int rx );
+ virtual void setGridY( int ry );
+ int gridX() const;
+ int gridY() const;
+ virtual void setSpacing( int sp );
+ int spacing() const;
+ virtual void setItemTextPos( ItemTextPos pos );
+ ItemTextPos itemTextPos() const;
+ virtual void setItemTextBackground( const QBrush &b );
+ QBrush itemTextBackground() const;
+ virtual void setArrangement( Arrangement am );
+ Arrangement arrangement() const;
+ virtual void setResizeMode( ResizeMode am );
+ ResizeMode resizeMode() const;
+ virtual void setMaxItemWidth( int w );
+ int maxItemWidth() const;
+ virtual void setMaxItemTextLength( int w );
+ int maxItemTextLength() const;
+ virtual void setAutoArrange( bool b );
+ bool autoArrange() const;
+ virtual void setShowToolTips( bool b );
+ bool showToolTips() const;
+
+ void setSorting( bool sort, bool ascending = TRUE );
+ bool sorting() const;
+ bool sortDirection() const;
+
+ virtual void setItemsMovable( bool b );
+ bool itemsMovable() const;
+ virtual void setWordWrapIconText( bool b );
+ bool wordWrapIconText() const;
+
+ bool eventFilter( QObject * o, QEvent * );
+
+ QSize minimumSizeHint() const;
+ QSize sizeHint() const;
+
+ virtual void sort( bool ascending = TRUE );
+
+ virtual void setFont( const QFont & );
+ virtual void setPalette( const QPalette & );
+
+ bool isRenaming() const;
+
+public slots:
+ virtual void arrangeItemsInGrid( const QSize &grid, bool update = TRUE );
+ virtual void arrangeItemsInGrid( bool update = TRUE );
+ virtual void setContentsPos( int x, int y );
+ virtual void updateContents();
+
+signals:
+ void selectionChanged();
+ void selectionChanged( QIconViewItem *item );
+ void currentChanged( QIconViewItem *item );
+ void clicked( QIconViewItem * );
+ void clicked( QIconViewItem *, const QPoint & );
+ void pressed( QIconViewItem * );
+ void pressed( QIconViewItem *, const QPoint & );
+
+ void doubleClicked( QIconViewItem *item );
+ void returnPressed( QIconViewItem *item );
+ void rightButtonClicked( QIconViewItem* item, const QPoint& pos );
+ void rightButtonPressed( QIconViewItem* item, const QPoint& pos );
+ void mouseButtonPressed( int button, QIconViewItem* item, const QPoint& pos );
+ void mouseButtonClicked( int button, QIconViewItem* item, const QPoint& pos );
+ void contextMenuRequested( QIconViewItem* item, const QPoint &pos );
+
+#ifndef QT_NO_DRAGANDDROP
+ void dropped( QDropEvent *e, const QValueList<QIconDragItem> &lst );
+#endif
+ void moved();
+ void onItem( QIconViewItem *item );
+ void onViewport();
+ void itemRenamed( QIconViewItem *item, const QString & );
+ void itemRenamed( QIconViewItem *item );
+
+protected slots:
+ virtual void doAutoScroll();
+ virtual void adjustItems();
+ virtual void slotUpdate();
+
+private slots:
+ void movedContents( int dx, int dy );
+
+protected:
+ void drawContents( QPainter *p, int cx, int cy, int cw, int ch );
+ void contentsMousePressEvent( QMouseEvent *e );
+ void contentsMouseReleaseEvent( QMouseEvent *e );
+ void contentsMouseMoveEvent( QMouseEvent *e );
+ void contentsMouseDoubleClickEvent( QMouseEvent *e );
+ void contentsContextMenuEvent( QContextMenuEvent *e );
+
+#ifndef QT_NO_DRAGANDDROP
+ void contentsDragEnterEvent( QDragEnterEvent *e );
+ void contentsDragMoveEvent( QDragMoveEvent *e );
+ void contentsDragLeaveEvent( QDragLeaveEvent *e );
+ void contentsDropEvent( QDropEvent *e );
+#endif
+
+ void resizeEvent( QResizeEvent* e );
+ void keyPressEvent( QKeyEvent *e );
+ void focusInEvent( QFocusEvent *e );
+ void focusOutEvent( QFocusEvent *e );
+ void enterEvent( QEvent *e );
+
+ virtual void drawRubber( QPainter *p );
+#ifndef QT_NO_DRAGANDDROP
+ virtual QDragObject *dragObject();
+ virtual void startDrag();
+#endif
+ virtual void insertInGrid( QIconViewItem *item );
+ virtual void drawBackground( QPainter *p, const QRect &r );
+
+ void emitSelectionChanged( QIconViewItem * i = 0 );
+ void emitRenamed( QIconViewItem *item );
+
+ QIconViewItem *makeRowLayout( QIconViewItem *begin, int &y, bool &changed );
+
+ void styleChange( QStyle& );
+ void windowActivationChange( bool );
+
+private:
+ void contentsMousePressEventEx( QMouseEvent *e );
+ virtual void drawDragShapes( const QPoint &pnt );
+#ifndef QT_NO_DRAGANDDROP
+ virtual void initDragEnter( QDropEvent *e );
+#endif
+ void drawContents( QPainter* );
+ QIconViewItem* findItemByName( QIconViewItem *start );
+ void handleItemChange( QIconViewItem *old, bool shift,
+ bool control, bool homeend = FALSE);
+
+ int calcGridNum( int w, int x ) const;
+ QIconViewItem *rowBegin( QIconViewItem *item ) const;
+ void updateItemContainer( QIconViewItem *item );
+ void appendItemContainer();
+ void rebuildContainers();
+ enum Direction {
+ DirUp = 0,
+ DirDown,
+ DirLeft,
+ DirRight
+ };
+ QIconViewItem* findItem( Direction dir,
+ const QPoint &relativeTo,
+ const QRect &searchRect ) const;
+ bool neighbourItem( Direction dir,
+ const QPoint &relativeTo,
+ const QIconViewItem *item ) const;
+ QBitmap mask( QPixmap *pix ) const;
+
+ QIconViewPrivate *d;
+
+private: // Disabled copy constructor and operator=
+#if defined(Q_DISABLE_COPY)
+ QIconView( const QIconView & );
+ QIconView& operator=( const QIconView & );
+#endif
+};
+
+#endif // QT_NO_ICONVIEW
+
+#endif // QICONVIEW_H