summaryrefslogtreecommitdiffstats
path: root/doc/html/qiconview.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/html/qiconview.html')
-rw-r--r--doc/html/qiconview.html1009
1 files changed, 1009 insertions, 0 deletions
diff --git a/doc/html/qiconview.html b/doc/html/qiconview.html
new file mode 100644
index 0000000..d619bbe
--- /dev/null
+++ b/doc/html/qiconview.html
@@ -0,0 +1,1009 @@
+<!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/src/iconview/qiconview.cpp:2261 -->
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>QIconView Class</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 Class Reference<br><small>[<a href="iconview.html">iconview module</a>]</small></h1>
+
+<p>The QIconView class provides an area with movable labelled icons.
+<a href="#details">More...</a>
+<p><tt>#include &lt;<a href="qiconview-h.html">qiconview.h</a>&gt;</tt>
+<p>Inherits <a href="qscrollview.html">QScrollView</a>.
+<p><a href="qiconview-members.html">List of all member functions.</a>
+<h2>Public Members</h2>
+<ul>
+<li class=fn>enum <a href="#SelectionMode-enum"><b>SelectionMode</b></a> { Single = 0, Multi, Extended, NoSelection }</li>
+<li class=fn>enum <a href="#Arrangement-enum"><b>Arrangement</b></a> { LeftToRight = 0, TopToBottom }</li>
+<li class=fn>enum <a href="#ResizeMode-enum"><b>ResizeMode</b></a> { Fixed = 0, Adjust }</li>
+<li class=fn>enum <a href="#ItemTextPos-enum"><b>ItemTextPos</b></a> { Bottom = 0, Right }</li>
+<li class=fn><a href="#QIconView"><b>QIconView</b></a> ( QWidget&nbsp;*&nbsp;parent = 0, const&nbsp;char&nbsp;*&nbsp;name = 0, WFlags&nbsp;f = 0 )</li>
+<li class=fn>virtual <a href="#~QIconView"><b>~QIconView</b></a> ()</li>
+<li class=fn>virtual void <a href="#insertItem"><b>insertItem</b></a> ( QIconViewItem&nbsp;*&nbsp;item, QIconViewItem&nbsp;*&nbsp;after = 0L )</li>
+<li class=fn>virtual void <a href="#takeItem"><b>takeItem</b></a> ( QIconViewItem&nbsp;*&nbsp;item )</li>
+<li class=fn>int <a href="#index"><b>index</b></a> ( const&nbsp;QIconViewItem&nbsp;*&nbsp;item ) const</li>
+<li class=fn>QIconViewItem * <a href="#firstItem"><b>firstItem</b></a> () const</li>
+<li class=fn>QIconViewItem * <a href="#lastItem"><b>lastItem</b></a> () const</li>
+<li class=fn>QIconViewItem * <a href="#currentItem"><b>currentItem</b></a> () const</li>
+<li class=fn>virtual void <a href="#setCurrentItem"><b>setCurrentItem</b></a> ( QIconViewItem&nbsp;*&nbsp;item )</li>
+<li class=fn>virtual void <a href="#setSelected"><b>setSelected</b></a> ( QIconViewItem&nbsp;*&nbsp;item, bool&nbsp;s, bool&nbsp;cb = FALSE )</li>
+<li class=fn>uint <a href="#count"><b>count</b></a> () const</li>
+<li class=fn>virtual void <a href="#setSelectionMode"><b>setSelectionMode</b></a> ( SelectionMode&nbsp;m )</li>
+<li class=fn>SelectionMode <a href="#selectionMode"><b>selectionMode</b></a> () const</li>
+<li class=fn>QIconViewItem * <a href="#findItem"><b>findItem</b></a> ( const&nbsp;QPoint&nbsp;&amp;&nbsp;pos ) const</li>
+<li class=fn>QIconViewItem * <a href="#findItem-2"><b>findItem</b></a> ( const&nbsp;QString&nbsp;&amp;&nbsp;text, ComparisonFlags&nbsp;compare = BeginsWith ) const</li>
+<li class=fn>virtual void <a href="#selectAll"><b>selectAll</b></a> ( bool&nbsp;select )</li>
+<li class=fn>virtual void <a href="#clearSelection"><b>clearSelection</b></a> ()</li>
+<li class=fn>virtual void <a href="#invertSelection"><b>invertSelection</b></a> ()</li>
+<li class=fn>virtual void <a href="#repaintItem"><b>repaintItem</b></a> ( QIconViewItem&nbsp;*&nbsp;item )</li>
+<li class=fn>void <a href="#repaintSelectedItems"><b>repaintSelectedItems</b></a> ()</li>
+<li class=fn>void <a href="#ensureItemVisible"><b>ensureItemVisible</b></a> ( QIconViewItem&nbsp;*&nbsp;item )</li>
+<li class=fn>QIconViewItem * <a href="#findFirstVisibleItem"><b>findFirstVisibleItem</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r ) const</li>
+<li class=fn>QIconViewItem * <a href="#findLastVisibleItem"><b>findLastVisibleItem</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r ) const</li>
+<li class=fn>virtual void <a href="#clear"><b>clear</b></a> ()</li>
+<li class=fn>virtual void <a href="#setGridX"><b>setGridX</b></a> ( int&nbsp;rx )</li>
+<li class=fn>virtual void <a href="#setGridY"><b>setGridY</b></a> ( int&nbsp;ry )</li>
+<li class=fn>int <a href="#gridX"><b>gridX</b></a> () const</li>
+<li class=fn>int <a href="#gridY"><b>gridY</b></a> () const</li>
+<li class=fn>virtual void <a href="#setSpacing"><b>setSpacing</b></a> ( int&nbsp;sp )</li>
+<li class=fn>int <a href="#spacing"><b>spacing</b></a> () const</li>
+<li class=fn>virtual void <a href="#setItemTextPos"><b>setItemTextPos</b></a> ( ItemTextPos&nbsp;pos )</li>
+<li class=fn>ItemTextPos <a href="#itemTextPos"><b>itemTextPos</b></a> () const</li>
+<li class=fn>virtual void <a href="#setItemTextBackground"><b>setItemTextBackground</b></a> ( const&nbsp;QBrush&nbsp;&amp;&nbsp;b )</li>
+<li class=fn>QBrush <a href="#itemTextBackground"><b>itemTextBackground</b></a> () const</li>
+<li class=fn>virtual void <a href="#setArrangement"><b>setArrangement</b></a> ( Arrangement&nbsp;am )</li>
+<li class=fn>Arrangement <a href="#arrangement"><b>arrangement</b></a> () const</li>
+<li class=fn>virtual void <a href="#setResizeMode"><b>setResizeMode</b></a> ( ResizeMode&nbsp;am )</li>
+<li class=fn>ResizeMode <a href="#resizeMode"><b>resizeMode</b></a> () const</li>
+<li class=fn>virtual void <a href="#setMaxItemWidth"><b>setMaxItemWidth</b></a> ( int&nbsp;w )</li>
+<li class=fn>int <a href="#maxItemWidth"><b>maxItemWidth</b></a> () const</li>
+<li class=fn>virtual void <a href="#setMaxItemTextLength"><b>setMaxItemTextLength</b></a> ( int&nbsp;w )</li>
+<li class=fn>int <a href="#maxItemTextLength"><b>maxItemTextLength</b></a> () const</li>
+<li class=fn>virtual void <a href="#setAutoArrange"><b>setAutoArrange</b></a> ( bool&nbsp;b )</li>
+<li class=fn>bool <a href="#autoArrange"><b>autoArrange</b></a> () const</li>
+<li class=fn>virtual void <a href="#setShowToolTips"><b>setShowToolTips</b></a> ( bool&nbsp;b )</li>
+<li class=fn>bool <a href="#showToolTips"><b>showToolTips</b></a> () const</li>
+<li class=fn>void <a href="#setSorting"><b>setSorting</b></a> ( bool&nbsp;sort, bool&nbsp;ascending = TRUE )</li>
+<li class=fn>bool <a href="#sorting"><b>sorting</b></a> () const</li>
+<li class=fn>bool <a href="#sortDirection"><b>sortDirection</b></a> () const</li>
+<li class=fn>virtual void <a href="#setItemsMovable"><b>setItemsMovable</b></a> ( bool&nbsp;b )</li>
+<li class=fn>bool <a href="#itemsMovable"><b>itemsMovable</b></a> () const</li>
+<li class=fn>virtual void <a href="#setWordWrapIconText"><b>setWordWrapIconText</b></a> ( bool&nbsp;b )</li>
+<li class=fn>bool <a href="#wordWrapIconText"><b>wordWrapIconText</b></a> () const</li>
+<li class=fn>virtual void <a href="#sort"><b>sort</b></a> ( bool&nbsp;ascending = TRUE )</li>
+<li class=fn>bool <a href="#isRenaming"><b>isRenaming</b></a> () const</li>
+</ul>
+<h2>Public Slots</h2>
+<ul>
+<li class=fn>virtual void <a href="#arrangeItemsInGrid"><b>arrangeItemsInGrid</b></a> ( const&nbsp;QSize&nbsp;&amp;&nbsp;grid, bool&nbsp;update = TRUE )</li>
+<li class=fn>virtual void <a href="#arrangeItemsInGrid-2"><b>arrangeItemsInGrid</b></a> ( bool&nbsp;update = TRUE )</li>
+</ul>
+<h2>Signals</h2>
+<ul>
+<li class=fn>void <a href="#selectionChanged"><b>selectionChanged</b></a> ()</li>
+<li class=fn>void <a href="#selectionChanged-2"><b>selectionChanged</b></a> ( QIconViewItem&nbsp;*&nbsp;item )</li>
+<li class=fn>void <a href="#currentChanged"><b>currentChanged</b></a> ( QIconViewItem&nbsp;*&nbsp;item )</li>
+<li class=fn>void <a href="#clicked"><b>clicked</b></a> ( QIconViewItem&nbsp;*&nbsp;item )</li>
+<li class=fn>void <a href="#clicked-2"><b>clicked</b></a> ( QIconViewItem&nbsp;*&nbsp;item, const&nbsp;QPoint&nbsp;&amp;&nbsp;pos )</li>
+<li class=fn>void <a href="#pressed"><b>pressed</b></a> ( QIconViewItem&nbsp;*&nbsp;item )</li>
+<li class=fn>void <a href="#pressed-2"><b>pressed</b></a> ( QIconViewItem&nbsp;*&nbsp;item, const&nbsp;QPoint&nbsp;&amp;&nbsp;pos )</li>
+<li class=fn>void <a href="#doubleClicked"><b>doubleClicked</b></a> ( QIconViewItem&nbsp;*&nbsp;item )</li>
+<li class=fn>void <a href="#returnPressed"><b>returnPressed</b></a> ( QIconViewItem&nbsp;*&nbsp;item )</li>
+<li class=fn>void <a href="#rightButtonClicked"><b>rightButtonClicked</b></a> ( QIconViewItem&nbsp;*&nbsp;item, const&nbsp;QPoint&nbsp;&amp;&nbsp;pos )</li>
+<li class=fn>void <a href="#rightButtonPressed"><b>rightButtonPressed</b></a> ( QIconViewItem&nbsp;*&nbsp;item, const&nbsp;QPoint&nbsp;&amp;&nbsp;pos )</li>
+<li class=fn>void <a href="#mouseButtonPressed"><b>mouseButtonPressed</b></a> ( int&nbsp;button, QIconViewItem&nbsp;*&nbsp;item, const&nbsp;QPoint&nbsp;&amp;&nbsp;pos )</li>
+<li class=fn>void <a href="#mouseButtonClicked"><b>mouseButtonClicked</b></a> ( int&nbsp;button, QIconViewItem&nbsp;*&nbsp;item, const&nbsp;QPoint&nbsp;&amp;&nbsp;pos )</li>
+<li class=fn>void <a href="#contextMenuRequested"><b>contextMenuRequested</b></a> ( QIconViewItem&nbsp;*&nbsp;item, const&nbsp;QPoint&nbsp;&amp;&nbsp;pos )</li>
+<li class=fn>void <a href="#dropped"><b>dropped</b></a> ( QDropEvent&nbsp;*&nbsp;e, const&nbsp;QValueList&lt;QIconDragItem&gt;&nbsp;&amp;&nbsp;lst )</li>
+<li class=fn>void <a href="#moved"><b>moved</b></a> ()</li>
+<li class=fn>void <a href="#onItem"><b>onItem</b></a> ( QIconViewItem&nbsp;*&nbsp;item )</li>
+<li class=fn>void <a href="#onViewport"><b>onViewport</b></a> ()</li>
+<li class=fn>void <a href="#itemRenamed"><b>itemRenamed</b></a> ( QIconViewItem&nbsp;*&nbsp;item, const&nbsp;QString&nbsp;&amp;&nbsp;name )</li>
+<li class=fn>void <a href="#itemRenamed-2"><b>itemRenamed</b></a> ( QIconViewItem&nbsp;*&nbsp;item )</li>
+</ul>
+<h2>Properties</h2>
+<ul>
+<li class=fn>Arrangement <a href="#arrangement-prop"><b>arrangement</b></a>&nbsp;- the arrangement mode of the icon view</li>
+<li class=fn>bool <a href="#autoArrange-prop"><b>autoArrange</b></a>&nbsp;- whether the icon view rearranges its items when a new item is inserted</li>
+<li class=fn>uint <a href="#count-prop"><b>count</b></a>&nbsp;- the number of items in the icon view &nbsp;<em>(read only)</em></li>
+<li class=fn>int <a href="#gridX-prop"><b>gridX</b></a>&nbsp;- the horizontal grid of the icon view</li>
+<li class=fn>int <a href="#gridY-prop"><b>gridY</b></a>&nbsp;- the vertical grid of the icon view</li>
+<li class=fn>QBrush <a href="#itemTextBackground-prop"><b>itemTextBackground</b></a>&nbsp;- the brush to use when drawing the background of an item's text</li>
+<li class=fn>ItemTextPos <a href="#itemTextPos-prop"><b>itemTextPos</b></a>&nbsp;- the position where the text of each item is drawn</li>
+<li class=fn>bool <a href="#itemsMovable-prop"><b>itemsMovable</b></a>&nbsp;- whether the user is allowed to move items around in the icon view</li>
+<li class=fn>int <a href="#maxItemTextLength-prop"><b>maxItemTextLength</b></a>&nbsp;- the maximum length (in characters) that an item's text may have</li>
+<li class=fn>int <a href="#maxItemWidth-prop"><b>maxItemWidth</b></a>&nbsp;- the maximum width that an item may have</li>
+<li class=fn>ResizeMode <a href="#resizeMode-prop"><b>resizeMode</b></a>&nbsp;- the resize mode of the icon view</li>
+<li class=fn>SelectionMode <a href="#selectionMode-prop"><b>selectionMode</b></a>&nbsp;- the selection mode of the icon view</li>
+<li class=fn>bool <a href="#showToolTips-prop"><b>showToolTips</b></a>&nbsp;- whether the icon view will display a tool tip with the complete text for any truncated item text</li>
+<li class=fn>bool <a href="#sortDirection-prop"><b>sortDirection</b></a>&nbsp;- whether the sort direction for inserting new items is ascending; &nbsp;<em>(read only)</em></li>
+<li class=fn>bool <a href="#sorting-prop"><b>sorting</b></a>&nbsp;- whether the icon view sorts on insertion &nbsp;<em>(read only)</em></li>
+<li class=fn>int <a href="#spacing-prop"><b>spacing</b></a>&nbsp;- the space in pixels between icon view items</li>
+<li class=fn>bool <a href="#wordWrapIconText-prop"><b>wordWrapIconText</b></a>&nbsp;- whether the item text will be word-wrapped if it is too long</li>
+</ul>
+<h2>Protected Members</h2>
+<ul>
+<li class=fn>virtual void <a href="#drawRubber"><b>drawRubber</b></a> ( QPainter&nbsp;*&nbsp;p )</li>
+<li class=fn>virtual QDragObject * <a href="#dragObject"><b>dragObject</b></a> ()</li>
+<li class=fn>virtual void <a href="#startDrag"><b>startDrag</b></a> ()</li>
+<li class=fn>virtual void <a href="#insertInGrid"><b>insertInGrid</b></a> ( QIconViewItem&nbsp;*&nbsp;item )</li>
+<li class=fn>virtual void <a href="#drawBackground"><b>drawBackground</b></a> ( QPainter&nbsp;*&nbsp;p, const&nbsp;QRect&nbsp;&amp;&nbsp;r )</li>
+<li class=fn>void <a href="#emitSelectionChanged"><b>emitSelectionChanged</b></a> ( QIconViewItem&nbsp;*&nbsp;i = 0 )</li>
+<li class=fn>QIconViewItem * <a href="#makeRowLayout"><b>makeRowLayout</b></a> ( QIconViewItem&nbsp;*&nbsp;begin, int&nbsp;&amp;&nbsp;y, bool&nbsp;&amp;&nbsp;changed )</li>
+</ul>
+<h2>Protected Slots</h2>
+<ul>
+<li class=fn>virtual void <a href="#doAutoScroll"><b>doAutoScroll</b></a> ()</li>
+<li class=fn>virtual void <a href="#adjustItems"><b>adjustItems</b></a> ()</li>
+<li class=fn>virtual void <a href="#slotUpdate"><b>slotUpdate</b></a> ()</li>
+</ul>
+<hr><a name="details"></a><h2>Detailed Description</h2>
+
+
+The QIconView class provides an area with movable labelled icons.
+<p>
+
+
+<p> A QIconView can display and manage a grid or other 2D layout of
+labelled icons. Each labelled icon is a <a href="qiconviewitem.html">QIconViewItem</a>. 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
+<a href="#draganddrop">drag and drop</a>.
+<p> 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 <a href="#ItemTextPos-enum">ItemTextPos</a>).
+<p> 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:
+<pre>
+ QIconView *iv = new QIconView( this );
+ <a href="qdir.html">QDir</a> dir( path, "*.xpm" );
+ for ( uint i = 0; i &lt; dir.<a href="qdir.html#count">count</a>(); i++ ) {
+ (void) new <a href="qiconviewitem.html">QIconViewItem</a>( iv, dir[i], QPixmap( path + dir[i] ) );
+ }
+ iv-&gt;<a href="qwidget.html#resize">resize</a>( 600, 400 );
+ iv-&gt;<a href="qwidget.html#show">show</a>();
+ </pre>
+
+<p> The <a href="qiconviewitem.html">QIconViewItem</a> call passes a pointer to the QIconView we wish to
+populate, along with the label text and a <a href="qpixmap.html">QPixmap</a>.
+<p> When an item is inserted the QIconView allocates a position for it.
+Existing items are rearranged if <a href="#autoArrange">autoArrange</a>() is TRUE. The
+default arrangement is <a href="#Arrangement-enum">LeftToRight</a> -- the QIconView fills up
+the <em>left-most</em> column from top to bottom, then moves one column
+<em>right</em> and fills that from top to bottom and so on. The
+arrangement can be modified with any of the following approaches:
+<ul>
+<li> Call <a href="#setArrangement">setArrangement</a>(), e.g. with <a href="#Arrangement-enum">TopToBottom</a> which will fill
+the <em>top-most</em> row from left to right, then moves one row <em>down</em>
+and fills that row from left to right and so on.
+<li> Construct each QIconViewItem using a constructor which allows
+you to specify which item the new one is to follow.
+<li> Call <a href="#setSorting">setSorting</a>() or <a href="#sort">sort</a>() to sort the items.
+</ul>
+<p> The spacing between items is set with <a href="#setSpacing">setSpacing</a>(). Items can be
+laid out using a fixed grid using <a href="#setGridX">setGridX</a>() and <a href="#setGridY">setGridY</a>(); by
+default the QIconView calculates a grid dynamically. The position
+of items' label text is set with <a href="#setItemTextPos">setItemTextPos</a>(). The text's
+background can be set with <a href="#setItemTextBackground">setItemTextBackground</a>(). The maximum
+width of an item and of its text are set with <a href="#setMaxItemWidth">setMaxItemWidth</a>()
+and <a href="#setMaxItemTextLength">setMaxItemTextLength</a>(). The label text will be word-wrapped if
+it is too long; this is controlled by <a href="#setWordWrapIconText">setWordWrapIconText</a>(). 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 <a href="#setShowToolTips">setShowToolTips</a>().
+<p> Items which are <a href="qiconviewitem.html#isSelectable">selectable</a> may be selected depending on the SelectionMode;
+the default is <a href="#SelectionMode-enum">Single</a>. Because QIconView offers multiple
+selection it must display <a href="focus.html#keyboard-focus">keyboard focus</a> and selection state
+separately. Therefore there are functions to set the selection
+state of an item (<a href="#setSelected">setSelected</a>()) and to select which item displays
+keyboard focus (<a href="#setCurrentItem">setCurrentItem</a>()). When multiple items may be
+selected the icon view provides a rubberband, too.
+<p> 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 <a href="qiconviewitem.html#setKey">QIconViewItem::setKey</a>() the new text will also
+serve as the key. (See <a href="qiconviewitem.html#setRenameEnabled">QIconViewItem::setRenameEnabled</a>().)
+<p> You can control whether users can move items themselves with
+<a href="#setItemsMovable">setItemsMovable</a>().
+<p> 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 <em>icon view</em>
+and then each subsequent (<a href="qiconviewitem.html#nextItem">QIconViewItem::nextItem</a>()) from each
+<em>item</em> in turn:
+<pre>
+ for ( <a href="qiconviewitem.html">QIconViewItem</a> *item = iv-&gt;firstItem(); item; item = item-&gt;<a href="qiconviewitem.html#nextItem">nextItem</a>() )
+ do_something( item );
+ </pre>
+
+QIconView also provides <a href="#currentItem">currentItem</a>(). You can search for an item
+using <a href="#findItem">findItem</a>() (searching by position or for label text) and
+with <a href="#findFirstVisibleItem">findFirstVisibleItem</a>() and <a href="#findLastVisibleItem">findLastVisibleItem</a>(). The number
+of items is returned by <a href="#count">count</a>(). An item can be removed from an
+icon view using <a href="#takeItem">takeItem</a>(); to delete an item use <tt>delete</tt>. All
+the items can be deleted with <a href="#clear">clear</a>().
+<p> The QIconView emits a wide range of useful signals, including
+<a href="#selectionChanged">selectionChanged</a>(), <a href="#currentChanged">currentChanged</a>(), <a href="#clicked">clicked</a>(), <a href="#moved">moved</a>() and
+<a href="#itemRenamed">itemRenamed</a>().
+<p> <a name="draganddrop"></a>
+<h3> Drag and Drop
+</h3>
+<a name="1"></a><p> 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.
+<p> The simple approach to dragging items out of the icon view is to
+subclass QIconView and reimplement <a href="#dragObject">QIconView::dragObject</a>().
+<p> <pre>
+ QDragObject *MyIconView::dragObject()
+ {
+ return new <a href="qtextdrag.html">QTextDrag</a>( <a href="#currentItem">currentItem</a>()-&gt;text(), this );
+ }
+ </pre>
+
+<p> In this example we create a <a href="qtextdrag.html">QTextDrag</a> object, (derived from
+<a href="qdragobject.html">QDragObject</a>), containing the item's label and return it as the drag
+object. We could just as easily have created a <a href="qimagedrag.html">QImageDrag</a> from the
+item's pixmap and returned that instead.
+<p> 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 <a href="#dropped">dropped</a>() signal. When a drop occurs this signal will be
+emitted with a QDragEvent and a <a href="qvaluelist.html">QValueList</a> of QIconDragItems. To
+make a <a href="qiconviewitem.html">QIconViewItem</a> into a drop target subclass QIconViewItem and
+reimplement <a href="qiconviewitem.html#acceptDrop">QIconViewItem::acceptDrop</a>() and
+<a href="qiconviewitem.html#dropped">QIconViewItem::dropped</a>().
+<p> <pre>
+ bool MyIconViewItem::acceptDrop( const <a href="qmimesource.html">QMimeSource</a> *mime ) const
+ {
+ if ( mime-&gt;<a href="qmimesource.html#provides">provides</a>( "text/plain" ) )
+ return TRUE;
+ return FALSE;
+ }
+
+ void MyIconViewItem::dropped( <a href="qdropevent.html">QDropEvent</a> *evt, const <a href="qvaluelist.html">QValueList</a>&lt;QIconDragItem&gt;&amp; )
+ {
+ <a href="qstring.html">QString</a> label;
+ if ( QTextDrag::<a href="qtextdrag.html#decode">decode</a>( evt, label ) )
+ setText( label );
+ }
+ </pre>
+
+<p> See <a href="iconview-simple_dd-main-h.html">iconview/simple_dd/main.h</a> and <a href="iconview-simple_dd-main-cpp.html">iconview/simple_dd/main.cpp</a> for a simple drag and drop example
+which demonstrates drag and drop between a QIconView and a
+<a href="qlistbox.html">QListBox</a>.
+<p> If you want to use extended drag-and-drop or have drag shapes drawn
+you must take a more sophisticated approach.
+<p> The first part is starting drags -- you should use a <a href="qicondrag.html">QIconDrag</a> (or a
+class derived from it) for the drag object. In <a href="#dragObject">dragObject</a>() 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 <a href="qicondragitem.html">QIconDragItem</a> for
+each selected item, and append these items with <a href="qicondrag.html#append">QIconDrag::append</a>() to
+the QIconDrag object. You can use <a href="qicondragitem.html#setData">QIconDragItem::setData</a>() 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.
+<p> When a drag enters the icon view, there is little to do. Simply
+connect to the <a href="#dropped">dropped</a>() signal and reimplement
+<a href="qiconviewitem.html#acceptDrop">QIconViewItem::acceptDrop</a>() and <a href="qiconviewitem.html#dropped">QIconViewItem::dropped</a>(). If you've
+used a <a href="qicondrag.html">QIconDrag</a> (or a subclass of it) the second argument to the
+dropped signal contains a <a href="qvaluelist.html">QValueList</a> of QIconDragItems -- you can
+access their data by calling <a href="qicondragitem.html#data">QIconDragItem::data</a>() on each one.
+<p> For an example implementation of complex drag-and-drop look at the
+fileiconview example (qt/examples/fileiconview).
+<p> <p>See also <a href="qiconviewitem.html#setDragEnabled">QIconViewItem::setDragEnabled</a>(), <a href="qiconviewitem.html#setDropEnabled">QIconViewItem::setDropEnabled</a>(), <a href="qiconviewitem.html#acceptDrop">QIconViewItem::acceptDrop</a>(), <a href="qiconviewitem.html#dropped">QIconViewItem::dropped</a>(), and <a href="advanced.html">Advanced Widgets</a>.
+
+<p> <img src=qiconview-m.png> <img src=qiconview-w.png>
+
+<hr><h2>Member Type Documentation</h2>
+<h3 class=fn><a name="Arrangement-enum"></a>QIconView::Arrangement</h3>
+
+<p> This enum type determines in which direction the items flow when
+the view runs out of space.
+<ul>
+<li><tt>QIconView::LeftToRight</tt> - Items which don't fit into the view cause the
+viewport to extend vertically (you get a vertical scrollbar).
+<li><tt>QIconView::TopToBottom</tt> - Items which don't fit into the view cause the
+viewport to extend horizontally (you get a horizontal scrollbar).
+</ul>
+<h3 class=fn><a name="ItemTextPos-enum"></a>QIconView::ItemTextPos</h3>
+
+<p> This enum type specifies the position of the item text in relation
+to the icon.
+<ul>
+<li><tt>QIconView::Bottom</tt> - The text is drawn below the icon.
+<li><tt>QIconView::Right</tt> - The text is drawn to the right of the icon.
+</ul>
+<h3 class=fn><a name="ResizeMode-enum"></a>QIconView::ResizeMode</h3>
+<p> 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:
+<ul>
+<li><tt>QIconView::Fixed</tt> - The icons' positions are not changed.
+<li><tt>QIconView::Adjust</tt> - The icons' positions are adjusted to be within the
+new geometry, if possible.
+</ul>
+<h3 class=fn><a name="SelectionMode-enum"></a>QIconView::SelectionMode</h3>
+
+<p> This enumerated type is used by QIconView to indicate how it
+reacts to selection by the user. It has four values:
+<ul>
+<li><tt>QIconView::Single</tt> - 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 <a href="#clearSelection">QIconView::clearSelection</a>().)
+<li><tt>QIconView::Multi</tt> - 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.
+<li><tt>QIconView::Extended</tt> - 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.
+<li><tt>QIconView::NoSelection</tt> - Items cannot be selected.
+</ul><p> To summarise: <a href="#SelectionMode-enum">Single</a> is a real single-selection icon view; <a href="#SelectionMode-enum">Multi</a> a real multi-selection icon view; <a href="#SelectionMode-enum">Extended</a> 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 <a href="#SelectionMode-enum">NoSelection</a> mode is for an icon view where the user can look but
+not touch.
+
+<hr><h2>Member Function Documentation</h2>
+<h3 class=fn><a name="QIconView"></a>QIconView::QIconView ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;parent = 0, const&nbsp;char&nbsp;*&nbsp;name = 0, WFlags&nbsp;f = 0 )
+</h3>
+Constructs an empty icon view called <em>name</em>, with parent <em>parent</em> and using the widget flags <em>f</em>.
+
+<h3 class=fn><a name="~QIconView"></a>QIconView::~QIconView ()<tt> [virtual]</tt>
+</h3>
+Destroys the icon view and deletes all items.
+
+<h3 class=fn>void <a name="adjustItems"></a>QIconView::adjustItems ()<tt> [virtual protected slot]</tt>
+</h3>
+Adjusts the positions of the items to the geometry of the icon
+view.
+
+<h3 class=fn>void <a name="arrangeItemsInGrid"></a>QIconView::arrangeItemsInGrid ( const&nbsp;<a href="qsize.html">QSize</a>&nbsp;&amp;&nbsp;grid, bool&nbsp;update = TRUE )<tt> [virtual slot]</tt>
+</h3>
+This variant uses <em>grid</em> instead of (<a href="#gridX">gridX</a>(), <a href="#gridY">gridY</a>()). If <em>grid</em> is invalid (see <a href="qsize.html#isValid">QSize::isValid</a>()), <a href="#arrangeItemsInGrid">arrangeItemsInGrid</a>()
+calculates a valid grid itself and uses that.
+<p> If <em>update</em> is TRUE (the default) the viewport is repainted.
+
+<p>Example: <a href="fileiconview-example.html#x807">fileiconview/qfileiconview.h</a>.
+<h3 class=fn>void <a name="arrangeItemsInGrid-2"></a>QIconView::arrangeItemsInGrid ( bool&nbsp;update = TRUE )<tt> [virtual slot]</tt>
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Arranges all the items in the grid given by <a href="#gridX">gridX</a>() and <a href="#gridY">gridY</a>().
+<p> Even if <a href="#sorting">sorting</a>() is enabled, the items are not sorted by this
+function. If you want to sort or rearrange the items, use
+iconview->sort(iconview->sortDirection()).
+<p> If <em>update</em> is TRUE (the default), the viewport is repainted as
+well.
+<p> <p>See also <a href="#gridX-prop">QIconView::gridX</a>, <a href="#gridY-prop">QIconView::gridY</a>, and <a href="#sort">QIconView::sort</a>().
+
+<h3 class=fn><a href="qiconview.html#Arrangement-enum">Arrangement</a> <a name="arrangement"></a>QIconView::arrangement () const
+</h3><p>Returns the arrangement mode of the icon view.
+See the <a href="qiconview.html#arrangement-prop">"arrangement"</a> property for details.
+<h3 class=fn>bool <a name="autoArrange"></a>QIconView::autoArrange () const
+</h3><p>Returns TRUE if the icon view rearranges its items when a new item is inserted; otherwise returns FALSE.
+See the <a href="qiconview.html#autoArrange-prop">"autoArrange"</a> property for details.
+<h3 class=fn>void <a name="clear"></a>QIconView::clear ()<tt> [virtual]</tt>
+</h3>
+Clears the icon view. All items are deleted.
+
+<h3 class=fn>void <a name="clearSelection"></a>QIconView::clearSelection ()<tt> [virtual]</tt>
+</h3>
+Unselects all the items.
+
+<h3 class=fn>void <a name="clicked"></a>QIconView::clicked ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when the user clicks any mouse button. If
+<em>item</em> is non-null, the cursor is on <em>item</em>. If <em>item</em> is null,
+the mouse cursor isn't on any item.
+<p> <p>See also <a href="#mouseButtonClicked">mouseButtonClicked</a>(), <a href="#rightButtonClicked">rightButtonClicked</a>(), and <a href="#pressed">pressed</a>().
+
+<h3 class=fn>void <a name="clicked-2"></a>QIconView::clicked ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item, const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;pos )<tt> [signal]</tt>
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> This signal is emitted when the user clicks any mouse button on an
+icon view item. <em>item</em> is a pointer to the item that has been
+clicked.
+<p> <em>pos</em> is the position of the mouse cursor in the global coordinate
+system (<a href="qmouseevent.html#globalPos">QMouseEvent::globalPos</a>()). (If the click's press and release
+differ by a pixel or two, <em>pos</em> is the position at release time.)
+<p> <p>See also <a href="#mouseButtonClicked">mouseButtonClicked</a>(), <a href="#rightButtonClicked">rightButtonClicked</a>(), and <a href="#pressed">pressed</a>().
+
+<h3 class=fn>void <a name="contextMenuRequested"></a>QIconView::contextMenuRequested ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item, const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;pos )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when the user invokes a context menu with
+the right mouse button or with special system keys, with <em>item</em>
+being the item under the mouse cursor or the current item,
+respectively.
+<p> <em>pos</em> is the position for the context menu in the global
+coordinate system.
+
+<h3 class=fn>uint <a name="count"></a>QIconView::count () const
+</h3><p>Returns the number of items in the icon view.
+See the <a href="qiconview.html#count-prop">"count"</a> property for details.
+<h3 class=fn>void <a name="currentChanged"></a>QIconView::currentChanged ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when a new item becomes current. <em>item</em> is
+the new current item (or 0 if no item is now current).
+<p> <p>See also <a href="#currentItem">currentItem</a>().
+
+<h3 class=fn><a href="qiconviewitem.html">QIconViewItem</a>&nbsp;* <a name="currentItem"></a>QIconView::currentItem () const
+</h3>
+Returns a pointer to the current item of the icon view, or 0 if no
+item is current.
+<p> <p>See also <a href="#setCurrentItem">setCurrentItem</a>(), <a href="#firstItem">firstItem</a>(), and <a href="#lastItem">lastItem</a>().
+
+<h3 class=fn>void <a name="doAutoScroll"></a>QIconView::doAutoScroll ()<tt> [virtual protected slot]</tt>
+</h3>
+Performs autoscrolling when selecting multiple icons with the
+rubber band.
+
+<h3 class=fn>void <a name="doubleClicked"></a>QIconView::doubleClicked ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when the user double-clicks on <em>item</em>.
+
+<h3 class=fn><a href="qdragobject.html">QDragObject</a>&nbsp;* <a name="dragObject"></a>QIconView::dragObject ()<tt> [virtual protected]</tt>
+</h3>
+Returns the <a href="qdragobject.html">QDragObject</a> 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.
+<p> <p>See also <a href="qicondrag.html">QIconDrag</a>.
+
+<p>Examples: <a href="fileiconview-example.html#x834">fileiconview/qfileiconview.cpp</a> and <a href="simple_dd-example.html#x2820">iconview/simple_dd/main.cpp</a>.
+<h3 class=fn>void <a name="drawBackground"></a>QIconView::drawBackground ( <a href="qpainter.html">QPainter</a>&nbsp;*&nbsp;p, const&nbsp;<a href="qrect.html">QRect</a>&nbsp;&amp;&nbsp;r )<tt> [virtual protected]</tt>
+</h3>
+This function is called to draw the rectangle <em>r</em> of the
+background using the painter <em>p</em>.
+<p> The default implementation fills <em>r</em> with the viewport's
+<a href="qwidget.html#backgroundBrush">backgroundBrush</a>(). Subclasses may reimplement this to draw custom
+backgrounds.
+<p> <p>See also <a href="qscrollview.html#contentsX-prop">contentsX</a>, <a href="qscrollview.html#contentsY-prop">contentsY</a>, and <a href="qscrollview.html#drawContents">drawContents</a>().
+
+<h3 class=fn>void <a name="drawRubber"></a>QIconView::drawRubber ( <a href="qpainter.html">QPainter</a>&nbsp;*&nbsp;p )<tt> [virtual protected]</tt>
+</h3>
+Draws the rubber band using the painter <em>p</em>.
+
+<h3 class=fn>void <a name="dropped"></a>QIconView::dropped ( <a href="qdropevent.html">QDropEvent</a>&nbsp;*&nbsp;e, const&nbsp;<a href="qvaluelist.html">QValueList</a>&lt;QIconDragItem&gt;&nbsp;&amp;&nbsp;lst )<tt> [signal]</tt>
+</h3>
+
+<p> 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.
+<p> <em>e</em> provides all the information about the drop. If the drag
+object of the drop was a <a href="qicondrag.html">QIconDrag</a>, <em>lst</em> contains the list of
+the dropped items. You can get the data using
+<a href="qicondragitem.html#data">QIconDragItem::data</a>() on each item. If the <em>lst</em> is empty, i.e.
+the drag was not a QIconDrag, you have to decode the data in <em>e</em>
+and work with that.
+<p> Note QIconViewItems may be drop targets; if a drop event occurs on
+an item the item handles the drop.
+
+<p>Examples: <a href="iconview-example.html#x1455">iconview/main.cpp</a> and <a href="simple_dd-example.html#x2821">iconview/simple_dd/main.cpp</a>.
+<h3 class=fn>void <a name="emitSelectionChanged"></a>QIconView::emitSelectionChanged ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;i = 0 )<tt> [protected]</tt>
+</h3>
+Emits a signal to indicate selection changes. <em>i</em> is the
+<a href="qiconviewitem.html">QIconViewItem</a> that was selected or de-selected.
+<p> <em>You should never need to call this function.</em>
+
+<h3 class=fn>void <a name="ensureItemVisible"></a>QIconView::ensureItemVisible ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item )
+</h3>
+Makes sure that <em>item</em> is entirely visible. If necessary,
+<a href="#ensureItemVisible">ensureItemVisible</a>() scrolls the icon view.
+<p> <p>See also <a href="qscrollview.html#ensureVisible">ensureVisible</a>().
+
+<h3 class=fn><a href="qiconviewitem.html">QIconViewItem</a>&nbsp;* <a name="findFirstVisibleItem"></a>QIconView::findFirstVisibleItem ( const&nbsp;<a href="qrect.html">QRect</a>&nbsp;&amp;&nbsp;r ) const
+</h3>
+Finds the first item whose bounding rectangle overlaps <em>r</em> and
+returns a pointer to that item. <em>r</em> is given in content
+coordinates. Returns 0 if no item overlaps <em>r</em>.
+<p> If you want to find all items that touch <em>r</em>, you will need to
+use this function and nextItem() in a loop ending at
+<a href="#findLastVisibleItem">findLastVisibleItem</a>() and test <a href="qiconviewitem.html#rect">QIconViewItem::rect</a>() for each of
+these items.
+<p> <p>See also <a href="#findLastVisibleItem">findLastVisibleItem</a>() and <a href="qiconviewitem.html#rect">QIconViewItem::rect</a>().
+
+<h3 class=fn><a href="qiconviewitem.html">QIconViewItem</a>&nbsp;* <a name="findItem"></a>QIconView::findItem ( const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;pos ) const
+</h3>
+Returns a pointer to the item that contains point <em>pos</em>, which is
+given in contents coordinates, or 0 if no item contains point <em>pos</em>.
+
+<h3 class=fn><a href="qiconviewitem.html">QIconViewItem</a>&nbsp;* <a name="findItem-2"></a>QIconView::findItem ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;text, ComparisonFlags&nbsp;compare = BeginsWith ) const
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Returns a pointer to the first item whose text begins with <em>text</em>, or 0 if no such item could be found. Use the <em>compare</em> flag
+to control the comparison behaviour. (See <a href="qt.html#StringComparisonMode-enum">Qt::StringComparisonMode</a>.)
+
+<h3 class=fn><a href="qiconviewitem.html">QIconViewItem</a>&nbsp;* <a name="findLastVisibleItem"></a>QIconView::findLastVisibleItem ( const&nbsp;<a href="qrect.html">QRect</a>&nbsp;&amp;&nbsp;r ) const
+</h3>
+Finds the last item whose bounding rectangle overlaps <em>r</em> and
+returns a pointer to that item. <em>r</em> is given in content
+coordinates. Returns 0 if no item overlaps <em>r</em>.
+<p> <p>See also <a href="#findFirstVisibleItem">findFirstVisibleItem</a>().
+
+<h3 class=fn><a href="qiconviewitem.html">QIconViewItem</a>&nbsp;* <a name="firstItem"></a>QIconView::firstItem () const
+</h3>
+Returns a pointer to the first item of the icon view, or 0 if
+there are no items in the icon view.
+<p> <p>See also <a href="#lastItem">lastItem</a>() and <a href="#currentItem">currentItem</a>().
+
+<h3 class=fn>int <a name="gridX"></a>QIconView::gridX () const
+</h3><p>Returns the horizontal grid of the icon view.
+See the <a href="qiconview.html#gridX-prop">"gridX"</a> property for details.
+<h3 class=fn>int <a name="gridY"></a>QIconView::gridY () const
+</h3><p>Returns the vertical grid of the icon view.
+See the <a href="qiconview.html#gridY-prop">"gridY"</a> property for details.
+<h3 class=fn>int <a name="index"></a>QIconView::index ( const&nbsp;<a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item ) const
+</h3>
+Returns the index of <em>item</em>, or -1 if <em>item</em> doesn't exist in
+this icon view.
+
+<h3 class=fn>void <a name="insertInGrid"></a>QIconView::insertInGrid ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item )<tt> [virtual protected]</tt>
+</h3>
+Inserts the <a href="qiconviewitem.html">QIconViewItem</a> <em>item</em> in the icon view's grid. <em>You should never need to call this function.</em> Instead, insert
+QIconViewItems by creating them with a pointer to the QIconView
+that they are to be inserted into.
+
+<h3 class=fn>void <a name="insertItem"></a>QIconView::insertItem ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item, <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;after = 0L )<tt> [virtual]</tt>
+</h3>
+Inserts the icon view item <em>item</em> after <em>after</em>. If <em>after</em> is
+0, <em>item</em> is appended after the last item.
+<p> <em>You should never need to call this function.</em> Instead create
+<a href="qiconviewitem.html">QIconViewItem</a>'s and associate them with your icon view like this:
+<p> <pre>
+ (void) new <a href="qiconviewitem.html">QIconViewItem</a>( myIconview, "The text of the item", aPixmap );
+ </pre>
+
+
+<h3 class=fn>void <a name="invertSelection"></a>QIconView::invertSelection ()<tt> [virtual]</tt>
+</h3>
+Inverts the selection. Works only in Multi and Extended selection
+mode.
+
+<h3 class=fn>bool <a name="isRenaming"></a>QIconView::isRenaming () const
+</h3>
+Returns TRUE if an iconview item is being renamed; otherwise
+returns FALSE.
+
+<h3 class=fn>void <a name="itemRenamed"></a>QIconView::itemRenamed ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;name )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when <em>item</em> has been renamed to <em>name</em>,
+usually by in-place renaming.
+<p> <p>See also <a href="qiconviewitem.html#setRenameEnabled">QIconViewItem::setRenameEnabled</a>() and <a href="qiconviewitem.html#rename">QIconViewItem::rename</a>().
+
+<h3 class=fn>void <a name="itemRenamed-2"></a>QIconView::itemRenamed ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item )<tt> [signal]</tt>
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> This signal is emitted when <em>item</em> has been renamed, usually by
+in-place renaming.
+<p> <p>See also <a href="qiconviewitem.html#setRenameEnabled">QIconViewItem::setRenameEnabled</a>() and <a href="qiconviewitem.html#rename">QIconViewItem::rename</a>().
+
+<h3 class=fn><a href="qbrush.html">QBrush</a> <a name="itemTextBackground"></a>QIconView::itemTextBackground () const
+</h3><p>Returns the brush to use when drawing the background of an item's text.
+See the <a href="qiconview.html#itemTextBackground-prop">"itemTextBackground"</a> property for details.
+<h3 class=fn><a href="qiconview.html#ItemTextPos-enum">ItemTextPos</a> <a name="itemTextPos"></a>QIconView::itemTextPos () const
+</h3><p>Returns the position where the text of each item is drawn.
+See the <a href="qiconview.html#itemTextPos-prop">"itemTextPos"</a> property for details.
+<h3 class=fn>bool <a name="itemsMovable"></a>QIconView::itemsMovable () const
+</h3><p>Returns TRUE if the user is allowed to move items around in the icon view; otherwise returns FALSE.
+See the <a href="qiconview.html#itemsMovable-prop">"itemsMovable"</a> property for details.
+<h3 class=fn><a href="qiconviewitem.html">QIconViewItem</a>&nbsp;* <a name="lastItem"></a>QIconView::lastItem () const
+</h3>
+Returns a pointer to the last item of the icon view, or 0 if there
+are no items in the icon view.
+<p> <p>See also <a href="#firstItem">firstItem</a>() and <a href="#currentItem">currentItem</a>().
+
+<h3 class=fn><a href="qiconviewitem.html">QIconViewItem</a>&nbsp;* <a name="makeRowLayout"></a>QIconView::makeRowLayout ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;begin, int&nbsp;&amp;&nbsp;y, bool&nbsp;&amp;&nbsp;changed )<tt> [protected]</tt>
+</h3>
+Lays out a row of icons (if Arrangement == <a href="#Arrangement-enum">TopToBottom</a> this is
+a column). Starts laying out with the item <em>begin</em>. <em>y</em> is the
+starting coordinate. Returns the last item of the row (column) and
+sets the new starting coordinate to <em>y</em>. The <em>changed</em> parameter
+is used internally.
+<p> <b>Warning:</b> This function may be made private in a future version of
+Qt. We do not recommend calling it.
+
+<h3 class=fn>int <a name="maxItemTextLength"></a>QIconView::maxItemTextLength () const
+</h3><p>Returns the maximum length (in characters) that an item's text may have.
+See the <a href="qiconview.html#maxItemTextLength-prop">"maxItemTextLength"</a> property for details.
+<h3 class=fn>int <a name="maxItemWidth"></a>QIconView::maxItemWidth () const
+</h3><p>Returns the maximum width that an item may have.
+See the <a href="qiconview.html#maxItemWidth-prop">"maxItemWidth"</a> property for details.
+<h3 class=fn>void <a name="mouseButtonClicked"></a>QIconView::mouseButtonClicked ( int&nbsp;button, <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item, const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;pos )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when the user clicks mouse button <em>button</em>. If <em>item</em> is non-null, the cursor is on <em>item</em>. If <em>item</em> is null, the mouse cursor isn't on any item.
+<p> <em>pos</em> is the position of the mouse cursor in the global
+coordinate system (<a href="qmouseevent.html#globalPos">QMouseEvent::globalPos</a>()). (If the click's
+press and release differ by a pixel or two, <em>pos</em> is the
+position at release time.)
+<p> <p>See also <a href="#mouseButtonPressed">mouseButtonPressed</a>(), <a href="#rightButtonClicked">rightButtonClicked</a>(), and <a href="#clicked">clicked</a>().
+
+<h3 class=fn>void <a name="mouseButtonPressed"></a>QIconView::mouseButtonPressed ( int&nbsp;button, <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item, const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;pos )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when the user presses mouse button <em>button</em>. If <em>item</em> is non-null, the cursor is on <em>item</em>. If <em>item</em> is null, the mouse cursor isn't on any item.
+<p> <em>pos</em> is the position of the mouse cursor in the global
+coordinate system (<a href="qmouseevent.html#globalPos">QMouseEvent::globalPos</a>()).
+<p> <p>See also <a href="#rightButtonClicked">rightButtonClicked</a>() and <a href="#pressed">pressed</a>().
+
+<h3 class=fn>void <a name="moved"></a>QIconView::moved ()<tt> [signal]</tt>
+</h3>
+
+<p> 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.
+
+<p>Example: <a href="iconview-example.html#x1456">iconview/main.cpp</a>.
+<h3 class=fn>void <a name="onItem"></a>QIconView::onItem ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when the user moves the mouse cursor onto
+an <em>item</em>, similar to the <a href="qwidget.html#enterEvent">QWidget::enterEvent</a>() function.
+
+<h3 class=fn>void <a name="onViewport"></a>QIconView::onViewport ()<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when the user moves the mouse cursor from
+an item to an empty part of the icon view.
+<p> <p>See also <a href="#onItem">onItem</a>().
+
+<h3 class=fn>void <a name="pressed"></a>QIconView::pressed ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when the user presses any mouse button. If
+<em>item</em> is non-null, the cursor is on <em>item</em>. If <em>item</em> is null,
+the mouse cursor isn't on any item.
+<p> <p>See also <a href="#mouseButtonPressed">mouseButtonPressed</a>(), <a href="#rightButtonPressed">rightButtonPressed</a>(), and <a href="#clicked">clicked</a>().
+
+<h3 class=fn>void <a name="pressed-2"></a>QIconView::pressed ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item, const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;pos )<tt> [signal]</tt>
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> This signal is emitted when the user presses any mouse button. If
+<em>item</em> is non-null, the cursor is on <em>item</em>. If <em>item</em> is null,
+the mouse cursor isn't on any item.
+<p> <em>pos</em> is the position of the mouse cursor in the global
+coordinate system (<a href="qmouseevent.html#globalPos">QMouseEvent::globalPos</a>()). (If the click's
+press and release differ by a pixel or two, <em>pos</em> is the
+position at release time.)
+<p> <p>See also <a href="#mouseButtonPressed">mouseButtonPressed</a>(), <a href="#rightButtonPressed">rightButtonPressed</a>(), and <a href="#clicked">clicked</a>().
+
+<h3 class=fn>void <a name="repaintItem"></a>QIconView::repaintItem ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item )<tt> [virtual]</tt>
+</h3>
+Repaints the <em>item</em>.
+
+<h3 class=fn>void <a name="repaintSelectedItems"></a>QIconView::repaintSelectedItems ()
+</h3>
+Repaints the selected items.
+
+<h3 class=fn><a href="qiconview.html#ResizeMode-enum">ResizeMode</a> <a name="resizeMode"></a>QIconView::resizeMode () const
+</h3><p>Returns the resize mode of the icon view.
+See the <a href="qiconview.html#resizeMode-prop">"resizeMode"</a> property for details.
+<h3 class=fn>void <a name="returnPressed"></a>QIconView::returnPressed ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted if the user presses the Return or Enter
+key. <em>item</em> is the <a href="#currentItem">currentItem</a>() at the time of the keypress.
+
+<h3 class=fn>void <a name="rightButtonClicked"></a>QIconView::rightButtonClicked ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item, const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;pos )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when the user clicks the right mouse
+button. If <em>item</em> is non-null, the cursor is on <em>item</em>. If <em>item</em> is null, the mouse cursor isn't on any item.
+<p> <em>pos</em> is the position of the mouse cursor in the global
+coordinate system (<a href="qmouseevent.html#globalPos">QMouseEvent::globalPos</a>()). (If the click's
+press and release differ by a pixel or two, <em>pos</em> is the
+position at release time.)
+<p> <p>See also <a href="#rightButtonPressed">rightButtonPressed</a>(), <a href="#mouseButtonClicked">mouseButtonClicked</a>(), and <a href="#clicked">clicked</a>().
+
+<h3 class=fn>void <a name="rightButtonPressed"></a>QIconView::rightButtonPressed ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item, const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;pos )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when the user presses the right mouse
+button. If <em>item</em> is non-null, the cursor is on <em>item</em>. If <em>item</em> is null, the mouse cursor isn't on any item.
+<p> <em>pos</em> is the position of the mouse cursor in the global
+coordinate system (<a href="qmouseevent.html#globalPos">QMouseEvent::globalPos</a>()).
+
+<h3 class=fn>void <a name="selectAll"></a>QIconView::selectAll ( bool&nbsp;select )<tt> [virtual]</tt>
+</h3>
+In Multi and Extended modes, this function sets all items to be
+selected if <em>select</em> is TRUE, and to be unselected if <em>select</em>
+is FALSE.
+<p> In Single and NoSelection modes, this function only changes the
+selection status of <a href="#currentItem">currentItem</a>().
+
+<h3 class=fn>void <a name="selectionChanged"></a>QIconView::selectionChanged ()<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when the selection has been changed. It's
+emitted in each selection mode.
+
+<h3 class=fn>void <a name="selectionChanged-2"></a>QIconView::selectionChanged ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item )<tt> [signal]</tt>
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> This signal is emitted when the selection changes. <em>item</em> is the
+newly selected item. This signal is emitted only in single
+selection mode.
+
+<h3 class=fn><a href="qiconview.html#SelectionMode-enum">SelectionMode</a> <a name="selectionMode"></a>QIconView::selectionMode () const
+</h3><p>Returns the selection mode of the icon view.
+See the <a href="qiconview.html#selectionMode-prop">"selectionMode"</a> property for details.
+<h3 class=fn>void <a name="setArrangement"></a>QIconView::setArrangement ( <a href="qiconview.html#Arrangement-enum">Arrangement</a>&nbsp;am )<tt> [virtual]</tt>
+</h3><p>Sets the arrangement mode of the icon view to <em>am</em>.
+See the <a href="qiconview.html#arrangement-prop">"arrangement"</a> property for details.
+<h3 class=fn>void <a name="setAutoArrange"></a>QIconView::setAutoArrange ( bool&nbsp;b )<tt> [virtual]</tt>
+</h3><p>Sets whether the icon view rearranges its items when a new item is inserted to <em>b</em>.
+See the <a href="qiconview.html#autoArrange-prop">"autoArrange"</a> property for details.
+<h3 class=fn>void <a name="setCurrentItem"></a>QIconView::setCurrentItem ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item )<tt> [virtual]</tt>
+</h3>
+Makes <em>item</em> the new current item of the icon view.
+
+<h3 class=fn>void <a name="setGridX"></a>QIconView::setGridX ( int&nbsp;rx )<tt> [virtual]</tt>
+</h3><p>Sets the horizontal grid of the icon view to <em>rx</em>.
+See the <a href="qiconview.html#gridX-prop">"gridX"</a> property for details.
+<h3 class=fn>void <a name="setGridY"></a>QIconView::setGridY ( int&nbsp;ry )<tt> [virtual]</tt>
+</h3><p>Sets the vertical grid of the icon view to <em>ry</em>.
+See the <a href="qiconview.html#gridY-prop">"gridY"</a> property for details.
+<h3 class=fn>void <a name="setItemTextBackground"></a>QIconView::setItemTextBackground ( const&nbsp;<a href="qbrush.html">QBrush</a>&nbsp;&amp;&nbsp;b )<tt> [virtual]</tt>
+</h3><p>Sets the brush to use when drawing the background of an item's text to <em>b</em>.
+See the <a href="qiconview.html#itemTextBackground-prop">"itemTextBackground"</a> property for details.
+<h3 class=fn>void <a name="setItemTextPos"></a>QIconView::setItemTextPos ( <a href="qiconview.html#ItemTextPos-enum">ItemTextPos</a>&nbsp;pos )<tt> [virtual]</tt>
+</h3><p>Sets the position where the text of each item is drawn to <em>pos</em>.
+See the <a href="qiconview.html#itemTextPos-prop">"itemTextPos"</a> property for details.
+<h3 class=fn>void <a name="setItemsMovable"></a>QIconView::setItemsMovable ( bool&nbsp;b )<tt> [virtual]</tt>
+</h3><p>Sets whether the user is allowed to move items around in the icon view to <em>b</em>.
+See the <a href="qiconview.html#itemsMovable-prop">"itemsMovable"</a> property for details.
+<h3 class=fn>void <a name="setMaxItemTextLength"></a>QIconView::setMaxItemTextLength ( int&nbsp;w )<tt> [virtual]</tt>
+</h3><p>Sets the maximum length (in characters) that an item's text may have to <em>w</em>.
+See the <a href="qiconview.html#maxItemTextLength-prop">"maxItemTextLength"</a> property for details.
+<h3 class=fn>void <a name="setMaxItemWidth"></a>QIconView::setMaxItemWidth ( int&nbsp;w )<tt> [virtual]</tt>
+</h3><p>Sets the maximum width that an item may have to <em>w</em>.
+See the <a href="qiconview.html#maxItemWidth-prop">"maxItemWidth"</a> property for details.
+<h3 class=fn>void <a name="setResizeMode"></a>QIconView::setResizeMode ( <a href="qiconview.html#ResizeMode-enum">ResizeMode</a>&nbsp;am )<tt> [virtual]</tt>
+</h3><p>Sets the resize mode of the icon view to <em>am</em>.
+See the <a href="qiconview.html#resizeMode-prop">"resizeMode"</a> property for details.
+<h3 class=fn>void <a name="setSelected"></a>QIconView::setSelected ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item, bool&nbsp;s, bool&nbsp;cb = FALSE )<tt> [virtual]</tt>
+</h3>
+Selects or unselects <em>item</em> depending on <em>s</em>, and may also
+unselect other items, depending on <a href="#selectionMode">QIconView::selectionMode</a>() and
+<em>cb</em>.
+<p> If <em>s</em> is FALSE, <em>item</em> is unselected.
+<p> If <em>s</em> is TRUE and QIconView::selectionMode() is <a href="#SelectionMode-enum">Single</a>, <em>item</em> is selected, and the item which was selected is unselected.
+<p> If <em>s</em> is TRUE and QIconView::selectionMode() is <a href="#SelectionMode-enum">Extended</a>, <em>item</em> is selected. If <em>cb</em> is TRUE, the selection state of the
+icon view's other items is left unchanged. If <em>cb</em> is FALSE (the
+default) all other items are unselected.
+<p> If <em>s</em> is TRUE and QIconView::selectionMode() is <a href="#SelectionMode-enum">Multi</a> <em>item</em>
+is selected.
+<p> Note that <em>cb</em> is used only if QIconView::selectionMode() is <a href="#SelectionMode-enum">Extended</a>. <em>cb</em> defaults to FALSE.
+<p> All items whose selection status is changed repaint themselves.
+
+<h3 class=fn>void <a name="setSelectionMode"></a>QIconView::setSelectionMode ( <a href="qiconview.html#SelectionMode-enum">SelectionMode</a>&nbsp;m )<tt> [virtual]</tt>
+</h3><p>Sets the selection mode of the icon view to <em>m</em>.
+See the <a href="qiconview.html#selectionMode-prop">"selectionMode"</a> property for details.
+<h3 class=fn>void <a name="setShowToolTips"></a>QIconView::setShowToolTips ( bool&nbsp;b )<tt> [virtual]</tt>
+</h3><p>Sets whether the icon view will display a tool tip with the complete text for any truncated item text to <em>b</em>.
+See the <a href="qiconview.html#showToolTips-prop">"showToolTips"</a> property for details.
+<h3 class=fn>void <a name="setSorting"></a>QIconView::setSorting ( bool&nbsp;sort, bool&nbsp;ascending = TRUE )
+</h3>
+If <em>sort</em> is TRUE, this function sets the icon view to sort items
+when a new item is inserted. If <em>sort</em> is FALSE, the icon view
+will not be sorted.
+<p> Note that <a href="#autoArrange">autoArrange</a>() must be TRUE for sorting to take place.
+<p> If <em>ascending</em> is TRUE (the default), items are sorted in
+ascending order. If <em>ascending</em> is FALSE, items are sorted in
+descending order.
+<p> <a href="qiconviewitem.html#compare">QIconViewItem::compare</a>() 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.
+<p> <p>See also <a href="#autoArrange-prop">QIconView::autoArrange</a>, <a href="#autoArrange-prop">QIconView::autoArrange</a>, <a href="#sortDirection-prop">sortDirection</a>, <a href="#sort">sort</a>(), and <a href="qiconviewitem.html#setKey">QIconViewItem::setKey</a>().
+
+<h3 class=fn>void <a name="setSpacing"></a>QIconView::setSpacing ( int&nbsp;sp )<tt> [virtual]</tt>
+</h3><p>Sets the space in pixels between icon view items to <em>sp</em>.
+See the <a href="qiconview.html#spacing-prop">"spacing"</a> property for details.
+<h3 class=fn>void <a name="setWordWrapIconText"></a>QIconView::setWordWrapIconText ( bool&nbsp;b )<tt> [virtual]</tt>
+</h3><p>Sets whether the item text will be word-wrapped if it is too long to <em>b</em>.
+See the <a href="qiconview.html#wordWrapIconText-prop">"wordWrapIconText"</a> property for details.
+<h3 class=fn>bool <a name="showToolTips"></a>QIconView::showToolTips () const
+</h3><p>Returns TRUE if the icon view will display a tool tip with the complete text for any truncated item text; otherwise returns FALSE.
+See the <a href="qiconview.html#showToolTips-prop">"showToolTips"</a> property for details.
+<h3 class=fn>void <a name="slotUpdate"></a>QIconView::slotUpdate ()<tt> [virtual protected slot]</tt>
+</h3>
+This slot is used for a slightly-delayed update.
+<p> The icon view is not redrawn immediately after inserting a new item
+but after a very small delay using a <a href="qtimer.html">QTimer</a>. 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.
+
+<h3 class=fn>void <a name="sort"></a>QIconView::sort ( bool&nbsp;ascending = TRUE )<tt> [virtual]</tt>
+</h3>
+Sorts and rearranges all the items in the icon view. If <em>ascending</em> is TRUE, the items are sorted in increasing order,
+otherwise they are sorted in decreasing order.
+<p> <a href="qiconviewitem.html#compare">QIconViewItem::compare</a>() 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.
+<p> Note that this function sets the sort order to <em>ascending</em>.
+<p> <p>See also <a href="qiconviewitem.html#key">QIconViewItem::key</a>(), <a href="qiconviewitem.html#setKey">QIconViewItem::setKey</a>(), <a href="qiconviewitem.html#compare">QIconViewItem::compare</a>(), <a href="#setSorting">QIconView::setSorting</a>(), and <a href="#sortDirection-prop">QIconView::sortDirection</a>.
+
+<h3 class=fn>bool <a name="sortDirection"></a>QIconView::sortDirection () const
+</h3><p>Returns TRUE if the sort direction for inserting new items is ascending;; otherwise returns FALSE.
+See the <a href="qiconview.html#sortDirection-prop">"sortDirection"</a> property for details.
+<h3 class=fn>bool <a name="sorting"></a>QIconView::sorting () const
+</h3><p>Returns TRUE if the icon view sorts on insertion; otherwise returns FALSE.
+See the <a href="qiconview.html#sorting-prop">"sorting"</a> property for details.
+<h3 class=fn>int <a name="spacing"></a>QIconView::spacing () const
+</h3><p>Returns the space in pixels between icon view items.
+See the <a href="qiconview.html#spacing-prop">"spacing"</a> property for details.
+<h3 class=fn>void <a name="startDrag"></a>QIconView::startDrag ()<tt> [virtual protected]</tt>
+</h3>
+Starts a drag.
+
+<h3 class=fn>void <a name="takeItem"></a>QIconView::takeItem ( <a href="qiconviewitem.html">QIconViewItem</a>&nbsp;*&nbsp;item )<tt> [virtual]</tt>
+</h3>
+Takes the icon view item <em>item</em> 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
+<a href="qiconviewitem.html#~QIconViewItem">QIconViewItem::~QIconViewItem</a>() calls it. The normal way to delete
+an item is to delete it.
+
+<h3 class=fn>bool <a name="wordWrapIconText"></a>QIconView::wordWrapIconText () const
+</h3><p>Returns TRUE if the item text will be word-wrapped if it is too long; otherwise returns FALSE.
+See the <a href="qiconview.html#wordWrapIconText-prop">"wordWrapIconText"</a> property for details.
+<hr><h2>Property Documentation</h2>
+<h3 class=fn><a href="qiconview.html#Arrangement-enum">Arrangement</a> <a name="arrangement-prop"></a>arrangement</h3>
+<p>This property holds the arrangement mode of the icon view.
+<p>This can be <a href="#Arrangement-enum">LeftToRight</a> or <a href="#Arrangement-enum">TopToBottom</a>. The default is <a href="#Arrangement-enum">LeftToRight</a>.
+
+<p>Set this property's value with <a href="#setArrangement">setArrangement</a>() and get this property's value with <a href="#arrangement">arrangement</a>().
+<h3 class=fn>bool <a name="autoArrange-prop"></a>autoArrange</h3>
+<p>This property holds whether the icon view rearranges its items when a new item is inserted.
+<p>The default is TRUE.
+<p> 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 <a href="#arrangeItemsInGrid">arrangeItemsInGrid</a>().
+
+<p>Set this property's value with <a href="#setAutoArrange">setAutoArrange</a>() and get this property's value with <a href="#autoArrange">autoArrange</a>().
+<h3 class=fn>uint <a name="count-prop"></a>count</h3>
+<p>This property holds the number of items in the icon view.
+<p>
+<p>Get this property's value with <a href="#count">count</a>().
+<h3 class=fn>int <a name="gridX-prop"></a>gridX</h3>
+<p>This property holds the horizontal grid of the icon view.
+<p>If the value is -1, (the default), QIconView computes suitable
+column widths based on the icon view's contents.
+<p> Note that setting a grid width overrides <a href="#setMaxItemWidth">setMaxItemWidth</a>().
+
+<p>Set this property's value with <a href="#setGridX">setGridX</a>() and get this property's value with <a href="#gridX">gridX</a>().
+<h3 class=fn>int <a name="gridY-prop"></a>gridY</h3>
+<p>This property holds the vertical grid of the icon view.
+<p>If the value is -1, (the default), QIconView computes suitable
+column heights based on the icon view's contents.
+
+<p>Set this property's value with <a href="#setGridY">setGridY</a>() and get this property's value with <a href="#gridY">gridY</a>().
+<h3 class=fn><a href="qbrush.html">QBrush</a> <a name="itemTextBackground-prop"></a>itemTextBackground</h3>
+<p>This property holds the brush to use when drawing the background of an item's text.
+<p>By default this brush is set to NoBrush, meaning that only the
+normal icon view background is used.
+
+<p>Set this property's value with <a href="#setItemTextBackground">setItemTextBackground</a>() and get this property's value with <a href="#itemTextBackground">itemTextBackground</a>().
+<h3 class=fn><a href="qiconview.html#ItemTextPos-enum">ItemTextPos</a> <a name="itemTextPos-prop"></a>itemTextPos</h3>
+<p>This property holds the position where the text of each item is drawn.
+<p>Valid values are <a href="#ItemTextPos-enum">Bottom</a> or <a href="#ItemTextPos-enum">Right</a>. The default is <a href="#ItemTextPos-enum">Bottom</a>.
+
+<p>Set this property's value with <a href="#setItemTextPos">setItemTextPos</a>() and get this property's value with <a href="#itemTextPos">itemTextPos</a>().
+<h3 class=fn>bool <a name="itemsMovable-prop"></a>itemsMovable</h3>
+<p>This property holds whether the user is allowed to move items around in the icon view.
+<p>The default is TRUE.
+
+<p>Set this property's value with <a href="#setItemsMovable">setItemsMovable</a>() and get this property's value with <a href="#itemsMovable">itemsMovable</a>().
+<h3 class=fn>int <a name="maxItemTextLength-prop"></a>maxItemTextLength</h3>
+<p>This property holds the maximum length (in characters) that an item's text may have.
+<p>The default is 255 characters.
+
+<p>Set this property's value with <a href="#setMaxItemTextLength">setMaxItemTextLength</a>() and get this property's value with <a href="#maxItemTextLength">maxItemTextLength</a>().
+<h3 class=fn>int <a name="maxItemWidth-prop"></a>maxItemWidth</h3>
+<p>This property holds the maximum width that an item may have.
+<p>The default is 100 pixels.
+<p> Note that if the <a href="#gridX">gridX</a>() value is set QIconView will ignore
+this property.
+
+<p>Set this property's value with <a href="#setMaxItemWidth">setMaxItemWidth</a>() and get this property's value with <a href="#maxItemWidth">maxItemWidth</a>().
+<h3 class=fn><a href="qiconview.html#ResizeMode-enum">ResizeMode</a> <a name="resizeMode-prop"></a>resizeMode</h3>
+<p>This property holds the resize mode of the icon view.
+<p>This can be <a href="#ResizeMode-enum">Fixed</a> or <a href="#ResizeMode-enum">Adjust</a>. The default is <a href="#ResizeMode-enum">Fixed</a>.
+See <a href="#ResizeMode-enum">ResizeMode</a>.
+
+<p>Set this property's value with <a href="#setResizeMode">setResizeMode</a>() and get this property's value with <a href="#resizeMode">resizeMode</a>().
+<h3 class=fn><a href="qiconview.html#SelectionMode-enum">SelectionMode</a> <a name="selectionMode-prop"></a>selectionMode</h3>
+<p>This property holds the selection mode of the icon view.
+<p>This can be <a href="#SelectionMode-enum">Single</a> (the default), <a href="#SelectionMode-enum">Extended</a>, <a href="#SelectionMode-enum">Multi</a> or <a href="#SelectionMode-enum">NoSelection</a>.
+
+<p>Set this property's value with <a href="#setSelectionMode">setSelectionMode</a>() and get this property's value with <a href="#selectionMode">selectionMode</a>().
+<h3 class=fn>bool <a name="showToolTips-prop"></a>showToolTips</h3>
+<p>This property holds whether the icon view will display a tool tip with the complete text for any truncated item text.
+<p>The default is TRUE. Note that this has no effect if
+<a href="#setWordWrapIconText">setWordWrapIconText</a>() is TRUE, as it is by default.
+
+<p>Set this property's value with <a href="#setShowToolTips">setShowToolTips</a>() and get this property's value with <a href="#showToolTips">showToolTips</a>().
+<h3 class=fn>bool <a name="sortDirection-prop"></a>sortDirection</h3>
+<p>This property holds whether the sort direction for inserting new items is ascending;.
+<p>The default is TRUE (i.e. ascending). This sort direction is only
+meaningful if both <a href="#sorting">sorting</a>() and <a href="#autoArrange">autoArrange</a>() are TRUE.
+<p> To set the sort direction, use <a href="#setSorting">setSorting</a>()
+
+<p>Get this property's value with <a href="#sortDirection">sortDirection</a>().
+<h3 class=fn>bool <a name="sorting-prop"></a>sorting</h3>
+<p>This property holds whether the icon view sorts on insertion.
+<p>The default is FALSE, i.e. no sorting on insertion.
+<p> To set the sorting, use <a href="#setSorting">setSorting</a>().
+
+<p>Get this property's value with <a href="#sorting">sorting</a>().
+<h3 class=fn>int <a name="spacing-prop"></a>spacing</h3>
+<p>This property holds the space in pixels between icon view items.
+<p>The default is 5 pixels.
+<p> Negative values for spacing are illegal.
+
+<p>Set this property's value with <a href="#setSpacing">setSpacing</a>() and get this property's value with <a href="#spacing">spacing</a>().
+<h3 class=fn>bool <a name="wordWrapIconText-prop"></a>wordWrapIconText</h3>
+<p>This property holds whether the item text will be word-wrapped if it is too long.
+<p>The default is TRUE.
+<p> 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 <a href="#setShowToolTips">setShowToolTips</a>().
+
+<p>Set this property's value with <a href="#setWordWrapIconText">setWordWrapIconText</a>() and get this property's value with <a href="#wordWrapIconText">wordWrapIconText</a>().
+<!-- eof -->
+<hr><p>
+This file is part of the <a href="index.html">Qt toolkit</a>.
+Copyright &copy; 1995-2007
+<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<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>