The QStandardItem 類提供項為用於 QStandardItemModel 類。 更多...
| 頭： | #include <QStandardItem> |
| qmake: | QT += gui |
| Since: | Qt 4.2 |
| enum | ItemType { Type, UserType } |
| QStandardItem () | |
| QStandardItem (const QString & text ) | |
| QStandardItem (const QIcon & icon , const QString & text ) | |
| QStandardItem (int rows , int columns = 1) | |
| virtual | ~QStandardItem () |
| QString | accessibleDescription () const |
| QString | accessibleText () const |
| void | appendColumn (const QList<QStandardItem *> & items ) |
| void | appendRow (const QList<QStandardItem *> & items ) |
| void | appendRow (QStandardItem * item ) |
| void | appendRows (const QList<QStandardItem *> & items ) |
| QBrush | background () const |
| Qt::CheckState | checkState () const |
| QStandardItem * | child (int row , int column = 0) const |
| void | clearData () |
| virtual QStandardItem * | clone () const |
| int | column () const |
| int | columnCount () const |
| virtual QVariant | data (int role = Qt::UserRole + 1) const |
| Qt::ItemFlags | flags () const |
| QFont | font () const |
| QBrush | foreground () const |
| bool | hasChildren () const |
| QIcon | icon () const |
| QModelIndex | index () const |
| void | insertColumn (int column , const QList<QStandardItem *> & items ) |
| void | insertColumns (int column , int count ) |
| void | insertRow (int row , const QList<QStandardItem *> & items ) |
| void | insertRow (int row , QStandardItem * item ) |
| void | insertRows (int row , const QList<QStandardItem *> & items ) |
| void | insertRows (int row , int count ) |
| bool | isAutoTristate () const |
| bool | isCheckable () const |
| bool | isDragEnabled () const |
| bool | isDropEnabled () const |
| bool | isEditable () const |
| bool | isEnabled () const |
| bool | isSelectable () const |
| bool | isUserTristate () const |
| QStandardItemModel * | model () const |
| QStandardItem * | parent () const |
| virtual void | read (QDataStream & in ) |
| void | removeColumn (int column ) |
| void | removeColumns (int column , int count ) |
| void | removeRow (int row ) |
| void | removeRows (int row , int count ) |
| int | row () const |
| int | rowCount () const |
| void | setAccessibleDescription (const QString & accessibleDescription ) |
| void | setAccessibleText (const QString & accessibleText ) |
| void | setAutoTristate (bool tristate ) |
| void | setBackground (const QBrush & brush ) |
| void | setCheckState (Qt::CheckState state ) |
| void | setCheckable (bool checkable ) |
| void | setChild (int row , int column , QStandardItem * item ) |
| void | setChild (int row , QStandardItem * item ) |
| void | setColumnCount (int columns ) |
| virtual void | setData (const QVariant & value , int role = Qt::UserRole + 1) |
| void | setDragEnabled (bool dragEnabled ) |
| void | setDropEnabled (bool dropEnabled ) |
| void | setEditable (bool editable ) |
| void | setEnabled (bool enabled ) |
| void | setFlags (Qt::ItemFlags flags ) |
| void | setFont (const QFont & font ) |
| void | setForeground (const QBrush & brush ) |
| void | setIcon (const QIcon & icon ) |
| void | setRowCount (int rows ) |
| void | setSelectable (bool selectable ) |
| void | setSizeHint (const QSize & size ) |
| void | setStatusTip (const QString & statusTip ) |
| void | setText (const QString & text ) |
| void | setTextAlignment (Qt::Alignment alignment ) |
| void | setToolTip (const QString & toolTip ) |
| void | setUserTristate (bool tristate ) |
| void | setWhatsThis (const QString & whatsThis ) |
| QSize | sizeHint () const |
| void | sortChildren (int column , Qt::SortOrder order = Qt::AscendingOrder) |
| QString | statusTip () const |
| QStandardItem * | takeChild (int row , int column = 0) |
| QList<QStandardItem *> | takeColumn (int column ) |
| QList<QStandardItem *> | takeRow (int row ) |
| QString | text () const |
| Qt::Alignment | textAlignment () const |
| QString | toolTip () const |
| virtual int | type () const |
| QString | whatsThis () const |
| virtual void | write (QDataStream & out ) const |
| virtual bool | operator< (const QStandardItem & other ) const |
| QStandardItem (const QStandardItem & other ) | |
| void | emitDataChanged () |
| QStandardItem & | operator= (const QStandardItem & other ) |
| QScopedPointer<QStandardItemPrivate> | d_ptr |
| QDataStream & | operator<< (QDataStream & out , const QStandardItem & item ) |
| QDataStream & | operator>> (QDataStream & in , QStandardItem & item ) |
The QStandardItem 類提供項為用於 QStandardItemModel 類。
Items usually contain text, icons, or checkboxes.
Each item can have its own background brush which is set with the setBackground () 函數。可以找到當前背景筆刷采用 background (). The text label for each item can be rendered with its own font and brush. These are specified with the setFont () 和 setForeground () 函數，和讀取采用 font () 和 foreground ().
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. Each item's flags can be changed by calling setFlags (). Checkable items can be checked and unchecked with the setCheckState () 函數。相應 checkState () 函數指示項目前是否被復選。
You can store application-specific data in an item by calling setData ().
Each item can have a two-dimensional table of child items. This makes it possible to build hierarchies of items. The typical hierarchy is the tree, in which case the child table is a table with a single column (a list).
The dimensions of the child table can be set with setRowCount () 和 setColumnCount (). Items can be positioned in the child table with setChild (). Get a pointer to a child item with child (). New rows and columns of children can also be inserted with insertRow () 和 insertColumn (), or appended with appendRow () 和 appendColumn (). When using the append and insert functions, the dimensions of the child table will grow as needed.
An existing row of children can be removed with removeRow () 或 takeRow (); correspondingly, a column can be removed with removeColumn () 或 takeColumn ().
An item's children can be sorted by calling sortChildren ().
當子類化 QStandardItem to provide custom items, it is possible to define new types for them so that they can be distinguished from the base class. The type () function should be reimplemented to return a new type value equal to or greater than UserType .
重實現 data () 和 setData () if you want to perform custom handling of data queries and/or control how an item's data is represented.
重實現 clone () if you want QStandardItemModel to be able to create instances of your custom item class on demand (see QStandardItemModel::setItemPrototype ()).
重實現 read () 和 write () if you want to control how items are represented in their serialized form.
重實現 operator< () if you want to control the semantics of item comparison. operator< () determines the sorted order when sorting items with sortChildren () 或采用 QStandardItemModel::sort ().
另請參閱 QStandardItemModel , 項視圖方便類 ，和 模型/視圖編程 .
This enum describes the types that are used to describe standard items.
| 常量 | 值 | 描述 |
|---|---|---|
QStandardItem::Type
|
0
|
The default type for standard items. |
QStandardItem::UserType
|
1000
|
用於自定義類型的最小值。低於 UserType 的值由 Qt 預留。 |
可以定義新用戶類型在 QStandardItem 子類以確保自定義項得到特殊處理；例如，當排序項時。
另請參閱 type ().
Constructs an item.
Constructs an item with the given text .
Constructs an item with the given icon and text .
Constructs an item with rows rows and columns columns of child items.
[protected]
QStandardItem::
QStandardItem
(const
QStandardItem
&
other
)
構造副本為 other 。注意， model () is not copied.
此函數是有用的，當重實現 clone ().
[虛擬]
QStandardItem::
~QStandardItem
()
Destructs the item. This causes the item's children to be destructed as well.
Returns the item's accessible description.
The accessible description is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).
另請參閱 setAccessibleDescription () 和 accessibleText ().
Returns the item's accessible text.
The accessible text is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).
另請參閱 setAccessibleText () 和 accessibleDescription ().
Appends a column containing items . If necessary, the row count is increased to the size of items .
另請參閱 insertColumn ().
Appends a row containing items . If necessary, the column count is increased to the size of items .
另請參閱 insertRow ().
這是重載函數。
Appends a row containing item .
When building a list or a tree that has only one column, this function provides a convenient way to append a single new item.
Appends rows containing items . The column count will not change.
另請參閱 insertRow ().
Returns the brush used to render the item's background.
另請參閱 foreground () 和 setBackground ().
Returns the checked state of the item.
另請參閱 setCheckState () 和 isCheckable ().
Returns the child item at (
row
,
column
) if one has been set; otherwise returns
nullptr
.
另請參閱 setChild (), takeChild ()，和 parent ().
Removes all the data from all roles previously set.
該函數在 Qt 5.12 引入。
[虛擬]
QStandardItem
*QStandardItem::
clone
() const
Returns a copy of this item. The item's children are not copied.
當子類化 QStandardItem , you can reimplement this function to provide QStandardItemModel with a factory that it can use to create new items on demand.
另請參閱 QStandardItemModel::setItemPrototype () 和 operator= ().
Returns the column where the item is located in its parent's child table, or -1 if the item has no parent.
Returns the number of child item columns that the item has.
另請參閱 setColumnCount () 和 rowCount ().
[虛擬]
QVariant
QStandardItem::
data
(
int
role
= Qt::UserRole + 1) const
Returns the item's data for the given role ，或無效 QVariant if there is no data for the role.
注意： 默認實現視 Qt::EditRole and Qt::DisplayRole 為引用相同數據。
另請參閱 setData ().
[protected]
void
QStandardItem::
emitDataChanged
()
促使關聯此項的模型發射 dataChanged () 信號對於此項。
通常隻需調用此函數若有子類化 QStandardItem 並重實現 data () 和/或 setData ().
該函數在 Qt 4.4 引入。
另請參閱 setData ().
Returns the item flags for the item.
The item flags determine how the user can interact with the item.
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.
另請參閱 setFlags ().
Returns the font used to render the item's text.
另請參閱 setFont ().
Returns the brush used to render the item's foreground (e.g. text).
另請參閱 setForeground () 和 background ().
返迴
true
if this item has any children; otherwise returns
false
.
另請參閱 rowCount (), columnCount ()，和 child ().
返迴項圖標。
返迴 QModelIndex associated with this item.
When you need to invoke item functionality in a QModelIndex -based API (e.g. QAbstractItemView ), you can call this function to obtain an index that corresponds to the item's location in the model.
If the item is not associated with a model, an invalid QModelIndex 被返迴。
另請參閱 model () 和 QStandardItemModel::itemFromIndex ().
Inserts a column at column 包含 items . If necessary, the row count is increased to the size of items .
另請參閱 insertColumns () 和 insertRow ().
插入 count columns of child items at column column .
另請參閱 insertColumn () 和 insertRows ().
Inserts a row at row 包含 items . If necessary, the column count is increased to the size of items .
另請參閱 insertRows () 和 insertColumn ().
這是重載函數。
Inserts a row at row 包含 item .
When building a list or a tree that has only one column, this function provides a convenient way to insert a single new item.
插入 items at row . The column count won't be changed.
另請參閱 insertRow () 和 insertColumn ().
插入 count rows of child items at row row .
另請參閱 insertRow () 和 insertColumns ().
Returns whether the item is tristate and is controlled by QTreeWidget .
默認值為 false。
該函數在 Qt 5.6 引入。
另請參閱 setAutoTristate (), isCheckable ()，和 checkState ().
Returns whether the item is user-checkable.
默認值為 false。
另請參閱 setCheckable (), checkState (), isUserTristate ()，和 isAutoTristate ().
Returns whether the item is drag enabled. An item that is drag enabled can be dragged by the user.
默認值為 true。
Note that item dragging must be enabled in the view for dragging to work; see QAbstractItemView::dragEnabled .
另請參閱 setDragEnabled (), isDropEnabled ()，和 flags ().
Returns whether the item is drop enabled. When an item is drop enabled, it can be used as a drop target.
默認值為 true。
另請參閱 setDropEnabled (), isDragEnabled ()，和 flags ().
Returns whether the item can be edited by the user.
When an item is editable (and enabled), the user can edit the item by invoking one of the view's edit triggers; see QAbstractItemView::editTriggers .
默認值為 true。
另請參閱 setEditable () 和 flags ().
Returns whether the item is enabled.
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 isEditable () 和 isSelectable ().
默認值為 true。
另請參閱 setEnabled () 和 flags ().
Returns whether the item is selectable by the user.
默認值為 true。
另請參閱 setSelectable () 和 flags ().
Returns whether the item is tristate; that is, if it's checkable with three separate states and the user can cycle through all three states.
默認值為 false。
該函數在 Qt 5.6 引入。
另請參閱 setUserTristate (), isCheckable ()，和 checkState ().
返迴 QStandardItemModel that this item belongs to.
If the item is not a child of another item that belongs to the model, this function returns
nullptr
.
另請參閱 index ().
Returns the item's parent item, or
nullptr
if the item has no parent.
注意：
For toplevel items parent() returns
nullptr
. To receive toplevel item's parent use
QStandardItemModel::invisibleRootItem
() 代替。
另請參閱 child () 和 QStandardItemModel::invisibleRootItem ().
[虛擬]
void
QStandardItem::
read
(
QDataStream
&
in
)
讀取項從流 in . Only the data and flags of the item are read, not the child items.
另請參閱 write ().
移除給定 column . The items that were in the column are deleted.
另請參閱 takeColumn (), removeColumns ()，和 removeRow ().
移除 count columns at column column . The items that were in those columns are deleted.
另請參閱 removeColumn () 和 removeRows ().
移除給定 row . The items that were in the row are deleted.
另請參閱 takeRow (), removeRows ()，和 removeColumn ().
移除 count rows at row row . The items that were in those rows are deleted.
另請參閱 removeRow () 和 removeColumn ().
Returns the row where the item is located in its parent's child table, or -1 if the item has no parent.
Returns the number of child item rows that the item has.
另請參閱 setRowCount () 和 columnCount ().
Sets the item's accessible description to the string specified by accessibleDescription .
The accessible description is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).
另請參閱 accessibleDescription () 和 setAccessibleText ().
Sets the item's accessible text to the string specified by accessibleText .
The accessible text is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).
另請參閱 accessibleText () 和 setAccessibleDescription ().
Determines that the item is tristate and controlled by
QTreeWidget
if
tristate
is
true
. This enables automatic management of the state of parent items in
QTreeWidget
(復選若所有子級被復選，取消復選若所有子級被取消復選，或部分復選若僅某些子級被復選)。
該函數在 Qt 5.6 引入。
另請參閱 isAutoTristate (), setCheckable ()，和 setCheckState ().
Sets the item's background brush to the specified brush .
另請參閱 background () 和 setForeground ().
Sets the check state of the item to be state .
另請參閱 checkState () 和 setCheckable ().
Sets whether the item is user-checkable. If checkable is true, the item can be checked by the user; otherwise, the user cannot check the item.
The item delegate will render a checkable item with a check box next to the item's text.
另請參閱 isCheckable (), setCheckState (), setUserTristate ()，和 setAutoTristate ().
Sets the child item at ( row , column ) 到 item . This item (the parent item) takes ownership of item . If necessary, the row count and column count are increased to fit the item.
注意： Passing a null pointer as item removes the item.
另請參閱 child ().
這是重載函數。
Sets the child at row to item .
Sets the number of child item columns to columns 。若這小於 columnCount ()，不想要列中的數據被丟棄。
另請參閱 columnCount () 和 setRowCount ().
[虛擬]
void
QStandardItem::
setData
(const
QVariant
&
value
,
int
role
= Qt::UserRole + 1)
Sets the item's data for the given role 到指定 value .
若子類 QStandardItem and reimplement this function, your reimplementation should call emitDataChanged () 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.
注意： 默認實現視 Qt::EditRole and Qt::DisplayRole 為引用相同數據。
另請參閱 Qt::ItemDataRole , data ()，和 setFlags ().
Sets whether the item is drag enabled. If dragEnabled is true, the item can be dragged by the user; otherwise, the user cannot drag the item.
Note that you also need to ensure that item dragging is enabled in the view; see QAbstractItemView::dragEnabled .
另請參閱 isDragEnabled (), setDropEnabled ()，和 setFlags ().
Sets whether the item is drop enabled. If dropEnabled is true, the item can be used as a drop target; otherwise, it cannot.
Note that you also need to ensure that drops are enabled in the view; see QWidget::acceptDrops (); and that the model supports the desired drop actions; see QAbstractItemModel::supportedDropActions ().
另請參閱 isDropEnabled (), setDragEnabled ()，和 setFlags ().
Sets whether the item is editable. If editable is true, the item can be edited by the user; otherwise, the user cannot edit the item.
How the user can edit items in a view is determined by the view's edit triggers; see QAbstractItemView::editTriggers .
另請參閱 isEditable () 和 setFlags ().
Sets whether the item is enabled. If enabled is true, the item is enabled, meaning that the user can interact with the item; if enabled is false, the user cannot interact with the item.
This flag takes precedence over the other item flags; e.g. if an item is not enabled, it cannot be selected by the user, even if the Qt::ItemIsSelectable flag has been set.
另請參閱 isEnabled (), Qt::ItemIsEnabled ，和 setFlags ().
Sets the item flags for the item to flags .
The item flags determine how the user can interact with the item. This is often used to disable an item.
Sets the font used to display the item's text to the given font .
另請參閱 font (), setText ()，和 setForeground ().
Sets the brush used to display the item's foreground (e.g. text) to the given brush .
另請參閱 foreground (), setBackground ()，和 setFont ().
Sets the item's icon to the icon 指定。
另請參閱 icon ().
Sets the number of child item rows to rows 。若這小於 rowCount ()，丟棄不想要行中的數據。
另請參閱 rowCount () 和 setColumnCount ().
Sets whether the item is selectable. If selectable is true, the item can be selected by the user; otherwise, the user cannot select the item.
You can control the selection behavior and mode by manipulating their view properties; see QAbstractItemView::selectionMode and QAbstractItemView::selectionBehavior .
另請參閱 isSelectable () 和 setFlags ().
Sets the size hint for the item to be size 。若未設置大小提示，項委托將基於項數據計算大小提示。
另請參閱 sizeHint ().
Sets the item's status tip to the string specified by statusTip .
另請參閱 statusTip (), setToolTip ()，和 setWhatsThis ().
Sets the item's text to the text 指定。
另請參閱 text (), setFont ()，和 setForeground ().
Sets the text alignment for the item's text to the alignment 指定。
另請參閱 textAlignment ().
Sets the item's tooltip to the string specified by toolTip .
另請參閱 toolTip (), setStatusTip ()，和 setWhatsThis ().
Sets whether the item is tristate and controlled by the user. If tristate is true, the user can cycle through three separate states; otherwise, the item is checkable with two states. (Note that this also requires that the item is checkable; see isCheckable ().)
該函數在 Qt 5.6 引入。
另請參閱 isUserTristate (), setCheckable ()，和 setCheckState ().
Sets the item's "What's This?" help to the string specified by whatsThis .
另請參閱 whatsThis (), setStatusTip ()，和 setToolTip ().
Returns the size hint set for the item, or an invalid QSize if no size hint has been set.
If no size hint has been set, the item delegate will compute the size hint based on the item data.
另請參閱 setSizeHint ().
排序項的子級使用給定 order ，通過值在給定 column .
注意： This function is recursive, therefore it sorts the children of the item, its grandchildren, etc.
另請參閱 operator< ().
Returns the item's status tip.
另請參閱 setStatusTip (), toolTip ()，和 whatsThis ().
Removes the child item at (
row
,
column
) without deleting it, and returns a pointer to the item. If there was no child at the given location, then this function returns
nullptr
.
Note that this function, unlike takeRow () 和 takeColumn (), does not affect the dimensions of the child table.
另請參閱 child (), takeRow ()，和 takeColumn ().
移除 column 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.
另請參閱 removeColumn (), insertColumn ()，和 takeRow ().
移除 row 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.
另請參閱 removeRow (), insertRow ()，和 takeColumn ().
Returns the item's text. This is the text that's presented to the user in a view.
另請參閱 setText ().
Returns the text alignment for the item's text.
另請參閱 setTextAlignment ().
Returns the item's tooltip.
另請參閱 setToolTip (), statusTip ()，和 whatsThis ().
[虛擬]
int
QStandardItem::
type
() const
Returns the type of this item. The type is used to distinguish custom items from the base class. When subclassing QStandardItem , you should reimplement this function and return a new value greater than or equal to UserType .
另請參閱 QStandardItem::Type .
Returns the item's "What's This?" help.
另請參閱 setWhatsThis (), toolTip ()，和 statusTip ().
[虛擬]
void
QStandardItem::
write
(
QDataStream
&
out
) const
把項寫入流 out . Only the data and flags of the item are written, not the child items.
另請參閱 read ().
[虛擬]
bool
QStandardItem::
operator<
(const
QStandardItem
&
other
) const
返迴
true
if this item is less than
other
；否則返迴
false
.
The default implementation uses the data for the item's sort role (see QStandardItemModel::sortRole ) to perform the comparison if the item belongs to a model; otherwise, the data for the item's Qt::DisplayRole ( text ()) is used to perform the comparison.
sortChildren () 和 QStandardItemModel::sort () use this function when sorting items. If you want custom sorting, you can subclass QStandardItem and reimplement this function.
[protected]
QStandardItem
&QStandardItem::
operator=
(const
QStandardItem
&
other
)
賦值 other 的數據和標誌到此項。注意 type () 和 model () 不拷貝。
此函數是有用的，當重實現 clone ().
寫入 QStandardItem item 到流 out .
此操作符使用 QStandardItem::write ().
該函數在 Qt 4.2 引入。
另請參閱 序列化 Qt 數據類型 .
讀取 QStandardItem 從流 in into item .
此操作符使用 QStandardItem::read ().
該函數在 Qt 4.2 引入。
另請參閱 序列化 Qt 數據類型 .