qiconviewitem.3qt

Linux下的基于X11的图形开发环境。

'\" t
.TH QIconViewItem 3qt "9 December 2002" "Trolltech AS" \" -*- nroff -*-
.\" Copyright 1992-2001 Trolltech AS.  All rights reserved.  See the
.\" license file included in the distribution for a complete license
.\" statement.
.\"
.ad l
.nh
.SH NAME
QIconViewItem \- Single item in a QIconView
.SH SYNOPSIS
\fC#include <qiconview.h>\fR
.PP
Inherits Qt.
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "\fBQIconViewItem\fR ( QIconView * parent )"
.br
.ti -1c
.BI "\fBQIconViewItem\fR ( QIconView * parent, QIconViewItem * after )"
.br
.ti -1c
.BI "\fBQIconViewItem\fR ( QIconView * parent, const QString & text )"
.br
.ti -1c
.BI "\fBQIconViewItem\fR ( QIconView * parent, QIconViewItem * after, const QString & text )"
.br
.ti -1c
.BI "\fBQIconViewItem\fR ( QIconView * parent, const QString & text, const QPixmap & icon )"
.br
.ti -1c
.BI "\fBQIconViewItem\fR ( QIconView * parent, QIconViewItem * after, const QString & text, const QPixmap & icon )"
.br
.ti -1c
.BI "\fBQIconViewItem\fR ( QIconView * parent, const QString & text, const QPicture & picture )"
.br
.ti -1c
.BI "\fBQIconViewItem\fR ( QIconView * parent, QIconViewItem * after, const QString & text, const QPicture & picture )"
.br
.ti -1c
.BI "virtual \fB~QIconViewItem\fR ()"
.br
.ti -1c
.BI "virtual void \fBsetRenameEnabled\fR ( bool allow )"
.br
.ti -1c
.BI "virtual void \fBsetDragEnabled\fR ( bool allow )"
.br
.ti -1c
.BI "virtual void \fBsetDropEnabled\fR ( bool allow )"
.br
.ti -1c
.BI "virtual QString \fBtext\fR () const"
.br
.ti -1c
.BI "virtual QPixmap * \fBpixmap\fR () const"
.br
.ti -1c
.BI "virtual QPicture * \fBpicture\fR () const"
.br
.ti -1c
.BI "virtual QString \fBkey\fR () const"
.br
.ti -1c
.BI "bool \fBrenameEnabled\fR () const"
.br
.ti -1c
.BI "bool \fBdragEnabled\fR () const"
.br
.ti -1c
.BI "bool \fBdropEnabled\fR () const"
.br
.ti -1c
.BI "QIconView * \fBiconView\fR () const"
.br
.ti -1c
.BI "QIconViewItem * \fBprevItem\fR () const"
.br
.ti -1c
.BI "QIconViewItem * \fBnextItem\fR () const"
.br
.ti -1c
.BI "int \fBindex\fR () const"
.br
.ti -1c
.BI "virtual void \fBsetSelected\fR ( bool s, bool cb )"
.br
.ti -1c
.BI "virtual void \fBsetSelected\fR ( bool s )"
.br
.ti -1c
.BI "virtual void \fBsetSelectable\fR ( bool enable )"
.br
.ti -1c
.BI "bool \fBisSelected\fR () const"
.br
.ti -1c
.BI "bool \fBisSelectable\fR () const"
.br
.ti -1c
.BI "virtual void \fBrepaint\fR ()"
.br
.ti -1c
.BI "virtual bool \fBmove\fR ( int x, int y )"
.br
.ti -1c
.BI "virtual void \fBmoveBy\fR ( int dx, int dy )"
.br
.ti -1c
.BI "virtual bool \fBmove\fR ( const QPoint & pnt )"
.br
.ti -1c
.BI "virtual void \fBmoveBy\fR ( const QPoint & pnt )"
.br
.ti -1c
.BI "QRect \fBrect\fR () const"
.br
.ti -1c
.BI "int \fBx\fR () const"
.br
.ti -1c
.BI "int \fBy\fR () const"
.br
.ti -1c
.BI "int \fBwidth\fR () const"
.br
.ti -1c
.BI "int \fBheight\fR () const"
.br
.ti -1c
.BI "QSize \fBsize\fR () const"
.br
.ti -1c
.BI "QPoint \fBpos\fR () const"
.br
.ti -1c
.BI "QRect \fBtextRect\fR ( bool relative = TRUE ) const"
.br
.ti -1c
.BI "QRect \fBpixmapRect\fR ( bool relative = TRUE ) const"
.br
.ti -1c
.BI "bool \fBcontains\fR ( const QPoint & pnt ) const"
.br
.ti -1c
.BI "bool \fBintersects\fR ( const QRect & r ) const"
.br
.ti -1c
.BI "virtual bool \fBacceptDrop\fR ( const QMimeSource * mime ) const"
.br
.ti -1c
.BI "void \fBrename\fR ()"
.br
.ti -1c
.BI "virtual int \fBcompare\fR ( QIconViewItem * i ) const"
.br
.ti -1c
.BI "virtual void \fBsetText\fR ( const QString & text )"
.br
.ti -1c
.BI "virtual void \fBsetPixmap\fR ( const QPixmap & icon )"
.br
.ti -1c
.BI "virtual void \fBsetPicture\fR ( const QPicture & icon )"
.br
.ti -1c
.BI "virtual void \fBsetText\fR ( const QString & text, bool recalc, bool redraw = TRUE )"
.br
.ti -1c
.BI "virtual void \fBsetPixmap\fR ( const QPixmap & icon, bool recalc, bool redraw = TRUE )"
.br
.ti -1c
.BI "virtual void \fBsetKey\fR ( const QString & k )"
.br
.ti -1c
.BI "virtual int \fBrtti\fR () const"
.br
.in -1c
.SS "Protected Members"
.in +1c
.ti -1c
.BI "virtual void \fBremoveRenameBox\fR ()"
.br
.ti -1c
.BI "virtual void \fBcalcRect\fR ( const QString & text_ = QString::null )"
.br
.ti -1c
.BI "virtual void \fBpaintItem\fR ( QPainter * p, const QColorGroup & cg )"
.br
.ti -1c
.BI "virtual void \fBpaintFocus\fR ( QPainter * p, const QColorGroup & cg )"
.br
.ti -1c
.BI "virtual void \fBdropped\fR ( QDropEvent * e, const QValueList<QIconDragItem> & lst )"
.br
.ti -1c
.BI "virtual void \fBdragEntered\fR ()"
.br
.ti -1c
.BI "virtual void \fBdragLeft\fR ()"
.br
.ti -1c
.BI "void \fBsetItemRect\fR ( const QRect & r )"
.br
.ti -1c
.BI "void \fBsetTextRect\fR ( const QRect & r )"
.br
.ti -1c
.BI "void \fBsetPixmapRect\fR ( const QRect & r )"
.br
.in -1c
.SH DESCRIPTION
The QIconViewItem class provides a single item in a QIconView.
.PP
A QIconViewItem contains an icon, a string and optionally a sort key, and can display itself in a QIconView.
.PP
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:
.PP
.nf
.br
    (void) new QIconViewItem(
.br
                    iconView,   // A pointer to a QIconView
.br
                    "This is the text of the item",
.br
                    aPixmap );
.br
.fi
.PP
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.
.PP
When the icon view is deleted all items in it are deleted automatically.
.PP
The QIconView::firstItem() and QIconViewItem::nextItem() functions provide a means of iterating over all the items in a QIconView:
.PP
.nf
.br
    QIconViewItem *item;
.br
    for ( item = iconView->firstItem(); item; item = item->nextItem() )
.br
        do_something_with( item );
.br
.fi
.PP
The item's icon view is available from iconView(), and its position in the icon view from index().
.PP
The item's selection status is available from isSelected() and is set and controlled by setSelected() and isSelectable().
.PP
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().
.PP
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().
.PP
To remove an item from an icon view, just delete the item. The QIconViewItem destructor removes it cleanly from its icon view.
.PP
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.
.PP
The class is designed to be very similar to QListView and QListBox in use, both via instantiation and subclassing.
.PP
See also Advanced Widgets.
.SH MEMBER FUNCTION DOCUMENTATION
.SH "QIconViewItem::QIconViewItem ( QIconView * parent )"
Constructs a QIconViewItem and inserts it into icon view \fIparent\fR with no text and a default icon.
.SH "QIconViewItem::QIconViewItem ( QIconView * parent, QIconViewItem * after )"
Constructs a QIconViewItem and inserts it into the icon view \fIparent\fR with no text and a default icon, after the icon view item \fIafter\fR.
.SH "QIconViewItem::QIconViewItem ( QIconView * parent, const QString & text )"
Constructs an icon view item and inserts it into the icon view \fIparent\fR using \fItext\fR as the text and a default icon.
.SH "QIconViewItem::QIconViewItem ( QIconView * parent, QIconViewItem * after, const QString & text )"
Constructs an icon view item and inserts it into the icon view \fIparent\fR using \fItext\fR as the text and a default icon, after the icon view item \fIafter\fR.
.SH "QIconViewItem::QIconViewItem ( QIconView * parent, const QString & text, const QPixmap & icon )"
Constructs an icon view item and inserts it into the icon view \fIparent\fR using \fItext\fR as the text and \fIicon\fR as the icon.
.SH "QIconViewItem::QIconViewItem ( QIconView * parent, QIconViewItem * after, const QString & text, const QPixmap & icon )"
Constructs an icon view item and inserts it into the icon view \fIparent\fR using \fItext\fR as the text and \fIicon\fR as the icon, after the icon view item \fIafter\fR.
.SH "QIconViewItem::QIconViewItem ( QIconView * parent, const QString & text, const QPicture & picture )"
Constructs an icon view item and inserts it into the icon view \fIparent\fR using \fItext\fR as the text and \fIpicture\fR as the icon.
.SH "QIconViewItem::QIconViewItem ( QIconView * parent, QIconViewItem * after, const QString & text, const QPicture & picture )"
Constructs an icon view item and inserts it into the icon view \fIparent\fR using \fItext\fR as the text and \fIpicture\fR as the icon, after the icon view item \fIafter\fR.
.SH "QIconViewItem::~QIconViewItem ()\fC [virtual]\fR"
Destroys the icon view item and tells the parent icon view that the item has been destroyed.
.SH "bool QIconViewItem::acceptDrop ( const QMimeSource * mime ) const\fC [virtual]\fR"
Returns TRUE if you can drop things with a QMimeSource of \fImime\fR onto this item; otherwise returns FALSE.
.PP
The default implementation always returns FALSE. You must subclass QIconViewItem and reimplement acceptDrop() to accept drops.