3
3
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
4
4
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
<!-- /fasttmp/mkdist-qt-4.5.2-1245473805/qt-x11-opensource-src-4.5.2/src/gui/itemviews/qstandarditemmodel.cpp -->
5
<!-- qstandarditemmodel.cpp -->
7
<title>Qt 4.5: QStandardItem Class Reference</title>
7
<title>Qt 4.6: QStandardItem Class Reference</title>
8
8
<link href="classic.css" rel="stylesheet" type="text/css" />
11
<a name="//apple_ref/cpp/cl//QStandardItem" />
11
12
<table border="0" cellpadding="0" cellspacing="0" width="100%">
13
<td align="left" valign="top" width="32"><a href="http://qtsoftware.com/products/qt"><img src="images/qt-logo.png" align="left" border="0" /></a></td>
14
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="namespaces.html"><font color="#004faf">All Namespaces</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="groups.html"><font color="#004faf">Grouped Classes</font></a> · <a href="modules.html"><font color="#004faf">Modules</font></a> · <a href="functions.html"><font color="#004faf">Functions</font></a></td>
15
<td align="right" valign="top" width="230"></td></tr></table><h1 class="title">QStandardItem Class Reference<br /><span class="small-subtitle">[<a href="qtgui.html">QtGui</a> module]</span>
14
<td align="left" valign="top" width="32"><a href="http://qt.nokia.com/"><img src="images/qt-logo.png" align="left" border="0" /></a></td>
15
<td width="1"> </td><td class="postheader" 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="functions.html"><font color="#004faf">All Functions</font></a> · <a href="overviews.html"><font color="#004faf">Overviews</font></a></td><td class="searchBar" align="right" valign="center"><form action="http://www.google.com/cse" id="cse-search-box"><div><input type="hidden" name="cx" value="000136343326384750312:dhbxnqlakyu" /><input type="hidden" name="ie" value="UTF-8" /><input type="text" name="q" size="31" /><input type="submit" name="sa" value="Search" /></div></form></td>
16
</tr></table><h1 class="title">QStandardItem Class Reference<br /><span class="small-subtitle">[<a href="qtgui.html">QtGui</a> module]</span>
17
18
<p>The QStandardItem class provides an item for use with the <a href="qstandarditemmodel.html">QStandardItemModel</a> class. <a href="#details">More...</a></p>
18
19
<pre> #include <QStandardItem></pre><p>This class was introduced in Qt 4.2.</p>
20
21
<li><a href="qstandarditem-members.html">List of all members, including inherited members</a></li>
22
24
<a name="public-types"></a>
25
<li><div class="fn"></div>enum <b><a href="qstandarditem.html#ItemType-enum">ItemType</a></b> { Type, UserType }</li>
26
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
27
<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#ItemType-enum">ItemType</a></b> { Type, UserType }</td></tr>
27
30
<a name="public-functions"></a>
28
<h3>Public Functions</h3>
30
<li><div class="fn"></div><b><a href="qstandarditem.html#QStandardItem">QStandardItem</a></b> ()</li>
31
<li><div class="fn"></div><b><a href="qstandarditem.html#QStandardItem-2">QStandardItem</a></b> ( const QString & <i>text</i> )</li>
32
<li><div class="fn"></div><b><a href="qstandarditem.html#QStandardItem-3">QStandardItem</a></b> ( const QIcon & <i>icon</i>, const QString & <i>text</i> )</li>
33
<li><div class="fn"></div><b><a href="qstandarditem.html#QStandardItem-4">QStandardItem</a></b> ( int <i>rows</i>, int <i>columns</i> = 1 )</li>
34
<li><div class="fn"></div>virtual <b><a href="qstandarditem.html#dtor.QStandardItem">~QStandardItem</a></b> ()</li>
35
<li><div class="fn"></div>QString <b><a href="qstandarditem.html#accessibleDescription">accessibleDescription</a></b> () const</li>
36
<li><div class="fn"></div>QString <b><a href="qstandarditem.html#accessibleText">accessibleText</a></b> () const</li>
37
<li><div class="fn"></div>void <b><a href="qstandarditem.html#appendColumn">appendColumn</a></b> ( const QList<QStandardItem *> & <i>items</i> )</li>
38
<li><div class="fn"></div>void <b><a href="qstandarditem.html#appendRow">appendRow</a></b> ( const QList<QStandardItem *> & <i>items</i> )</li>
39
<li><div class="fn"></div>void <b><a href="qstandarditem.html#appendRow-2">appendRow</a></b> ( QStandardItem * <i>item</i> )</li>
40
<li><div class="fn"></div>void <b><a href="qstandarditem.html#appendRows">appendRows</a></b> ( const QList<QStandardItem *> & <i>items</i> )</li>
41
<li><div class="fn"></div>QBrush <b><a href="qstandarditem.html#background">background</a></b> () const</li>
42
<li><div class="fn"></div>Qt::CheckState <b><a href="qstandarditem.html#checkState">checkState</a></b> () const</li>
43
<li><div class="fn"></div>QStandardItem * <b><a href="qstandarditem.html#child">child</a></b> ( int <i>row</i>, int <i>column</i> = 0 ) const</li>
44
<li><div class="fn"></div>virtual QStandardItem * <b><a href="qstandarditem.html#clone">clone</a></b> () const</li>
45
<li><div class="fn"></div>int <b><a href="qstandarditem.html#column">column</a></b> () const</li>
46
<li><div class="fn"></div>int <b><a href="qstandarditem.html#columnCount">columnCount</a></b> () const</li>
47
<li><div class="fn"></div>virtual QVariant <b><a href="qstandarditem.html#data">data</a></b> ( int <i>role</i> = Qt::UserRole + 1 ) const</li>
48
<li><div class="fn"></div>Qt::ItemFlags <b><a href="qstandarditem.html#flags">flags</a></b> () const</li>
49
<li><div class="fn"></div>QFont <b><a href="qstandarditem.html#font">font</a></b> () const</li>
50
<li><div class="fn"></div>QBrush <b><a href="qstandarditem.html#foreground">foreground</a></b> () const</li>
51
<li><div class="fn"></div>bool <b><a href="qstandarditem.html#hasChildren">hasChildren</a></b> () const</li>
52
<li><div class="fn"></div>QIcon <b><a href="qstandarditem.html#icon">icon</a></b> () const</li>
53
<li><div class="fn"></div>QModelIndex <b><a href="qstandarditem.html#index">index</a></b> () const</li>
54
<li><div class="fn"></div>void <b><a href="qstandarditem.html#insertColumn">insertColumn</a></b> ( int <i>column</i>, const QList<QStandardItem *> & <i>items</i> )</li>
55
<li><div class="fn"></div>void <b><a href="qstandarditem.html#insertColumns">insertColumns</a></b> ( int <i>column</i>, int <i>count</i> )</li>
56
<li><div class="fn"></div>void <b><a href="qstandarditem.html#insertRow">insertRow</a></b> ( int <i>row</i>, const QList<QStandardItem *> & <i>items</i> )</li>
57
<li><div class="fn"></div>void <b><a href="qstandarditem.html#insertRow-2">insertRow</a></b> ( int <i>row</i>, QStandardItem * <i>item</i> )</li>
58
<li><div class="fn"></div>void <b><a href="qstandarditem.html#insertRows">insertRows</a></b> ( int <i>row</i>, const QList<QStandardItem *> & <i>items</i> )</li>
59
<li><div class="fn"></div>void <b><a href="qstandarditem.html#insertRows-2">insertRows</a></b> ( int <i>row</i>, int <i>count</i> )</li>
60
<li><div class="fn"></div>bool <b><a href="qstandarditem.html#isCheckable">isCheckable</a></b> () const</li>
61
<li><div class="fn"></div>bool <b><a href="qstandarditem.html#isDragEnabled">isDragEnabled</a></b> () const</li>
62
<li><div class="fn"></div>bool <b><a href="qstandarditem.html#isDropEnabled">isDropEnabled</a></b> () const</li>
63
<li><div class="fn"></div>bool <b><a href="qstandarditem.html#isEditable">isEditable</a></b> () const</li>
64
<li><div class="fn"></div>bool <b><a href="qstandarditem.html#isEnabled">isEnabled</a></b> () const</li>
65
<li><div class="fn"></div>bool <b><a href="qstandarditem.html#isSelectable">isSelectable</a></b> () const</li>
66
<li><div class="fn"></div>bool <b><a href="qstandarditem.html#isTristate">isTristate</a></b> () const</li>
67
<li><div class="fn"></div>QStandardItemModel * <b><a href="qstandarditem.html#model">model</a></b> () const</li>
68
<li><div class="fn"></div>QStandardItem * <b><a href="qstandarditem.html#parent">parent</a></b> () const</li>
69
<li><div class="fn"></div>virtual void <b><a href="qstandarditem.html#read">read</a></b> ( QDataStream & <i>in</i> )</li>
70
<li><div class="fn"></div>void <b><a href="qstandarditem.html#removeColumn">removeColumn</a></b> ( int <i>column</i> )</li>
71
<li><div class="fn"></div>void <b><a href="qstandarditem.html#removeColumns">removeColumns</a></b> ( int <i>column</i>, int <i>count</i> )</li>
72
<li><div class="fn"></div>void <b><a href="qstandarditem.html#removeRow">removeRow</a></b> ( int <i>row</i> )</li>
73
<li><div class="fn"></div>void <b><a href="qstandarditem.html#removeRows">removeRows</a></b> ( int <i>row</i>, int <i>count</i> )</li>
74
<li><div class="fn"></div>int <b><a href="qstandarditem.html#row">row</a></b> () const</li>
75
<li><div class="fn"></div>int <b><a href="qstandarditem.html#rowCount">rowCount</a></b> () const</li>
76
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setAccessibleDescription">setAccessibleDescription</a></b> ( const QString & <i>accessibleDescription</i> )</li>
77
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setAccessibleText">setAccessibleText</a></b> ( const QString & <i>accessibleText</i> )</li>
78
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setBackground">setBackground</a></b> ( const QBrush & <i>brush</i> )</li>
79
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setCheckState">setCheckState</a></b> ( Qt::CheckState <i>state</i> )</li>
80
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setCheckable">setCheckable</a></b> ( bool <i>checkable</i> )</li>
81
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setChild">setChild</a></b> ( int <i>row</i>, int <i>column</i>, QStandardItem * <i>item</i> )</li>
82
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setChild-2">setChild</a></b> ( int <i>row</i>, QStandardItem * <i>item</i> )</li>
83
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setColumnCount">setColumnCount</a></b> ( int <i>columns</i> )</li>
84
<li><div class="fn"></div>virtual void <b><a href="qstandarditem.html#setData">setData</a></b> ( const QVariant & <i>value</i>, int <i>role</i> = Qt::UserRole + 1 )</li>
85
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setDragEnabled">setDragEnabled</a></b> ( bool <i>dragEnabled</i> )</li>
86
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setDropEnabled">setDropEnabled</a></b> ( bool <i>dropEnabled</i> )</li>
87
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setEditable">setEditable</a></b> ( bool <i>editable</i> )</li>
88
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setEnabled">setEnabled</a></b> ( bool <i>enabled</i> )</li>
89
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setFlags">setFlags</a></b> ( Qt::ItemFlags <i>flags</i> )</li>
90
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setFont">setFont</a></b> ( const QFont & <i>font</i> )</li>
91
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setForeground">setForeground</a></b> ( const QBrush & <i>brush</i> )</li>
92
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setIcon">setIcon</a></b> ( const QIcon & <i>icon</i> )</li>
93
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setRowCount">setRowCount</a></b> ( int <i>rows</i> )</li>
94
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setSelectable">setSelectable</a></b> ( bool <i>selectable</i> )</li>
95
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setSizeHint">setSizeHint</a></b> ( const QSize & <i>size</i> )</li>
96
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setStatusTip">setStatusTip</a></b> ( const QString & <i>statusTip</i> )</li>
97
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setText">setText</a></b> ( const QString & <i>text</i> )</li>
98
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setTextAlignment">setTextAlignment</a></b> ( Qt::Alignment <i>alignment</i> )</li>
99
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setToolTip">setToolTip</a></b> ( const QString & <i>toolTip</i> )</li>
100
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setTristate">setTristate</a></b> ( bool <i>tristate</i> )</li>
101
<li><div class="fn"></div>void <b><a href="qstandarditem.html#setWhatsThis">setWhatsThis</a></b> ( const QString & <i>whatsThis</i> )</li>
102
<li><div class="fn"></div>QSize <b><a href="qstandarditem.html#sizeHint">sizeHint</a></b> () const</li>
103
<li><div class="fn"></div>void <b><a href="qstandarditem.html#sortChildren">sortChildren</a></b> ( int <i>column</i>, Qt::SortOrder <i>order</i> = Qt::AscendingOrder )</li>
104
<li><div class="fn"></div>QString <b><a href="qstandarditem.html#statusTip">statusTip</a></b> () const</li>
105
<li><div class="fn"></div>QStandardItem * <b><a href="qstandarditem.html#takeChild">takeChild</a></b> ( int <i>row</i>, int <i>column</i> = 0 )</li>
106
<li><div class="fn"></div>QList<QStandardItem *> <b><a href="qstandarditem.html#takeColumn">takeColumn</a></b> ( int <i>column</i> )</li>
107
<li><div class="fn"></div>QList<QStandardItem *> <b><a href="qstandarditem.html#takeRow">takeRow</a></b> ( int <i>row</i> )</li>
108
<li><div class="fn"></div>QString <b><a href="qstandarditem.html#text">text</a></b> () const</li>
109
<li><div class="fn"></div>Qt::Alignment <b><a href="qstandarditem.html#textAlignment">textAlignment</a></b> () const</li>
110
<li><div class="fn"></div>QString <b><a href="qstandarditem.html#toolTip">toolTip</a></b> () const</li>
111
<li><div class="fn"></div>virtual int <b><a href="qstandarditem.html#type">type</a></b> () const</li>
112
<li><div class="fn"></div>QString <b><a href="qstandarditem.html#whatsThis">whatsThis</a></b> () const</li>
113
<li><div class="fn"></div>virtual void <b><a href="qstandarditem.html#write">write</a></b> ( QDataStream & <i>out</i> ) const</li>
114
<li><div class="fn"></div>virtual bool <b><a href="qstandarditem.html#operator-lt">operator<</a></b> ( const QStandardItem & <i>other</i> ) const</li>
31
<h2>Public Functions</h2>
32
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
33
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#QStandardItem">QStandardItem</a></b> ()</td></tr>
34
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#QStandardItem-2">QStandardItem</a></b> ( const QString & <i>text</i> )</td></tr>
35
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#QStandardItem-3">QStandardItem</a></b> ( const QIcon & <i>icon</i>, const QString & <i>text</i> )</td></tr>
36
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#QStandardItem-4">QStandardItem</a></b> ( int <i>rows</i>, int <i>columns</i> = 1 )</td></tr>
37
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#dtor.QStandardItem">~QStandardItem</a></b> ()</td></tr>
38
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#accessibleDescription">accessibleDescription</a></b> () const</td></tr>
39
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#accessibleText">accessibleText</a></b> () const</td></tr>
40
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#appendColumn">appendColumn</a></b> ( const QList<QStandardItem *> & <i>items</i> )</td></tr>
41
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#appendRow">appendRow</a></b> ( const QList<QStandardItem *> & <i>items</i> )</td></tr>
42
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#appendRow-2">appendRow</a></b> ( QStandardItem * <i>item</i> )</td></tr>
43
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#appendRows">appendRows</a></b> ( const QList<QStandardItem *> & <i>items</i> )</td></tr>
44
<tr><td class="memItemLeft" align="right" valign="top">QBrush </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#background">background</a></b> () const</td></tr>
45
<tr><td class="memItemLeft" align="right" valign="top">Qt::CheckState </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#checkState">checkState</a></b> () const</td></tr>
46
<tr><td class="memItemLeft" align="right" valign="top">QStandardItem * </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#child">child</a></b> ( int <i>row</i>, int <i>column</i> = 0 ) const</td></tr>
47
<tr><td class="memItemLeft" align="right" valign="top">virtual QStandardItem * </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#clone">clone</a></b> () const</td></tr>
48
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#column">column</a></b> () const</td></tr>
49
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#columnCount">columnCount</a></b> () const</td></tr>
50
<tr><td class="memItemLeft" align="right" valign="top">virtual QVariant </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#data">data</a></b> ( int <i>role</i> = Qt::UserRole + 1 ) const</td></tr>
51
<tr><td class="memItemLeft" align="right" valign="top">Qt::ItemFlags </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#flags">flags</a></b> () const</td></tr>
52
<tr><td class="memItemLeft" align="right" valign="top">QFont </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#font">font</a></b> () const</td></tr>
53
<tr><td class="memItemLeft" align="right" valign="top">QBrush </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#foreground">foreground</a></b> () const</td></tr>
54
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#hasChildren">hasChildren</a></b> () const</td></tr>
55
<tr><td class="memItemLeft" align="right" valign="top">QIcon </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#icon">icon</a></b> () const</td></tr>
56
<tr><td class="memItemLeft" align="right" valign="top">QModelIndex </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#index">index</a></b> () const</td></tr>
57
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#insertColumn">insertColumn</a></b> ( int <i>column</i>, const QList<QStandardItem *> & <i>items</i> )</td></tr>
58
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#insertColumns">insertColumns</a></b> ( int <i>column</i>, int <i>count</i> )</td></tr>
59
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#insertRow">insertRow</a></b> ( int <i>row</i>, const QList<QStandardItem *> & <i>items</i> )</td></tr>
60
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#insertRow-2">insertRow</a></b> ( int <i>row</i>, QStandardItem * <i>item</i> )</td></tr>
61
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#insertRows">insertRows</a></b> ( int <i>row</i>, const QList<QStandardItem *> & <i>items</i> )</td></tr>
62
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#insertRows-2">insertRows</a></b> ( int <i>row</i>, int <i>count</i> )</td></tr>
63
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#isCheckable">isCheckable</a></b> () const</td></tr>
64
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#isDragEnabled">isDragEnabled</a></b> () const</td></tr>
65
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#isDropEnabled">isDropEnabled</a></b> () const</td></tr>
66
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#isEditable">isEditable</a></b> () const</td></tr>
67
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#isEnabled">isEnabled</a></b> () const</td></tr>
68
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#isSelectable">isSelectable</a></b> () const</td></tr>
69
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#isTristate">isTristate</a></b> () const</td></tr>
70
<tr><td class="memItemLeft" align="right" valign="top">QStandardItemModel * </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#model">model</a></b> () const</td></tr>
71
<tr><td class="memItemLeft" align="right" valign="top">QStandardItem * </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#parent">parent</a></b> () const</td></tr>
72
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#read">read</a></b> ( QDataStream & <i>in</i> )</td></tr>
73
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#removeColumn">removeColumn</a></b> ( int <i>column</i> )</td></tr>
74
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#removeColumns">removeColumns</a></b> ( int <i>column</i>, int <i>count</i> )</td></tr>
75
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#removeRow">removeRow</a></b> ( int <i>row</i> )</td></tr>
76
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#removeRows">removeRows</a></b> ( int <i>row</i>, int <i>count</i> )</td></tr>
77
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#row">row</a></b> () const</td></tr>
78
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#rowCount">rowCount</a></b> () const</td></tr>
79
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setAccessibleDescription">setAccessibleDescription</a></b> ( const QString & <i>accessibleDescription</i> )</td></tr>
80
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setAccessibleText">setAccessibleText</a></b> ( const QString & <i>accessibleText</i> )</td></tr>
81
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setBackground">setBackground</a></b> ( const QBrush & <i>brush</i> )</td></tr>
82
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setCheckState">setCheckState</a></b> ( Qt::CheckState <i>state</i> )</td></tr>
83
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setCheckable">setCheckable</a></b> ( bool <i>checkable</i> )</td></tr>
84
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setChild">setChild</a></b> ( int <i>row</i>, int <i>column</i>, QStandardItem * <i>item</i> )</td></tr>
85
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setChild-2">setChild</a></b> ( int <i>row</i>, QStandardItem * <i>item</i> )</td></tr>
86
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setColumnCount">setColumnCount</a></b> ( int <i>columns</i> )</td></tr>
87
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setData">setData</a></b> ( const QVariant & <i>value</i>, int <i>role</i> = Qt::UserRole + 1 )</td></tr>
88
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setDragEnabled">setDragEnabled</a></b> ( bool <i>dragEnabled</i> )</td></tr>
89
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setDropEnabled">setDropEnabled</a></b> ( bool <i>dropEnabled</i> )</td></tr>
90
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setEditable">setEditable</a></b> ( bool <i>editable</i> )</td></tr>
91
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setEnabled">setEnabled</a></b> ( bool <i>enabled</i> )</td></tr>
92
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setFlags">setFlags</a></b> ( Qt::ItemFlags <i>flags</i> )</td></tr>
93
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setFont">setFont</a></b> ( const QFont & <i>font</i> )</td></tr>
94
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setForeground">setForeground</a></b> ( const QBrush & <i>brush</i> )</td></tr>
95
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setIcon">setIcon</a></b> ( const QIcon & <i>icon</i> )</td></tr>
96
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setRowCount">setRowCount</a></b> ( int <i>rows</i> )</td></tr>
97
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setSelectable">setSelectable</a></b> ( bool <i>selectable</i> )</td></tr>
98
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setSizeHint">setSizeHint</a></b> ( const QSize & <i>size</i> )</td></tr>
99
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setStatusTip">setStatusTip</a></b> ( const QString & <i>statusTip</i> )</td></tr>
100
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setText">setText</a></b> ( const QString & <i>text</i> )</td></tr>
101
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setTextAlignment">setTextAlignment</a></b> ( Qt::Alignment <i>alignment</i> )</td></tr>
102
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setToolTip">setToolTip</a></b> ( const QString & <i>toolTip</i> )</td></tr>
103
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setTristate">setTristate</a></b> ( bool <i>tristate</i> )</td></tr>
104
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#setWhatsThis">setWhatsThis</a></b> ( const QString & <i>whatsThis</i> )</td></tr>
105
<tr><td class="memItemLeft" align="right" valign="top">QSize </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#sizeHint">sizeHint</a></b> () const</td></tr>
106
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#sortChildren">sortChildren</a></b> ( int <i>column</i>, Qt::SortOrder <i>order</i> = Qt::AscendingOrder )</td></tr>
107
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#statusTip">statusTip</a></b> () const</td></tr>
108
<tr><td class="memItemLeft" align="right" valign="top">QStandardItem * </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#takeChild">takeChild</a></b> ( int <i>row</i>, int <i>column</i> = 0 )</td></tr>
109
<tr><td class="memItemLeft" align="right" valign="top">QList<QStandardItem *> </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#takeColumn">takeColumn</a></b> ( int <i>column</i> )</td></tr>
110
<tr><td class="memItemLeft" align="right" valign="top">QList<QStandardItem *> </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#takeRow">takeRow</a></b> ( int <i>row</i> )</td></tr>
111
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#text">text</a></b> () const</td></tr>
112
<tr><td class="memItemLeft" align="right" valign="top">Qt::Alignment </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#textAlignment">textAlignment</a></b> () const</td></tr>
113
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#toolTip">toolTip</a></b> () const</td></tr>
114
<tr><td class="memItemLeft" align="right" valign="top">virtual int </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#type">type</a></b> () const</td></tr>
115
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#whatsThis">whatsThis</a></b> () const</td></tr>
116
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#write">write</a></b> ( QDataStream & <i>out</i> ) const</td></tr>
117
<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#operator-lt">operator<</a></b> ( const QStandardItem & <i>other</i> ) const</td></tr>
116
120
<a name="protected-functions"></a>
117
<h3>Protected Functions</h3>
119
<li><div class="fn"></div><b><a href="qstandarditem.html#QStandardItem-5">QStandardItem</a></b> ( const QStandardItem & <i>other</i> )</li>
120
<li><div class="fn"></div>void <b><a href="qstandarditem.html#emitDataChanged">emitDataChanged</a></b> ()</li>
121
<li><div class="fn"></div>QStandardItem & <b><a href="qstandarditem.html#operator-eq">operator=</a></b> ( const QStandardItem & <i>other</i> )</li>
121
<h2>Protected Functions</h2>
122
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
123
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#QStandardItem-5">QStandardItem</a></b> ( const QStandardItem & <i>other</i> )</td></tr>
124
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#emitDataChanged">emitDataChanged</a></b> ()</td></tr>
125
<tr><td class="memItemLeft" align="right" valign="top">QStandardItem & </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#operator-eq">operator=</a></b> ( const QStandardItem & <i>other</i> )</td></tr>
123
128
<a name="related-non-members"></a>
124
<h3>Related Non-Members</h3>
126
<li><div class="fn"></div>QDataStream & <b><a href="qstandarditem.html#operator-lt-lt-155">operator<<</a></b> ( QDataStream & <i>out</i>, const QStandardItem & <i>item</i> )</li>
127
<li><div class="fn"></div>QDataStream & <b><a href="qstandarditem.html#operator-gt-gt-90">operator>></a></b> ( QDataStream & <i>in</i>, QStandardItem & <i>item</i> )</li>
129
<h2>Related Non-Members</h2>
130
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
131
<tr><td class="memItemLeft" align="right" valign="top">QDataStream & </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#operator-lt-lt-40">operator<<</a></b> ( QDataStream & <i>out</i>, const QStandardItem & <i>item</i> )</td></tr>
132
<tr><td class="memItemLeft" align="right" valign="top">QDataStream & </td><td class="memItemRight" valign="bottom"><b><a href="qstandarditem.html#operator-gt-gt-16">operator>></a></b> ( QDataStream & <i>in</i>, QStandardItem & <i>item</i> )</td></tr>
129
134
<a name="details"></a>
131
136
<h2>Detailed Description</h2>
190
204
<p>This is an overloaded function.</p>
191
205
<p>Appends a row containing <i>item</i>.</p>
192
206
<p>When building a list or a tree that has only one column, this function provides a convenient way to append a single new item.</p>
207
<a name="//apple_ref/cpp/instm/QStandardItem/appendRows" />
193
208
<h3 class="fn"><a name="appendRows"></a>void QStandardItem::appendRows ( const <a href="qlist.html">QList</a><QStandardItem *> & <i>items</i> )</h3>
194
209
<p>Appends rows containing <i>items</i>. The column count will not change.</p>
195
210
<p>See also <a href="qstandarditem.html#insertRow">insertRow</a>().</p>
211
<a name="//apple_ref/cpp/instm/QStandardItem/background" />
196
212
<h3 class="fn"><a name="background"></a><a href="qbrush.html">QBrush</a> QStandardItem::background () const</h3>
197
213
<p>Returns the brush used to render the item's background.</p>
198
214
<p>See also <a href="qstandarditem.html#foreground">foreground</a>() and <a href="qstandarditem.html#setBackground">setBackground</a>().</p>
215
<a name="//apple_ref/cpp/instm/QStandardItem/checkState" />
199
216
<h3 class="fn"><a name="checkState"></a><a href="qt.html#CheckState-enum">Qt::CheckState</a> QStandardItem::checkState () const</h3>
200
217
<p>Returns the checked state of the item.</p>
201
218
<p>See also <a href="qstandarditem.html#setCheckState">setCheckState</a>() and <a href="qstandarditem.html#isCheckable">isCheckable</a>().</p>
219
<a name="//apple_ref/cpp/instm/QStandardItem/child" />
202
220
<h3 class="fn"><a name="child"></a>QStandardItem * QStandardItem::child ( int <i>row</i>, int <i>column</i> = 0 ) const</h3>
203
221
<p>Returns the child item at (<i>row</i>, <i>column</i>) if one has been set; otherwise returns 0.</p>
204
222
<p>See also <a href="qstandarditem.html#setChild">setChild</a>(), <a href="qstandarditem.html#takeChild">takeChild</a>(), and <a href="qstandarditem.html#parent">parent</a>().</p>
223
<a name="//apple_ref/cpp/instm/QStandardItem/clone" />
205
224
<h3 class="fn"><a name="clone"></a>QStandardItem * QStandardItem::clone () const <tt> [virtual]</tt></h3>
206
225
<p>Returns a copy of this item. The item's children are not copied.</p>
207
226
<p>When subclassing <a href="qstandarditem.html">QStandardItem</a>, you can reimplement this function to provide <a href="qstandarditemmodel.html">QStandardItemModel</a> with a factory that it can use to create new items on demand.</p>
208
227
<p>See also <a href="qstandarditemmodel.html#setItemPrototype">QStandardItemModel::setItemPrototype</a>() and <a href="qstandarditem.html#operator-eq">operator=</a>().</p>
228
<a name="//apple_ref/cpp/instm/QStandardItem/column" />
209
229
<h3 class="fn"><a name="column"></a>int QStandardItem::column () const</h3>
210
230
<p>Returns the column where the item is located in its parent's child table, or -1 if the item has no parent.</p>
211
231
<p>See also <a href="qstandarditem.html#row">row</a>() and <a href="qstandarditem.html#parent">parent</a>().</p>
232
<a name="//apple_ref/cpp/instm/QStandardItem/columnCount" />
212
233
<h3 class="fn"><a name="columnCount"></a>int QStandardItem::columnCount () const</h3>
213
234
<p>Returns the number of child item columns that the item has.</p>
214
235
<p>See also <a href="qstandarditem.html#setColumnCount">setColumnCount</a>() and <a href="qstandarditem.html#rowCount">rowCount</a>().</p>
236
<a name="//apple_ref/cpp/instm/QStandardItem/data" />
215
237
<h3 class="fn"><a name="data"></a><a href="qvariant.html">QVariant</a> QStandardItem::data ( int <i>role</i> = Qt::UserRole + 1 ) const <tt> [virtual]</tt></h3>
216
238
<p>Returns the item's data for the given <i>role</i>, or an invalid <a href="qvariant.html">QVariant</a> if there is no data for the role.</p>
217
239
<p><b>Note:</b> The default implementation treats <a href="qt.html#ItemDataRole-enum">Qt::EditRole</a> and <a href="qt.html#ItemDataRole-enum">Qt::DisplayRole</a> as referring to the same data.</p>
218
240
<p>See also <a href="qstandarditem.html#setData">setData</a>().</p>
241
<a name="//apple_ref/cpp/instm/QStandardItem/emitDataChanged" />
219
242
<h3 class="fn"><a name="emitDataChanged"></a>void QStandardItem::emitDataChanged () <tt> [protected]</tt></h3>
220
243
<p>Causes the model associated with this item to emit a <a href="qabstractitemmodel.html#dataChanged">dataChanged</a>() signal for this item.</p>
221
244
<p>You normally only need to call this function if you have subclassed <a href="qstandarditem.html">QStandardItem</a> and reimplemented <a href="qstandarditem.html#data">data</a>() and/or <a href="qstandarditem.html#setData">setData</a>().</p>
222
245
<p>This function was introduced in Qt 4.4.</p>
223
246
<p>See also <a href="qstandarditem.html#setData">setData</a>().</p>
247
<a name="//apple_ref/cpp/instm/QStandardItem/flags" />
224
248
<h3 class="fn"><a name="flags"></a><a href="qt.html#ItemFlag-enum">Qt::ItemFlags</a> QStandardItem::flags () const</h3>
225
249
<p>Returns the item flags for the item.</p>
226
250
<p>The item flags determine how the user can interact with the item.</p>
227
251
<p>By default, items are enabled, editable, selectable, checkable, and can be used both as the source of a drag and drop operation and as a drop target.</p>
228
252
<p>See also <a href="qstandarditem.html#setFlags">setFlags</a>().</p>
253
<a name="//apple_ref/cpp/instm/QStandardItem/font" />
229
254
<h3 class="fn"><a name="font"></a><a href="qfont.html">QFont</a> QStandardItem::font () const</h3>
230
255
<p>Returns the font used to render the item's text.</p>
231
256
<p>See also <a href="qstandarditem.html#setFont">setFont</a>().</p>
257
<a name="//apple_ref/cpp/instm/QStandardItem/foreground" />
232
258
<h3 class="fn"><a name="foreground"></a><a href="qbrush.html">QBrush</a> QStandardItem::foreground () const</h3>
233
259
<p>Returns the brush used to render the item's foreground (e.g. text).</p>
234
260
<p>See also <a href="qstandarditem.html#setForeground">setForeground</a>() and <a href="qstandarditem.html#background">background</a>().</p>
261
<a name="//apple_ref/cpp/instm/QStandardItem/hasChildren" />
235
262
<h3 class="fn"><a name="hasChildren"></a>bool QStandardItem::hasChildren () const</h3>
236
263
<p>Returns true if this item has any children; otherwise returns false.</p>
237
264
<p>See also <a href="qstandarditem.html#rowCount">rowCount</a>(), <a href="qstandarditem.html#columnCount">columnCount</a>(), and <a href="qstandarditem.html#child">child</a>().</p>
265
<a name="//apple_ref/cpp/instm/QStandardItem/icon" />
238
266
<h3 class="fn"><a name="icon"></a><a href="qicon.html">QIcon</a> QStandardItem::icon () const</h3>
239
267
<p>Returns the item's icon.</p>
240
268
<p>See also <a href="qstandarditem.html#setIcon">setIcon</a>() and <a href="qabstractitemview.html#iconSize-prop">iconSize</a>.</p>
269
<a name="//apple_ref/cpp/instm/QStandardItem/index" />
241
270
<h3 class="fn"><a name="index"></a><a href="qmodelindex.html">QModelIndex</a> QStandardItem::index () const</h3>
242
271
<p>Returns the <a href="qmodelindex.html">QModelIndex</a> associated with this item.</p>
243
272
<p>When you need to invoke item functionality in a <a href="qmodelindex.html">QModelIndex</a>-based API (e.g. <a href="qabstractitemview.html">QAbstractItemView</a>), you can call this function to obtain an index that corresponds to the item's location in the model.</p>
244
273
<p>If the item is not associated with a model, an invalid <a href="qmodelindex.html">QModelIndex</a> is returned.</p>
245
274
<p>See also <a href="qstandarditem.html#model">model</a>() and <a href="qstandarditemmodel.html#itemFromIndex">QStandardItemModel::itemFromIndex</a>().</p>
275
<a name="//apple_ref/cpp/instm/QStandardItem/insertColumn" />
246
276
<h3 class="fn"><a name="insertColumn"></a>void QStandardItem::insertColumn ( int <i>column</i>, const <a href="qlist.html">QList</a><QStandardItem *> & <i>items</i> )</h3>
247
277
<p>Inserts a column at <i>column</i> containing <i>items</i>. If necessary, the row count is increased to the size of <i>items</i>.</p>
248
278
<p>See also <a href="qstandarditem.html#insertColumns">insertColumns</a>() and <a href="qstandarditem.html#insertRow">insertRow</a>().</p>
279
<a name="//apple_ref/cpp/instm/QStandardItem/insertColumns" />
249
280
<h3 class="fn"><a name="insertColumns"></a>void QStandardItem::insertColumns ( int <i>column</i>, int <i>count</i> )</h3>
250
281
<p>Inserts <i>count</i> columns of child items at column <i>column</i>.</p>
251
282
<p>See also <a href="qstandarditem.html#insertColumn">insertColumn</a>() and <a href="qstandarditem.html#insertRows">insertRows</a>().</p>
283
<a name="//apple_ref/cpp/instm/QStandardItem/insertRow" />
252
284
<h3 class="fn"><a name="insertRow"></a>void QStandardItem::insertRow ( int <i>row</i>, const <a href="qlist.html">QList</a><QStandardItem *> & <i>items</i> )</h3>
253
285
<p>Inserts a row at <i>row</i> containing <i>items</i>. If necessary, the column count is increased to the size of <i>items</i>.</p>
254
286
<p>See also <a href="qstandarditem.html#insertRows">insertRows</a>() and <a href="qstandarditem.html#insertColumn">insertColumn</a>().</p>
256
288
<p>This is an overloaded function.</p>
257
289
<p>Inserts a row at <i>row</i> containing <i>item</i>.</p>
258
290
<p>When building a list or a tree that has only one column, this function provides a convenient way to insert a single new item.</p>
291
<a name="//apple_ref/cpp/instm/QStandardItem/insertRows" />
259
292
<h3 class="fn"><a name="insertRows"></a>void QStandardItem::insertRows ( int <i>row</i>, const <a href="qlist.html">QList</a><QStandardItem *> & <i>items</i> )</h3>
260
293
<p>Inserts <i>items</i> at <i>row</i>. The column count wont be changed.</p>
261
294
<p>See also <a href="qstandarditem.html#insertRow">insertRow</a>() and <a href="qstandarditem.html#insertColumn">insertColumn</a>().</p>
262
295
<h3 class="fn"><a name="insertRows-2"></a>void QStandardItem::insertRows ( int <i>row</i>, int <i>count</i> )</h3>
263
296
<p>Inserts <i>count</i> rows of child items at row <i>row</i>.</p>
264
297
<p>See also <a href="qstandarditem.html#insertRow">insertRow</a>() and <a href="qstandarditem.html#insertColumns">insertColumns</a>().</p>
298
<a name="//apple_ref/cpp/instm/QStandardItem/isCheckable" />
265
299
<h3 class="fn"><a name="isCheckable"></a>bool QStandardItem::isCheckable () const</h3>
266
300
<p>Returns whether the item is user-checkable.</p>
267
301
<p>The default value is false.</p>
268
302
<p>See also <a href="qstandarditem.html#setCheckable">setCheckable</a>(), <a href="qstandarditem.html#checkState">checkState</a>(), and <a href="qstandarditem.html#isTristate">isTristate</a>().</p>
303
<a name="//apple_ref/cpp/instm/QStandardItem/isDragEnabled" />
269
304
<h3 class="fn"><a name="isDragEnabled"></a>bool QStandardItem::isDragEnabled () const</h3>
270
305
<p>Returns whether the item is drag enabled. An item that is drag enabled can be dragged by the user.</p>
271
306
<p>The default value is true.</p>
272
307
<p>Note that item dragging must be enabled in the view for dragging to work; see <a href="qabstractitemview.html#dragEnabled-prop">QAbstractItemView::dragEnabled</a>.</p>
273
308
<p>See also <a href="qstandarditem.html#setDragEnabled">setDragEnabled</a>(), <a href="qstandarditem.html#isDropEnabled">isDropEnabled</a>(), and <a href="qstandarditem.html#flags">flags</a>().</p>
309
<a name="//apple_ref/cpp/instm/QStandardItem/isDropEnabled" />
274
310
<h3 class="fn"><a name="isDropEnabled"></a>bool QStandardItem::isDropEnabled () const</h3>
275
311
<p>Returns whether the item is drop enabled. When an item is drop enabled, it can be used as a drop target.</p>
276
312
<p>The default value is true.</p>
277
313
<p>See also <a href="qstandarditem.html#setDropEnabled">setDropEnabled</a>(), <a href="qstandarditem.html#isDragEnabled">isDragEnabled</a>(), and <a href="qstandarditem.html#flags">flags</a>().</p>
314
<a name="//apple_ref/cpp/instm/QStandardItem/isEditable" />
278
315
<h3 class="fn"><a name="isEditable"></a>bool QStandardItem::isEditable () const</h3>
279
316
<p>Returns whether the item can be edited by the user.</p>
280
317
<p>When an item is editable (and enabled), the user can edit the item by invoking one of the view's edit triggers; see <a href="qabstractitemview.html#editTriggers-prop">QAbstractItemView::editTriggers</a>.</p>
281
318
<p>The default value is true.</p>
282
319
<p>See also <a href="qstandarditem.html#setEditable">setEditable</a>() and <a href="qstandarditem.html#flags">flags</a>().</p>
320
<a name="//apple_ref/cpp/instm/QStandardItem/isEnabled" />
283
321
<h3 class="fn"><a name="isEnabled"></a>bool QStandardItem::isEnabled () const</h3>
284
322
<p>Returns whether the item is enabled.</p>
285
323
<p>When an item is enabled, the user can interact with it. The possible types of interaction are specified by the other item flags, such as <a href="qstandarditem.html#isEditable">isEditable</a>() and <a href="qstandarditem.html#isSelectable">isSelectable</a>().</p>
286
324
<p>The default value is true.</p>
287
325
<p>See also <a href="qstandarditem.html#setEnabled">setEnabled</a>() and <a href="qstandarditem.html#flags">flags</a>().</p>
326
<a name="//apple_ref/cpp/instm/QStandardItem/isSelectable" />
288
327
<h3 class="fn"><a name="isSelectable"></a>bool QStandardItem::isSelectable () const</h3>
289
328
<p>Returns whether the item is selectable by the user.</p>
290
329
<p>The default value is true.</p>
291
330
<p>See also <a href="qstandarditem.html#setSelectable">setSelectable</a>() and <a href="qstandarditem.html#flags">flags</a>().</p>
331
<a name="//apple_ref/cpp/instm/QStandardItem/isTristate" />
292
332
<h3 class="fn"><a name="isTristate"></a>bool QStandardItem::isTristate () const</h3>
293
333
<p>Returns whether the item is tristate; that is, if it's checkable with three separate states.</p>
294
334
<p>The default value is false.</p>
295
335
<p>See also <a href="qstandarditem.html#setTristate">setTristate</a>(), <a href="qstandarditem.html#isCheckable">isCheckable</a>(), and <a href="qstandarditem.html#checkState">checkState</a>().</p>
336
<a name="//apple_ref/cpp/instm/QStandardItem/model" />
296
337
<h3 class="fn"><a name="model"></a><a href="qstandarditemmodel.html">QStandardItemModel</a> * QStandardItem::model () const</h3>
297
338
<p>Returns the <a href="qstandarditemmodel.html">QStandardItemModel</a> that this item belongs to.</p>
298
339
<p>If the item is not a child of another item that belongs to the model, this function returns 0.</p>
299
340
<p>See also <a href="qstandarditem.html#index">index</a>().</p>
341
<a name="//apple_ref/cpp/instm/QStandardItem/parent" />
300
342
<h3 class="fn"><a name="parent"></a>QStandardItem * QStandardItem::parent () const</h3>
301
343
<p>Returns the item's parent item, or 0 if the item has no parent.</p>
302
344
<p>See also <a href="qstandarditem.html#child">child</a>().</p>
345
<a name="//apple_ref/cpp/instm/QStandardItem/read" />
303
346
<h3 class="fn"><a name="read"></a>void QStandardItem::read ( <a href="qdatastream.html">QDataStream</a> & <i>in</i> ) <tt> [virtual]</tt></h3>
304
347
<p>Reads the item from stream <i>in</i>. Only the data and flags of the item are read, not the child items.</p>
305
348
<p>See also <a href="qstandarditem.html#write">write</a>().</p>
349
<a name="//apple_ref/cpp/instm/QStandardItem/removeColumn" />
306
350
<h3 class="fn"><a name="removeColumn"></a>void QStandardItem::removeColumn ( int <i>column</i> )</h3>
307
351
<p>Removes the given <i>column</i>. The items that were in the column are deleted.</p>
308
352
<p>See also <a href="qstandarditem.html#takeColumn">takeColumn</a>(), <a href="qstandarditem.html#removeColumns">removeColumns</a>(), and <a href="qstandarditem.html#removeRow">removeRow</a>().</p>
353
<a name="//apple_ref/cpp/instm/QStandardItem/removeColumns" />
309
354
<h3 class="fn"><a name="removeColumns"></a>void QStandardItem::removeColumns ( int <i>column</i>, int <i>count</i> )</h3>
310
355
<p>Removes <i>count</i> columns at column <i>column</i>. The items that were in those columns are deleted.</p>
311
356
<p>See also <a href="qstandarditem.html#removeColumn">removeColumn</a>() and <a href="qstandarditem.html#removeRows">removeRows</a>().</p>
357
<a name="//apple_ref/cpp/instm/QStandardItem/removeRow" />
312
358
<h3 class="fn"><a name="removeRow"></a>void QStandardItem::removeRow ( int <i>row</i> )</h3>
313
359
<p>Removes the given <i>row</i>. The items that were in the row are deleted.</p>
314
360
<p>See also <a href="qstandarditem.html#takeRow">takeRow</a>(), <a href="qstandarditem.html#removeRows">removeRows</a>(), and <a href="qstandarditem.html#removeColumn">removeColumn</a>().</p>
361
<a name="//apple_ref/cpp/instm/QStandardItem/removeRows" />
315
362
<h3 class="fn"><a name="removeRows"></a>void QStandardItem::removeRows ( int <i>row</i>, int <i>count</i> )</h3>
316
363
<p>Removes <i>count</i> rows at row <i>row</i>. The items that were in those rows are deleted.</p>
317
364
<p>See also <a href="qstandarditem.html#removeRow">removeRow</a>() and <a href="qstandarditem.html#removeColumn">removeColumn</a>().</p>
365
<a name="//apple_ref/cpp/instm/QStandardItem/row" />
318
366
<h3 class="fn"><a name="row"></a>int QStandardItem::row () const</h3>
319
367
<p>Returns the row where the item is located in its parent's child table, or -1 if the item has no parent.</p>
320
368
<p>See also <a href="qstandarditem.html#column">column</a>() and <a href="qstandarditem.html#parent">parent</a>().</p>
369
<a name="//apple_ref/cpp/instm/QStandardItem/rowCount" />
321
370
<h3 class="fn"><a name="rowCount"></a>int QStandardItem::rowCount () const</h3>
322
371
<p>Returns the number of child item rows that the item has.</p>
323
372
<p>See also <a href="qstandarditem.html#setRowCount">setRowCount</a>() and <a href="qstandarditem.html#columnCount">columnCount</a>().</p>
373
<a name="//apple_ref/cpp/instm/QStandardItem/setAccessibleDescription" />
324
374
<h3 class="fn"><a name="setAccessibleDescription"></a>void QStandardItem::setAccessibleDescription ( const <a href="qstring.html">QString</a> & <i>accessibleDescription</i> )</h3>
325
375
<p>Sets the item's accessible description to the string specified by <i>accessibleDescription</i>.</p>
326
376
<p>The accessible description is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).</p>
327
377
<p>See also <a href="qstandarditem.html#accessibleDescription">accessibleDescription</a>() and <a href="qstandarditem.html#setAccessibleText">setAccessibleText</a>().</p>
378
<a name="//apple_ref/cpp/instm/QStandardItem/setAccessibleText" />
328
379
<h3 class="fn"><a name="setAccessibleText"></a>void QStandardItem::setAccessibleText ( const <a href="qstring.html">QString</a> & <i>accessibleText</i> )</h3>
329
380
<p>Sets the item's accessible text to the string specified by <i>accessibleText</i>.</p>
330
381
<p>The accessible text is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).</p>
331
382
<p>See also <a href="qstandarditem.html#accessibleText">accessibleText</a>() and <a href="qstandarditem.html#setAccessibleDescription">setAccessibleDescription</a>().</p>
383
<a name="//apple_ref/cpp/instm/QStandardItem/setBackground" />
332
384
<h3 class="fn"><a name="setBackground"></a>void QStandardItem::setBackground ( const <a href="qbrush.html">QBrush</a> & <i>brush</i> )</h3>
333
385
<p>Sets the item's background brush to the specified <i>brush</i>.</p>
334
386
<p>See also <a href="qstandarditem.html#background">background</a>() and <a href="qstandarditem.html#setForeground">setForeground</a>().</p>
387
<a name="//apple_ref/cpp/instm/QStandardItem/setCheckState" />
335
388
<h3 class="fn"><a name="setCheckState"></a>void QStandardItem::setCheckState ( <a href="qt.html#CheckState-enum">Qt::CheckState</a> <i>state</i> )</h3>
336
389
<p>Sets the check state of the item to be <i>state</i>.</p>
337
390
<p>See also <a href="qstandarditem.html#checkState">checkState</a>() and <a href="qstandarditem.html#setCheckable">setCheckable</a>().</p>
391
<a name="//apple_ref/cpp/instm/QStandardItem/setCheckable" />
338
392
<h3 class="fn"><a name="setCheckable"></a>void QStandardItem::setCheckable ( bool <i>checkable</i> )</h3>
339
393
<p>Sets whether the item is user-checkable. If <i>checkable</i> is true, the item can be checked by the user; otherwise, the user cannot check the item.</p>
340
394
<p>The item delegate will render a checkable item with a check box next to the item's text.</p>
341
395
<p>See also <a href="qstandarditem.html#isCheckable">isCheckable</a>(), <a href="qstandarditem.html#setCheckState">setCheckState</a>(), and <a href="qstandarditem.html#setTristate">setTristate</a>().</p>
396
<a name="//apple_ref/cpp/instm/QStandardItem/setChild" />
342
397
<h3 class="fn"><a name="setChild"></a>void QStandardItem::setChild ( int <i>row</i>, int <i>column</i>, QStandardItem * <i>item</i> )</h3>
343
398
<p>Sets the child item at (<i>row</i>, <i>column</i>) to <i>item</i>. This item (the parent item) takes ownership of <i>item</i>. If necessary, the row count and column count are increased to fit the item.</p>
344
399
<p>See also <a href="qstandarditem.html#child">child</a>().</p>
345
400
<h3 class="fn"><a name="setChild-2"></a>void QStandardItem::setChild ( int <i>row</i>, QStandardItem * <i>item</i> )</h3>
346
401
<p>This is an overloaded function.</p>
347
402
<p>Sets the child at <i>row</i> to <i>item</i>.</p>
403
<a name="//apple_ref/cpp/instm/QStandardItem/setColumnCount" />
348
404
<h3 class="fn"><a name="setColumnCount"></a>void QStandardItem::setColumnCount ( int <i>columns</i> )</h3>
349
405
<p>Sets the number of child item columns to <i>columns</i>. If this is less than <a href="qstandarditem.html#columnCount">columnCount</a>(), the data in the unwanted columns is discarded.</p>
350
406
<p>See also <a href="qstandarditem.html#columnCount">columnCount</a>() and <a href="qstandarditem.html#setRowCount">setRowCount</a>().</p>
407
<a name="//apple_ref/cpp/instm/QStandardItem/setData" />
351
408
<h3 class="fn"><a name="setData"></a>void QStandardItem::setData ( const <a href="qvariant.html">QVariant</a> & <i>value</i>, int <i>role</i> = Qt::UserRole + 1 ) <tt> [virtual]</tt></h3>
352
409
<p>Sets the item's data for the given <i>role</i> to the specified <i>value</i>.</p>
353
410
<p>If you subclass <a href="qstandarditem.html">QStandardItem</a> and reimplement this function, your reimplementation should call <a href="qstandarditem.html#emitDataChanged">emitDataChanged</a>() if you do not call the base implementation of setData(). This will ensure that e.g. views using the model are notified of the changes.</p>
354
411
<p><b>Note:</b> The default implementation treats <a href="qt.html#ItemDataRole-enum">Qt::EditRole</a> and <a href="qt.html#ItemDataRole-enum">Qt::DisplayRole</a> as referring to the same data.</p>
355
412
<p>See also <a href="qt.html#ItemDataRole-enum">Qt::ItemDataRole</a>, <a href="qstandarditem.html#data">data</a>(), and <a href="qstandarditem.html#setFlags">setFlags</a>().</p>
413
<a name="//apple_ref/cpp/instm/QStandardItem/setDragEnabled" />
356
414
<h3 class="fn"><a name="setDragEnabled"></a>void QStandardItem::setDragEnabled ( bool <i>dragEnabled</i> )</h3>
357
415
<p>Sets whether the item is drag enabled. If <i>dragEnabled</i> is true, the item can be dragged by the user; otherwise, the user cannot drag the item.</p>
358
416
<p>Note that you also need to ensure that item dragging is enabled in the view; see <a href="qabstractitemview.html#dragEnabled-prop">QAbstractItemView::dragEnabled</a>.</p>
359
417
<p>See also <a href="qstandarditem.html#isDragEnabled">isDragEnabled</a>(), <a href="qstandarditem.html#setDropEnabled">setDropEnabled</a>(), and <a href="qstandarditem.html#setFlags">setFlags</a>().</p>
418
<a name="//apple_ref/cpp/instm/QStandardItem/setDropEnabled" />
360
419
<h3 class="fn"><a name="setDropEnabled"></a>void QStandardItem::setDropEnabled ( bool <i>dropEnabled</i> )</h3>
361
420
<p>Sets whether the item is drop enabled. If <i>dropEnabled</i> is true, the item can be used as a drop target; otherwise, it cannot.</p>
362
421
<p>Note that you also need to ensure that drops are enabled in the view; see <a href="qwidget.html#acceptDrops-prop">QWidget::acceptDrops</a>(); and that the model supports the desired drop actions; see <a href="qabstractitemmodel.html#supportedDropActions">QAbstractItemModel::supportedDropActions</a>().</p>
363
422
<p>See also <a href="qstandarditem.html#isDropEnabled">isDropEnabled</a>(), <a href="qstandarditem.html#setDragEnabled">setDragEnabled</a>(), and <a href="qstandarditem.html#setFlags">setFlags</a>().</p>
423
<a name="//apple_ref/cpp/instm/QStandardItem/setEditable" />
364
424
<h3 class="fn"><a name="setEditable"></a>void QStandardItem::setEditable ( bool <i>editable</i> )</h3>
365
425
<p>Sets whether the item is editable. If <i>editable</i> is true, the item can be edited by the user; otherwise, the user cannot edit the item.</p>
366
426
<p>How the user can edit items in a view is determined by the view's edit triggers; see <a href="qabstractitemview.html#editTriggers-prop">QAbstractItemView::editTriggers</a>.</p>
367
427
<p>See also <a href="qstandarditem.html#isEditable">isEditable</a>() and <a href="qstandarditem.html#setFlags">setFlags</a>().</p>
428
<a name="//apple_ref/cpp/instm/QStandardItem/setEnabled" />
368
429
<h3 class="fn"><a name="setEnabled"></a>void QStandardItem::setEnabled ( bool <i>enabled</i> )</h3>
369
430
<p>Sets whether the item is enabled. If <i>enabled</i> is true, the item is enabled, meaning that the user can interact with the item; if <i>enabled</i> is false, the user cannot interact with the item.</p>
370
431
<p>This flag takes presedence over the other item flags; e.g. if an item is not enabled, it cannot be selected by the user, even if the <a href="qt.html#ItemFlag-enum">Qt::ItemIsSelectable</a> flag has been set.</p>
371
432
<p>See also <a href="qstandarditem.html#isEnabled">isEnabled</a>(), <a href="qt.html#ItemFlag-enum">Qt::ItemIsEnabled</a>, and <a href="qstandarditem.html#setFlags">setFlags</a>().</p>
433
<a name="//apple_ref/cpp/instm/QStandardItem/setFlags" />
372
434
<h3 class="fn"><a name="setFlags"></a>void QStandardItem::setFlags ( <a href="qt.html#ItemFlag-enum">Qt::ItemFlags</a> <i>flags</i> )</h3>
373
435
<p>Sets the item flags for the item to <i>flags</i>.</p>
374
436
<p>The item flags determine how the user can interact with the item. This is often used to disable an item.</p>
375
437
<p>See also <a href="qstandarditem.html#flags">flags</a>() and <a href="qstandarditem.html#setData">setData</a>().</p>
438
<a name="//apple_ref/cpp/instm/QStandardItem/setFont" />
376
439
<h3 class="fn"><a name="setFont"></a>void QStandardItem::setFont ( const <a href="qfont.html">QFont</a> & <i>font</i> )</h3>
377
440
<p>Sets the font used to display the item's text to the given <i>font</i>.</p>
378
441
<p>See also <a href="qstandarditem.html#font">font</a>(), <a href="qstandarditem.html#setText">setText</a>(), and <a href="qstandarditem.html#setForeground">setForeground</a>().</p>
442
<a name="//apple_ref/cpp/instm/QStandardItem/setForeground" />
379
443
<h3 class="fn"><a name="setForeground"></a>void QStandardItem::setForeground ( const <a href="qbrush.html">QBrush</a> & <i>brush</i> )</h3>
380
444
<p>Sets the brush used to display the item's foreground (e.g. text) to the given <i>brush</i>.</p>
381
445
<p>See also <a href="qstandarditem.html#foreground">foreground</a>(), <a href="qstandarditem.html#setBackground">setBackground</a>(), and <a href="qstandarditem.html#setFont">setFont</a>().</p>
446
<a name="//apple_ref/cpp/instm/QStandardItem/setIcon" />
382
447
<h3 class="fn"><a name="setIcon"></a>void QStandardItem::setIcon ( const <a href="qicon.html">QIcon</a> & <i>icon</i> )</h3>
383
448
<p>Sets the item's icon to the <i>icon</i> specified.</p>
384
449
<p>See also <a href="qstandarditem.html#icon">icon</a>().</p>
450
<a name="//apple_ref/cpp/instm/QStandardItem/setRowCount" />
385
451
<h3 class="fn"><a name="setRowCount"></a>void QStandardItem::setRowCount ( int <i>rows</i> )</h3>
386
452
<p>Sets the number of child item rows to <i>rows</i>. If this is less than <a href="qstandarditem.html#rowCount">rowCount</a>(), the data in the unwanted rows is discarded.</p>
387
453
<p>See also <a href="qstandarditem.html#rowCount">rowCount</a>() and <a href="qstandarditem.html#setColumnCount">setColumnCount</a>().</p>
454
<a name="//apple_ref/cpp/instm/QStandardItem/setSelectable" />
388
455
<h3 class="fn"><a name="setSelectable"></a>void QStandardItem::setSelectable ( bool <i>selectable</i> )</h3>
389
456
<p>Sets whether the item is selectable. If <i>selectable</i> is true, the item can be selected by the user; otherwise, the user cannot select the item.</p>
390
457
<p>You can control the selection behavior and mode by manipulating their view properties; see <a href="qabstractitemview.html#selectionMode-prop">QAbstractItemView::selectionMode</a> and <a href="qabstractitemview.html#selectionBehavior-prop">QAbstractItemView::selectionBehavior</a>.</p>
391
458
<p>See also <a href="qstandarditem.html#isSelectable">isSelectable</a>() and <a href="qstandarditem.html#setFlags">setFlags</a>().</p>
459
<a name="//apple_ref/cpp/instm/QStandardItem/setSizeHint" />
392
460
<h3 class="fn"><a name="setSizeHint"></a>void QStandardItem::setSizeHint ( const <a href="qsize.html">QSize</a> & <i>size</i> )</h3>
393
461
<p>Sets the size hint for the item to be <i>size</i>. If no size hint is set, the item delegate will compute the size hint based on the item data.</p>
394
462
<p>See also <a href="qstandarditem.html#sizeHint">sizeHint</a>().</p>
463
<a name="//apple_ref/cpp/instm/QStandardItem/setStatusTip" />
395
464
<h3 class="fn"><a name="setStatusTip"></a>void QStandardItem::setStatusTip ( const <a href="qstring.html">QString</a> & <i>statusTip</i> )</h3>
396
465
<p>Sets the item's status tip to the string specified by <i>statusTip</i>.</p>
397
466
<p>See also <a href="qstandarditem.html#statusTip">statusTip</a>(), <a href="qstandarditem.html#setToolTip">setToolTip</a>(), and <a href="qstandarditem.html#setWhatsThis">setWhatsThis</a>().</p>
467
<a name="//apple_ref/cpp/instm/QStandardItem/setText" />
398
468
<h3 class="fn"><a name="setText"></a>void QStandardItem::setText ( const <a href="qstring.html">QString</a> & <i>text</i> )</h3>
399
469
<p>Sets the item's text to the <i>text</i> specified.</p>
400
470
<p>See also <a href="qstandarditem.html#text">text</a>(), <a href="qstandarditem.html#setFont">setFont</a>(), and <a href="qstandarditem.html#setForeground">setForeground</a>().</p>
471
<a name="//apple_ref/cpp/instm/QStandardItem/setTextAlignment" />
401
472
<h3 class="fn"><a name="setTextAlignment"></a>void QStandardItem::setTextAlignment ( <a href="qt.html#AlignmentFlag-enum">Qt::Alignment</a> <i>alignment</i> )</h3>
402
473
<p>Sets the text alignment for the item's text to the <i>alignment</i> specified.</p>
403
474
<p>See also <a href="qstandarditem.html#textAlignment">textAlignment</a>().</p>
475
<a name="//apple_ref/cpp/instm/QStandardItem/setToolTip" />
404
476
<h3 class="fn"><a name="setToolTip"></a>void QStandardItem::setToolTip ( const <a href="qstring.html">QString</a> & <i>toolTip</i> )</h3>
405
477
<p>Sets the item's tooltip to the string specified by <i>toolTip</i>.</p>
406
478
<p>See also <a href="qstandarditem.html#toolTip">toolTip</a>(), <a href="qstandarditem.html#setStatusTip">setStatusTip</a>(), and <a href="qstandarditem.html#setWhatsThis">setWhatsThis</a>().</p>
479
<a name="//apple_ref/cpp/instm/QStandardItem/setTristate" />
407
480
<h3 class="fn"><a name="setTristate"></a>void QStandardItem::setTristate ( bool <i>tristate</i> )</h3>
408
481
<p>Sets whether the item is tristate. If <i>tristate</i> is true, the item is checkable with three separate states; otherwise, the item is checkable with two states. (Note that this also requires that the item is checkable; see <a href="qstandarditem.html#isCheckable">isCheckable</a>().)</p>
409
482
<p>See also <a href="qstandarditem.html#isTristate">isTristate</a>(), <a href="qstandarditem.html#setCheckable">setCheckable</a>(), and <a href="qstandarditem.html#setCheckState">setCheckState</a>().</p>
483
<a name="//apple_ref/cpp/instm/QStandardItem/setWhatsThis" />
410
484
<h3 class="fn"><a name="setWhatsThis"></a>void QStandardItem::setWhatsThis ( const <a href="qstring.html">QString</a> & <i>whatsThis</i> )</h3>
411
485
<p>Sets the item's "What's This?" help to the string specified by <i>whatsThis</i>.</p>
412
486
<p>See also <a href="qstandarditem.html#whatsThis">whatsThis</a>(), <a href="qstandarditem.html#setStatusTip">setStatusTip</a>(), and <a href="qstandarditem.html#setToolTip">setToolTip</a>().</p>
487
<a name="//apple_ref/cpp/instm/QStandardItem/sizeHint" />
413
488
<h3 class="fn"><a name="sizeHint"></a><a href="qsize.html">QSize</a> QStandardItem::sizeHint () const</h3>
414
489
<p>Returns the size hint set for the item, or an invalid <a href="qsize.html">QSize</a> if no size hint has been set.</p>
415
490
<p>If no size hint has been set, the item delegate will compute the size hint based on the item data.</p>
416
491
<p>See also <a href="qstandarditem.html#setSizeHint">setSizeHint</a>().</p>
492
<a name="//apple_ref/cpp/instm/QStandardItem/sortChildren" />
417
493
<h3 class="fn"><a name="sortChildren"></a>void QStandardItem::sortChildren ( int <i>column</i>, <a href="qt.html#SortOrder-enum">Qt::SortOrder</a> <i>order</i> = Qt::AscendingOrder )</h3>
418
494
<p>Sorts the children of the item using the given <i>order</i>, by the values in the given <i>column</i>.</p>
419
495
<p><b>Note:</b> This function is recursive, therefore it sorts the children of the item, its grandchildren, etc.</p>
420
496
<p>See also <a href="qstandarditem.html#operator-lt">operator<</a>().</p>
497
<a name="//apple_ref/cpp/instm/QStandardItem/statusTip" />
421
498
<h3 class="fn"><a name="statusTip"></a><a href="qstring.html">QString</a> QStandardItem::statusTip () const</h3>
422
499
<p>Returns the item's status tip.</p>
423
500
<p>See also <a href="qstandarditem.html#setStatusTip">setStatusTip</a>(), <a href="qstandarditem.html#toolTip">toolTip</a>(), and <a href="qstandarditem.html#whatsThis">whatsThis</a>().</p>
501
<a name="//apple_ref/cpp/instm/QStandardItem/takeChild" />
424
502
<h3 class="fn"><a name="takeChild"></a>QStandardItem * QStandardItem::takeChild ( int <i>row</i>, int <i>column</i> = 0 )</h3>
425
503
<p>Removes the child item at (<i>row</i>, <i>column</i>) without deleting it, and returns a pointer to the item. If there was no child at the given location, then this function returns 0.</p>
426
504
<p>Note that this function, unlike <a href="qstandarditem.html#takeRow">takeRow</a>() and <a href="qstandarditem.html#takeColumn">takeColumn</a>(), does not affect the dimensions of the child table.</p>
427
505
<p>See also <a href="qstandarditem.html#child">child</a>(), <a href="qstandarditem.html#takeRow">takeRow</a>(), and <a href="qstandarditem.html#takeColumn">takeColumn</a>().</p>
506
<a name="//apple_ref/cpp/instm/QStandardItem/takeColumn" />
428
507
<h3 class="fn"><a name="takeColumn"></a><a href="qlist.html">QList</a><QStandardItem *> QStandardItem::takeColumn ( int <i>column</i> )</h3>
429
508
<p>Removes <i>column</i> without deleting the column items, and returns a list of pointers to the removed items. For items in the column that have not been set, the corresponding pointers in the list will be 0.</p>
430
509
<p>See also <a href="qstandarditem.html#removeColumn">removeColumn</a>(), <a href="qstandarditem.html#insertColumn">insertColumn</a>(), and <a href="qstandarditem.html#takeRow">takeRow</a>().</p>
510
<a name="//apple_ref/cpp/instm/QStandardItem/takeRow" />
431
511
<h3 class="fn"><a name="takeRow"></a><a href="qlist.html">QList</a><QStandardItem *> QStandardItem::takeRow ( int <i>row</i> )</h3>
432
512
<p>Removes <i>row</i> without deleting the row items, and returns a list of pointers to the removed items. For items in the row that have not been set, the corresponding pointers in the list will be 0.</p>
433
513
<p>See also <a href="qstandarditem.html#removeRow">removeRow</a>(), <a href="qstandarditem.html#insertRow">insertRow</a>(), and <a href="qstandarditem.html#takeColumn">takeColumn</a>().</p>
514
<a name="//apple_ref/cpp/instm/QStandardItem/text" />
434
515
<h3 class="fn"><a name="text"></a><a href="qstring.html">QString</a> QStandardItem::text () const</h3>
435
516
<p>Returns the item's text. This is the text that's presented to the user in a view.</p>
436
517
<p>See also <a href="qstandarditem.html#setText">setText</a>().</p>
518
<a name="//apple_ref/cpp/instm/QStandardItem/textAlignment" />
437
519
<h3 class="fn"><a name="textAlignment"></a><a href="qt.html#AlignmentFlag-enum">Qt::Alignment</a> QStandardItem::textAlignment () const</h3>
438
520
<p>Returns the text alignment for the item's text.</p>
439
521
<p>See also <a href="qstandarditem.html#setTextAlignment">setTextAlignment</a>().</p>
522
<a name="//apple_ref/cpp/instm/QStandardItem/toolTip" />
440
523
<h3 class="fn"><a name="toolTip"></a><a href="qstring.html">QString</a> QStandardItem::toolTip () const</h3>
441
524
<p>Returns the item's tooltip.</p>
442
525
<p>See also <a href="qstandarditem.html#setToolTip">setToolTip</a>(), <a href="qstandarditem.html#statusTip">statusTip</a>(), and <a href="qstandarditem.html#whatsThis">whatsThis</a>().</p>
526
<a name="//apple_ref/cpp/instm/QStandardItem/type" />
443
527
<h3 class="fn"><a name="type"></a>int QStandardItem::type () const <tt> [virtual]</tt></h3>
444
528
<p>Returns the type of this item. The type is used to distinguish custom items from the base class. When subclassing <a href="qstandarditem.html">QStandardItem</a>, you should reimplement this function and return a new value greater than or equal to <a href="qstandarditem.html#ItemType-enum">UserType</a>.</p>
445
529
<p>See also <a href="qstandarditem.html#ItemType-enum">QStandardItem::Type</a>.</p>
530
<a name="//apple_ref/cpp/instm/QStandardItem/whatsThis" />
446
531
<h3 class="fn"><a name="whatsThis"></a><a href="qstring.html">QString</a> QStandardItem::whatsThis () const</h3>
447
532
<p>Returns the item's "What's This?" help.</p>
448
533
<p>See also <a href="qstandarditem.html#setWhatsThis">setWhatsThis</a>(), <a href="qstandarditem.html#toolTip">toolTip</a>(), and <a href="qstandarditem.html#statusTip">statusTip</a>().</p>
534
<a name="//apple_ref/cpp/instm/QStandardItem/write" />
449
535
<h3 class="fn"><a name="write"></a>void QStandardItem::write ( <a href="qdatastream.html">QDataStream</a> & <i>out</i> ) const <tt> [virtual]</tt></h3>
450
536
<p>Writes the item to stream <i>out</i>. Only the data and flags of the item are written, not the child items.</p>
451
537
<p>See also <a href="qstandarditem.html#read">read</a>().</p>
538
<a name="//apple_ref/cpp/instm/QStandardItem/operator<" />
452
539
<h3 class="fn"><a name="operator-lt"></a>bool QStandardItem::operator< ( const QStandardItem & <i>other</i> ) const <tt> [virtual]</tt></h3>
453
540
<p>Returns true if this item is less than <i>other</i>; otherwise returns false.</p>
454
541
<p>The default implementation uses the data for the item's sort role (see <a href="qstandarditemmodel.html#sortRole-prop">QStandardItemModel::sortRole</a>) to perform the comparison if the item belongs to a model; otherwise, the data for the item's <a href="qt.html#ItemDataRole-enum">Qt::DisplayRole</a> (<a href="qstandarditem.html#text">text</a>()) is used to perform the comparison.</p>
455
<p><a href="qstandarditem.html#sortChildren">sortChildren</a>() and <a href="qabstractitemmodel.html#sort">QStandardItemModel::sort</a>() use this function when sorting items. If you want custom sorting, you can subclass <a href="qstandarditem.html">QStandardItem</a> and reimplement this function.</p>
542
<p><a href="qstandarditem.html#sortChildren">sortChildren</a>() and <a href="qstandarditemmodel.html#sort">QStandardItemModel::sort</a>() use this function when sorting items. If you want custom sorting, you can subclass <a href="qstandarditem.html">QStandardItem</a> and reimplement this function.</p>
543
<a name="//apple_ref/cpp/instm/QStandardItem/operator=" />
456
544
<h3 class="fn"><a name="operator-eq"></a>QStandardItem & QStandardItem::operator= ( const QStandardItem & <i>other</i> ) <tt> [protected]</tt></h3>
457
545
<p>Assigns <i>other</i>'s data and flags to this item. Note that <a href="qstandarditem.html#type">type</a>() and <a href="qstandarditem.html#model">model</a>() are not copied.</p>
458
546
<p>This function is useful when reimplementing <a href="qstandarditem.html#clone">clone</a>().</p>
460
548
<h2>Related Non-Members</h2>
461
<h3 class="fn"><a name="operator-lt-lt-155"></a><a href="qdatastream.html">QDataStream</a> & operator<< ( <a href="qdatastream.html">QDataStream</a> & <i>out</i>, const QStandardItem & <i>item</i> )</h3>
549
<h3 class="fn"><a name="operator-lt-lt-40"></a><a href="qdatastream.html">QDataStream</a> & operator<< ( <a href="qdatastream.html">QDataStream</a> & <i>out</i>, const QStandardItem & <i>item</i> )</h3>
462
550
<p>Writes the <a href="qstandarditem.html">QStandardItem</a> <i>item</i> to stream <i>out</i>.</p>
463
551
<p>This operator uses <a href="qstandarditem.html#write">QStandardItem::write</a>().</p>
464
552
<p>This function was introduced in Qt 4.2.</p>
465
553
<p>See also <a href="datastreamformat.html">Format of the QDataStream Operators</a>.</p>
466
<h3 class="fn"><a name="operator-gt-gt-90"></a><a href="qdatastream.html">QDataStream</a> & operator>> ( <a href="qdatastream.html">QDataStream</a> & <i>in</i>, QStandardItem & <i>item</i> )</h3>
554
<h3 class="fn"><a name="operator-gt-gt-16"></a><a href="qdatastream.html">QDataStream</a> & operator>> ( <a href="qdatastream.html">QDataStream</a> & <i>in</i>, QStandardItem & <i>item</i> )</h3>
467
555
<p>Reads a <a href="qstandarditem.html">QStandardItem</a> from stream <i>in</i> into <i>item</i>.</p>
468
556
<p>This operator uses <a href="qstandarditem.html#read">QStandardItem::read</a>().</p>
469
557
<p>This function was introduced in Qt 4.2.</p>
470
558
<p>See also <a href="datastreamformat.html">Format of the QDataStream Operators</a>.</p>
471
559
<p /><address><hr /><div align="center">
472
560
<table width="100%" cellspacing="0" border="0"><tr class="address">
473
<td width="30%" align="left">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies)</td>
474
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
475
<td width="30%" align="right"><div align="right">Qt 4.5.2</div></td>
476
</tr></table></div></address></body>
561
<td width="40%" align="left">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies)</td>
562
<td width="20%" align="center"><a href="trademarks.html">Trademarks</a></td>
563
<td width="40%" align="right"><div align="right">Qt 4.6.0</div></td>
564
<script type="text/javascript" src="http://www.google.com/jsapi"></script><script type="text/javascript">google.load("elements", "1", {packages: "transliteration"});</script><script type="text/javascript" src="http://www.google.com/coop/cse/t13n?form=cse-search-box&t13n_langs=en"></script><script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=cse-search-box&lang=en"></script></tr></table></div></address></body>