You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
qt3/doc/html/qiconview-h.html

560 lines
18 KiB

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qiconview.h:1 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>qiconview.h Include File</title>
<style type="text/css"><!--
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">Home</font></a>
| <a href="classes.html">
<font color="#004faf">All&nbsp;Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped&nbsp;Classes</font></a>
| <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qiconview.h</h1>
<p>This is the verbatim text of the qiconview.h include file. It is provided only for illustration; the copyright remains with Trolltech.
<hr>
<pre>
/****************************************************************************
** $Id: qt/qiconview.h 3.3.8 edited Jan 11 14:38 $
**
** Definition of QIconView widget class
**
** Created : 990707
**
** Copyright (C) 1992-2007 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 file LICENSE.GPL 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.
**
**********************************************************************/
#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-&gt;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 &amp;d );
bool operator== ( const QIconDragItem&amp; ) 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 &amp;item, const QRect &amp;pr, const QRect &amp;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 &amp; );
QIconDrag &amp;operator=( const QIconDrag &amp; );
#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 &amp;text );
QIconViewItem( QIconView *parent, QIconViewItem *after, const QString &amp;text );
QIconViewItem( QIconView *parent, const QString &amp;text, const QPixmap &amp;icon );
QIconViewItem( QIconView *parent, QIconViewItem *after, const QString &amp;text, const QPixmap &amp;icon );
#ifndef QT_NO_PICTURE
QIconViewItem( QIconView *parent, const QString &amp;text, const QPicture &amp;picture );
QIconViewItem( QIconView *parent, QIconViewItem *after, const QString &amp;text, const QPicture &amp;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 &amp;pnt );
virtual void moveBy( const QPoint &amp;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&amp; pnt ) const;
bool intersects( const QRect&amp; 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 &amp;text );
virtual void setPixmap( const QPixmap &amp;icon );
#ifndef QT_NO_PICTURE
virtual void setPicture( const QPicture &amp;icon );
#endif
virtual void setText( const QString &amp;text, bool recalc, bool redraw = TRUE );
virtual void setPixmap( const QPixmap &amp;icon, bool recalc, bool redraw = TRUE );
virtual void setKey( const QString &amp;k );
virtual int rtti() const;
static int RTTI;
protected:
#ifndef QT_NO_TEXTEDIT
virtual void removeRenameBox();
#endif
virtual void calcRect( const QString &amp;text_ = QString::null );
virtual void paintItem( QPainter *p, const QColorGroup &amp;cg );
virtual void paintFocus( QPainter *p, const QColorGroup &amp;cg );
#ifndef QT_NO_DRAGANDDROP
virtual void dropped( QDropEvent *e, const QValueList&lt;QIconDragItem&gt; &amp;lst );
#endif
virtual void dragEntered();
virtual void dragLeft();
void setItemRect( const QRect &amp;r );
void setTextRect( const QRect &amp;r );
void setPixmapRect( const QRect &amp;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 &amp;pos ) const;
QIconViewItem *findItem( const QString &amp;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 &amp;r ) const;
QIconViewItem* findLastVisibleItem( const QRect &amp;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 &amp;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 &amp; );
virtual void setPalette( const QPalette &amp; );
bool isRenaming() const;
public slots:
virtual void arrangeItemsInGrid( const QSize &amp;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 &amp; );
void pressed( QIconViewItem * );
void pressed( QIconViewItem *, const QPoint &amp; );
void doubleClicked( QIconViewItem *item );
void returnPressed( QIconViewItem *item );
void rightButtonClicked( QIconViewItem* item, const QPoint&amp; pos );
void rightButtonPressed( QIconViewItem* item, const QPoint&amp; pos );
void mouseButtonPressed( int button, QIconViewItem* item, const QPoint&amp; pos );
void mouseButtonClicked( int button, QIconViewItem* item, const QPoint&amp; pos );
void contextMenuRequested( QIconViewItem* item, const QPoint &amp;pos );
#ifndef QT_NO_DRAGANDDROP
void dropped( QDropEvent *e, const QValueList&lt;QIconDragItem&gt; &amp;lst );
#endif
void moved();
void onItem( QIconViewItem *item );
void onViewport();
void itemRenamed( QIconViewItem *item, const QString &amp; );
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 &amp;r );
void emitSelectionChanged( QIconViewItem * i = 0 );
void emitRenamed( QIconViewItem *item );
QIconViewItem *makeRowLayout( QIconViewItem *begin, int &amp;y, bool &amp;changed );
void styleChange( QStyle&amp; );
void windowActivationChange( bool );
private:
void contentsMousePressEventEx( QMouseEvent *e );
virtual void drawDragShapes( const QPoint &amp;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 &amp;relativeTo,
const QRect &amp;searchRect ) const;
bool neighbourItem( Direction dir,
const QPoint &amp;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 &amp; );
QIconView&amp; operator=( const QIconView &amp; );
#endif
};
#endif // QT_NO_ICONVIEW
#endif // QICONVIEW_H
</pre>
<!-- eof -->
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt 3.3.8</div>
</table></div></address></body>
</html>