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.
1010 lines
70 KiB
1010 lines
70 KiB
14 years ago
|
<!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 Classes</font></a>
|
||
|
|
| <a href="mainclasses.html">
|
||
|
|
<font color="#004faf">Main Classes</font></a>
|
||
|
|
| <a href="annotated.html">
|
||
|
|
<font color="#004faf">Annotated</font></a>
|
||
|
|
| <a href="groups.html">
|
||
|
|
<font color="#004faf">Grouped 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 <<a href="qiconview-h.html">qiconview.h</a>></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 * parent = 0, const char * name = 0, WFlags 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 * item, QIconViewItem * after = 0L )</li>
|
||
|
|
<li class=fn>virtual void <a href="#takeItem"><b>takeItem</b></a> ( QIconViewItem * item )</li>
|
||
|
|
<li class=fn>int <a href="#index"><b>index</b></a> ( const QIconViewItem * 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 * item )</li>
|
||
|
|
<li class=fn>virtual void <a href="#setSelected"><b>setSelected</b></a> ( QIconViewItem * item, bool s, bool 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 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 QPoint & pos ) const</li>
|
||
|
|
<li class=fn>QIconViewItem * <a href="#findItem-2"><b>findItem</b></a> ( const QString & text, ComparisonFlags compare = BeginsWith ) const</li>
|
||
|
|
<li class=fn>virtual void <a href="#selectAll"><b>selectAll</b></a> ( bool 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 * 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 * item )</li>
|
||
|
|
<li class=fn>QIconViewItem * <a href="#findFirstVisibleItem"><b>findFirstVisibleItem</b></a> ( const QRect & r ) const</li>
|
||
|
|
<li class=fn>QIconViewItem * <a href="#findLastVisibleItem"><b>findLastVisibleItem</b></a> ( const QRect & 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 rx )</li>
|
||
|
|
<li class=fn>virtual void <a href="#setGridY"><b>setGridY</b></a> ( int 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 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 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 QBrush & 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 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 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 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 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 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 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 sort, bool 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 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 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 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 QSize & grid, bool update = TRUE )</li>
|
||
|
|
<li class=fn>virtual void <a href="#arrangeItemsInGrid-2"><b>arrangeItemsInGrid</b></a> ( bool 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 * item )</li>
|
||
|
|
<li class=fn>void <a href="#currentChanged"><b>currentChanged</b></a> ( QIconViewItem * item )</li>
|
||
|
|
<li class=fn>void <a href="#clicked"><b>clicked</b></a> ( QIconViewItem * item )</li>
|
||
|
|
<li class=fn>void <a href="#clicked-2"><b>clicked</b></a> ( QIconViewItem * item, const QPoint & pos )</li>
|
||
|
|
<li class=fn>void <a href="#pressed"><b>pressed</b></a> ( QIconViewItem * item )</li>
|
||
|
|
<li class=fn>void <a href="#pressed-2"><b>pressed</b></a> ( QIconViewItem * item, const QPoint & pos )</li>
|
||
|
|
<li class=fn>void <a href="#doubleClicked"><b>doubleClicked</b></a> ( QIconViewItem * item )</li>
|
||
|
|
<li class=fn>void <a href="#returnPressed"><b>returnPressed</b></a> ( QIconViewItem * item )</li>
|
||
|
|
<li class=fn>void <a href="#rightButtonClicked"><b>rightButtonClicked</b></a> ( QIconViewItem * item, const QPoint & pos )</li>
|
||
|
|
<li class=fn>void <a href="#rightButtonPressed"><b>rightButtonPressed</b></a> ( QIconViewItem * item, const QPoint & pos )</li>
|
||
|
|
<li class=fn>void <a href="#mouseButtonPressed"><b>mouseButtonPressed</b></a> ( int button, QIconViewItem * item, const QPoint & pos )</li>
|
||
|
|
<li class=fn>void <a href="#mouseButtonClicked"><b>mouseButtonClicked</b></a> ( int button, QIconViewItem * item, const QPoint & pos )</li>
|
||
|
|
<li class=fn>void <a href="#contextMenuRequested"><b>contextMenuRequested</b></a> ( QIconViewItem * item, const QPoint & pos )</li>
|
||
|
|
<li class=fn>void <a href="#dropped"><b>dropped</b></a> ( QDropEvent * e, const QValueList<QIconDragItem> & 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 * 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 * item, const QString & name )</li>
|
||
|
|
<li class=fn>void <a href="#itemRenamed-2"><b>itemRenamed</b></a> ( QIconViewItem * item )</li>
|
||
|
|
</ul>
|
||
|
|
<h2>Properties</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn>Arrangement <a href="#arrangement-prop"><b>arrangement</b></a> - the arrangement mode of the icon view</li>
|
||
|
|
<li class=fn>bool <a href="#autoArrange-prop"><b>autoArrange</b></a> - 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> - the number of items in the icon view <em>(read only)</em></li>
|
||
|
|
<li class=fn>int <a href="#gridX-prop"><b>gridX</b></a> - the horizontal grid of the icon view</li>
|
||
|
|
<li class=fn>int <a href="#gridY-prop"><b>gridY</b></a> - the vertical grid of the icon view</li>
|
||
|
|
<li class=fn>QBrush <a href="#itemTextBackground-prop"><b>itemTextBackground</b></a> - 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> - the position where the text of each item is drawn</li>
|
||
|
|
<li class=fn>bool <a href="#itemsMovable-prop"><b>itemsMovable</b></a> - 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> - 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> - the maximum width that an item may have</li>
|
||
|
|
<li class=fn>ResizeMode <a href="#resizeMode-prop"><b>resizeMode</b></a> - the resize mode of the icon view</li>
|
||
|
|
<li class=fn>SelectionMode <a href="#selectionMode-prop"><b>selectionMode</b></a> - the selection mode of the icon view</li>
|
||
|
|
<li class=fn>bool <a href="#showToolTips-prop"><b>showToolTips</b></a> - 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> - whether the sort direction for inserting new items is ascending; <em>(read only)</em></li>
|
||
|
|
<li class=fn>bool <a href="#sorting-prop"><b>sorting</b></a> - whether the icon view sorts on insertion <em>(read only)</em></li>
|
||
|
|
<li class=fn>int <a href="#spacing-prop"><b>spacing</b></a> - the space in pixels between icon view items</li>
|
||
|
|
<li class=fn>bool <a href="#wordWrapIconText-prop"><b>wordWrapIconText</b></a> - 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 * 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 * item )</li>
|
||
|
|
<li class=fn>virtual void <a href="#drawBackground"><b>drawBackground</b></a> ( QPainter * p, const QRect & r )</li>
|
||
|
|
<li class=fn>void <a href="#emitSelectionChanged"><b>emitSelectionChanged</b></a> ( QIconViewItem * i = 0 )</li>
|
||
|
|
<li class=fn>QIconViewItem * <a href="#makeRowLayout"><b>makeRowLayout</b></a> ( QIconViewItem * begin, int & y, bool & 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 < 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-><a href="qwidget.html#resize">resize</a>( 600, 400 );
|
||
|
|
iv-><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->firstItem(); item; item = item-><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>()->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-><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><QIconDragItem>& )
|
||
|
|
{
|
||
|
|
<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> * parent = 0, const char * name = 0, WFlags 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 <a href="qsize.html">QSize</a> & grid, bool 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 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> * 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> * item, const <a href="qpoint.html">QPoint</a> & 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> * item, const <a href="qpoint.html">QPoint</a> & 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> * 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> * <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> * 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> * <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> * p, const <a href="qrect.html">QRect</a> & 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> * 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> * e, const <a href="qvaluelist.html">QValueList</a><QIconDragItem> & 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> * 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> * 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> * <a name="findFirstVisibleItem"></a>QIconView::findFirstVisibleItem ( const <a href="qrect.html">QRect</a> & 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> * <a name="findItem"></a>QIconView::findItem ( const <a href="qpoint.html">QPoint</a> & 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> * <a name="findItem-2"></a>QIconView::findItem ( const <a href="qstring.html">QString</a> & text, ComparisonFlags 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> * <a name="findLastVisibleItem"></a>QIconView::findLastVisibleItem ( const <a href="qrect.html">QRect</a> & 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> * <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 <a href="qiconviewitem.html">QIconViewItem</a> * 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> * 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> * item, <a href="qiconviewitem.html">QIconViewItem</a> * 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> * item, const <a href="qstring.html">QString</a> & 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> * 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> * <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> * <a name="makeRowLayout"></a>QIconView::makeRowLayout ( <a href="qiconviewitem.html">QIconViewItem</a> * begin, int & y, bool & 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 button, <a href="qiconviewitem.html">QIconViewItem</a> * item, const <a href="qpoint.html">QPoint</a> & 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 button, <a href="qiconviewitem.html">QIconViewItem</a> * item, const <a href="qpoint.html">QPoint</a> & 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> * 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> * 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> * item, const <a href="qpoint.html">QPoint</a> & 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> * 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> * 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> * item, const <a href="qpoint.html">QPoint</a> & 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> * item, const <a href="qpoint.html">QPoint</a> & 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 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> * 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> 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 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> * 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 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 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 <a href="qbrush.html">QBrush</a> & 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> 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 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 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 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> 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> * item, bool s, bool 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> 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 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 sort, bool 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 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 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 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> * 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 © 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 © 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>
|