QStandardItemModel Class Reference · PyQt4 中文文檔

# QStandardItemModel Class Reference ## [[QtGui](index.htm) module] 該QStandardItemModel類提供用于存儲自定義數據的通用模型。[More...](#details) 繼承[QAbstractItemModel](qabstractitemmodel.html)。 ### Methods * `__init__ (self, QObject?parent?=?None)` * `__init__ (self, int?rows, int?columns, QObject?parent?=?None)` * `appendColumn (self, list-of-QStandardItem?items)` * `appendRow (self, list-of-QStandardItem?items)` * `appendRow (self, QStandardItem?aitem)` * `clear (self)` * `int columnCount (self, QModelIndex?parent?=?QModelIndex())` * `QVariant data (self, QModelIndex?index, int?role?=?Qt.DisplayRole)` * `bool dropMimeData (self, QMimeData?data, Qt.DropAction?action, int?row, int?column, QModelIndex?parent)` * `list-of-QStandardItem findItems (self, QString?text, Qt.MatchFlags?flags?=?Qt.MatchExactly, int?column?=?0)` * `Qt.ItemFlags flags (self, QModelIndex?index)` * `bool hasChildren (self, QModelIndex?parent?=?QModelIndex())` * `QVariant headerData (self, int?section, Qt.Orientation?orientation, int?role?=?Qt.DisplayRole)` * `QStandardItem horizontalHeaderItem (self, int?column)` * `QModelIndex index (self, int?row, int?column, QModelIndex?parent?=?QModelIndex())` * `QModelIndex indexFromItem (self, QStandardItem?item)` * `insertColumn (self, int?column, list-of-QStandardItem?items)` * `bool insertColumn (self, int?column, QModelIndex?parent?=?QModelIndex())` * `bool insertColumns (self, int?column, int?count, QModelIndex?parent?=?QModelIndex())` * `insertRow (self, int?row, list-of-QStandardItem?items)` * `insertRow (self, int?arow, QStandardItem?aitem)` * `bool insertRow (self, int?row, QModelIndex?parent?=?QModelIndex())` * `bool insertRows (self, int?row, int?count, QModelIndex?parent?=?QModelIndex())` * `QStandardItem invisibleRootItem (self)` * `QStandardItem item (self, int?row, int?column?=?0)` * `dict-of-int-QVariant itemData (self, QModelIndex?index)` * `QStandardItem itemFromIndex (self, QModelIndex?index)` * `QStandardItem itemPrototype (self)` * `QMimeData mimeData (self, list-of-QModelIndex?indexes)` * `QStringList mimeTypes (self)` * `QModelIndex parent (self, QModelIndex?child)` * `QObject parent (self)` * `bool removeColumns (self, int?column, int?count, QModelIndex?parent?=?QModelIndex())` * `bool removeRows (self, int?row, int?count, QModelIndex?parent?=?QModelIndex())` * `int rowCount (self, QModelIndex?parent?=?QModelIndex())` * `setColumnCount (self, int?columns)` * `bool setData (self, QModelIndex?index, QVariant?value, int?role?=?Qt.EditRole)` * `bool setHeaderData (self, int?section, Qt.Orientation?orientation, QVariant?value, int?role?=?Qt.EditRole)` * `setHorizontalHeaderItem (self, int?column, QStandardItem?item)` * `setHorizontalHeaderLabels (self, QStringList?labels)` * `setItem (self, int?row, int?column, QStandardItem?item)` * `setItem (self, int?arow, QStandardItem?aitem)` * `bool setItemData (self, QModelIndex?index, dict-of-int-QVariant?roles)` * `setItemPrototype (self, QStandardItem?item)` * `setRowCount (self, int?rows)` * `setSortRole (self, int?role)` * `setVerticalHeaderItem (self, int?row, QStandardItem?item)` * `setVerticalHeaderLabels (self, QStringList?labels)` * `sort (self, int?column, Qt.SortOrder?order?=?Qt.AscendingOrder)` * `int sortRole (self)` * `Qt.DropActions supportedDropActions (self)` * `list-of-QStandardItem takeColumn (self, int?column)` * `QStandardItem takeHorizontalHeaderItem (self, int?column)` * `QStandardItem takeItem (self, int?row, int?column?=?0)` * `list-of-QStandardItem takeRow (self, int?row)` * `QStandardItem takeVerticalHeaderItem (self, int?row)` * `QStandardItem verticalHeaderItem (self, int?row)` ### Qt Signals * `void itemChanged (QStandardItem *)` * * * ## Detailed Description 該QStandardItemModel類提供用于存儲自定義數據的通用模型。 QStandardItemModel可以作為標準的Qt數據類型的存儲庫。它是一[Model/View Classes](index.htm)并且是Qt的一部分[model/view](index.htm)框架。 QStandardItemModel提供了一個典型的項目為基礎的方法與模型的工作。在QStandardItemModel的項目是由提供[QStandardItem](qstandarditem.html)。 QStandardItemModel實現[QAbstractItemModel](qabstractitemmodel.html)接口，這意味著，該模型可以用來提供數據支持該接口（如任何視圖[QListView](qlistview.html)，[QTableView](qtableview.html)和[QTreeView](qtreeview.html)，和你自己的自定義視圖）。對于性能和靈活性，你可能要繼承[QAbstractItemModel](qabstractitemmodel.html)提供不同類型的數據存儲庫的支持。例如，本[QDirModel(obsolete)](qdirmodel.html)提供了一個模型界面到底層的文件系統。當你想要一個列表或樹，你可以創建一個空的QStandardItemModel和使用[appendRow](qstandarditemmodel.html#appendRow)（）將項目添加到模型中，并[item](qstandarditemmodel.html#item)（）來存取項目。如果你的模型是一個表，通常需要傳遞的表的尺寸的QStandardItemModel的構造和使用[setItem](qstandarditemmodel.html#setItem)（）來定位的項目到表中。您也可以使用[setRowCount](qstandarditemmodel.html#setRowCount)（）和[setColumnCount](qstandarditemmodel.html#setColumnCount)（）來改變模型的尺寸。要插入的項目，使用[insertRow](qstandarditemmodel.html#insertRow)（）或[insertColumn](qstandarditemmodel.html#insertColumn)（），并刪除項目，使用[removeRow](qabstractitemmodel.html#removeRow)（）或[removeColumn](qabstractitemmodel.html#removeColumn)（）。你可以設置你的模型的標題與標籤[setHorizontalHeaderLabels](qstandarditemmodel.html#setHorizontalHeaderLabels)（）和[setVerticalHeaderLabels](qstandarditemmodel.html#setVerticalHeaderLabels)（）。您可以在模型中的項目與搜索[findItems](qstandarditemmodel.html#findItems)（），并且模型通過調用排序[sort](qstandarditemmodel.html#sort)（）。 Call [clear](qstandarditemmodel.html#clear)（）從模型中刪除所有項目。 QStandardItemModel的使用示例創建一個表： ``` QStandardItemModel model(4, 4); for (int row = 0; row < 4; ++row) { for (int column = 0; column < 4; ++column) { [QStandardItem](qstandarditem.html) *item = new [QStandardItem](qstandarditem.html)([QString](qstring.html)("row %0, column %1").arg(row).arg(column)); model.setItem(row, column, item); } } ``` QStandardItemModel的使用示例創建樹： ``` QStandardItemModel model; [QStandardItem](qstandarditem.html) *parentItem = model.invisibleRootItem(); for (int i = 0; i < 4; ++i) { [QStandardItem](qstandarditem.html) *item = new [QStandardItem](qstandarditem.html)([QString](qstring.html)("item %0").arg(i)); parentItem->appendRow(item); parentItem = item; } ``` 設置模型的視圖后，你通常需要響應用戶操作，如被點擊的項目。由于[QAbstractItemView](qabstractitemview.html)提供[QModelIndex](qmodelindex.html)為基礎的信號和功能，你需要一種方法來獲得[QStandardItem](qstandarditem.html)對應于一個給定的[QModelIndex](qmodelindex.html)，反之亦然。[itemFromIndex](qstandarditemmodel.html#itemFromIndex)（）和[indexFromItem](qstandarditemmodel.html#indexFromItem)（）提供這種映射。典型的用法[itemFromIndex](qstandarditemmodel.html#itemFromIndex)（）包括：獲取該項目的當前索引處的一個視圖，并獲得對應于由一個執行一個索引的資料[QAbstractItemView](qabstractitemview.html)信號，如[QAbstractItemView.clicked](qabstractitemview.html#clicked)（）。首先，你的觀點的信號連接到您的班級插槽： ``` [QTreeView](qtreeview.html) *treeView = new [QTreeView](qtreeview.html)(this); treeView->setModel(myStandardItemModel); connect(treeView, SIGNAL(clicked([QModelIndex](qmodelindex.html))), this, SLOT(clicked([QModelIndex](qmodelindex.html)))); ``` 當您收到信號，你叫[itemFromIndex](qstandarditemmodel.html#itemFromIndex)（）在給定的模型索引來獲得一個指向文件： ``` void MyWidget.clicked(const [QModelIndex](qmodelindex.html) &index) { [QStandardItem](qstandarditem.html) *item = myStandardItemModel->itemFromIndex(index); // Do stuff with the item ... } ``` 相反，你必須獲得[QModelIndex](qmodelindex.html)當你要調用一個模型/視圖函數，它接受一個索引作為參數的項目。您可以使用該模型的兩種獲取索引[indexFromItem](qstandarditemmodel.html#indexFromItem)（）函數，或等價地，通過調用[QStandardItem.index](qstandarditem.html#index)（）： ``` treeView->scrollTo(item->index()); ``` 你當然不需要使用的項目為基礎的方法，你可以代替完全依賴[QAbstractItemModel](qabstractitemmodel.html)接口與模型的工作，或者在兩者的組合中適當的時候。 * * * ## Method Documentation ``` QStandardItemModel.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個新的項目模型，給定_parent_。 ``` QStandardItemModel.__init__ (self, int?rows, int?columns, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個新的項目模型，最初有_rows_行和_columns_列，并且具有給定_parent_。 ``` QStandardItemModel.appendColumn (self, list-of-QStandardItem?items) ``` 該_items_說法有它的所有權轉移給Qt的。含追加一列_items_。如果有必要，該行數將增加至大小_items_。這個函數中引入了Qt 4.2中。 **See also** [insertColumn](qstandarditemmodel.html#insertColumn)（）和[appendRow](qstandarditemmodel.html#appendRow)（）。 ``` QStandardItemModel.appendRow (self, list-of-QStandardItem?items) ``` 該_items_說法有它的所有權轉移給Qt的。含追加的行_items_。如果需要的話，列計數值增加到的大小_items_。這個函數中引入了Qt 4.2中。 **See also** [insertRow](qstandarditemmodel.html#insertRow)（）和[appendColumn](qstandarditemmodel.html#appendColumn)（）。 ``` QStandardItemModel.appendRow (self, QStandardItem?aitem) ``` 該_aitem_說法有它的所有權轉移給Qt的。這是一個重載函數。當建立一個列表，或者只有一列樹，該功能提供了一種方便的方式來追加一個新_item_。這個函數中引入了Qt 4.2中。 ``` QStandardItemModel.clear (self) ``` 從模型中刪除所有項目（包括頭項），并設置行數和列數為零。 **See also** [removeColumns](qstandarditemmodel.html#removeColumns)（）和[removeRows](qstandarditemmodel.html#removeRows)（）。 ``` int QStandardItemModel.columnCount (self, QModelIndex?parent?=?QModelIndex()) ``` 從重新實現[QAbstractItemModel.columnCount](qabstractitemmodel.html#columnCount)（）。 **See also** [setColumnCount](qstandarditemmodel.html#setColumnCount)（）。 ``` QVariant QStandardItemModel.data (self, QModelIndex?index, int?role?=?Qt.DisplayRole) ``` 從重新實現[QAbstractItemModel.data](qabstractitemmodel.html#data)（）。 **See also** [setData](qstandarditemmodel.html#setData)（）。 ``` bool QStandardItemModel.dropMimeData (self, QMimeData?data, Qt.DropAction?action, int?row, int?column, QModelIndex?parent) ``` 從重新實現[QAbstractItemModel.dropMimeData](qabstractitemmodel.html#dropMimeData)（）。 ``` list-of-QStandardItem QStandardItemModel.findItems (self, QString?text, Qt.MatchFlags?flags?=?Qt.MatchExactly, int?column?=?0) ``` 返回匹配給定的項目清單_text_，使用給定的_flags_在給定的_column_。這個函數中引入了Qt 4.2中。 ``` Qt.ItemFlags QStandardItemModel.flags (self, QModelIndex?index) ``` [](index.htm) [從重新實現](index.htm)[QAbstractItemModel.flags](qabstractitemmodel.html#flags)（）。 ``` bool QStandardItemModel.hasChildren (self, QModelIndex?parent?=?QModelIndex()) ``` 從重新實現[QAbstractItemModel.hasChildren](qabstractitemmodel.html#hasChildren)（）。 ``` QVariant QStandardItemModel.headerData (self, int?section, Qt.Orientation?orientation, int?role?=?Qt.DisplayRole) ``` 從重新實現[QAbstractItemModel.headerData](qabstractitemmodel.html#headerData)（）。 **See also** [setHeaderData](qstandarditemmodel.html#setHeaderData)（）。 ``` QStandardItem QStandardItemModel.horizontalHeaderItem (self, int?column) ``` [ 返回水平標題項為_column_如果已經設置，否則返回0 。這個函數中引入了Qt 4.2中。 ](qstandarditem.html) [**See also**](qstandarditem.html) [setHorizontalHeaderItem](qstandarditemmodel.html#setHorizontalHeaderItem)（）和[verticalHeaderItem](qstandarditemmodel.html#verticalHeaderItem)（）。 ``` QModelIndex QStandardItemModel.index (self, int?row, int?column, QModelIndex?parent?=?QModelIndex()) ``` [](qmodelindex.html) [從重新實現](qmodelindex.html)[QAbstractItemModel.index](qabstractitemmodel.html#index)（）。 ``` QModelIndex QStandardItemModel.indexFromItem (self, QStandardItem?item) ``` [](qmodelindex.html) [返回](qmodelindex.html)[QModelIndex](qmodelindex.html)用給定的相關聯_item_。當您要執行需要的操作使用此功能[QModelIndex](qmodelindex.html)該項目時，如[QAbstractItemView.scrollTo](qabstractitemview.html#scrollTo)（）。[QStandardItem.index](qstandarditem.html#index)（）是作為方便，它等效于調用這個函數。這個函數中引入了Qt 4.2中。 **See also** [itemFromIndex](qstandarditemmodel.html#itemFromIndex)（）和[QStandardItem.index](qstandarditem.html#index)（）。 ``` QStandardItemModel.insertColumn (self, int?column, list-of-QStandardItem?items) ``` 該_items_說法有它的所有權轉移給Qt的。在插入一列_column_ containing _items_。如果有必要，該行數將增加至大小_items_。這個函數中引入了Qt 4.2中。 **See also** [takeColumn](qstandarditemmodel.html#takeColumn)（）[appendColumn](qstandarditemmodel.html#appendColumn)（）和[insertRow](qstandarditemmodel.html#insertRow)（）。 ``` bool QStandardItemModel.insertColumn (self, int?column, QModelIndex?parent?=?QModelIndex()) ``` 給定前插入一列_column_中的子項_parent_規定。返回True如果插入的列，否則返回False 。 **See also** [insertColumns](qstandarditemmodel.html#insertColumns)（）[insertRow](qstandarditemmodel.html#insertRow)（）和[removeColumn](qabstractitemmodel.html#removeColumn)（）。 ``` bool QStandardItemModel.insertColumns (self, int?column, int?count, QModelIndex?parent?=?QModelIndex()) ``` 從重新實現[QAbstractItemModel.insertColumns](qabstractitemmodel.html#insertColumns)（）。 ``` QStandardItemModel.insertRow (self, int?row, list-of-QStandardItem?items) ``` 該_items_說法有它的所有權轉移給Qt的。插入一個一行_row_ containing _items_。如果需要的話，列計數值增加到的大小_items_。這個函數中引入了Qt 4.2中。 **See also** [takeRow](qstandarditemmodel.html#takeRow)（）[appendRow](qstandarditemmodel.html#appendRow)（）和[insertColumn](qstandarditemmodel.html#insertColumn)（）。 ``` QStandardItemModel.insertRow (self, int?arow, QStandardItem?aitem) ``` 該_aitem_說法有它的所有權轉移給Qt的。給定前插入一個單行_row_中的子項_parent_規定。返回True如果被插入的行，否則返回False 。 **See also** [insertRows](qstandarditemmodel.html#insertRows)（）[insertColumn](qstandarditemmodel.html#insertColumn)（）和[removeRow](qabstractitemmodel.html#removeRow)（）。 ``` bool QStandardItemModel.insertRow (self, int?row, QModelIndex?parent?=?QModelIndex()) ``` 這是一個重載函數。插入一個一行_row_ containing _item_。當建立一個列表，或者只有一列樹，該功能提供了一種方便的方式來追加新的單一項目。這個函數中引入了Qt 4.2中。 ``` bool QStandardItemModel.insertRows (self, int?row, int?count, QModelIndex?parent?=?QModelIndex()) ``` 從重新實現[QAbstractItemModel.insertRows](qabstractitemmodel.html#insertRows)（）。 ``` QStandardItem QStandardItemModel.invisibleRootItem (self) ``` [ 返回模型的無形之根項目。 ](qstandarditem.html) [看不見的根項目，通過提供對模型的頂層項目](qstandarditem.html)[QStandardItem](qstandarditem.html)的API ，從而可以寫，可以治療以統一的方式頂級項目及其子女的功能，例如，涉及樹模型遞歸函數。 **Note:**調用[index()](qabstractitemmodel.html#index)在[QStandardItem](qstandarditem.html)從這個功能檢索的對象是無效的。這個函數中引入了Qt 4.2中。 ``` QStandardItem QStandardItemModel.item (self, int?row, int?column?=?0) ``` [ 返回的項目為給定的_row_和_column_如果已經設置，否則返回0 。這個函數中引入了Qt 4.2中。 ](qstandarditem.html) [**See also**](qstandarditem.html) [setItem](qstandarditemmodel.html#setItem)（）[takeItem](qstandarditemmodel.html#takeItem)（）和[itemFromIndex](qstandarditemmodel.html#itemFromIndex)（）。 ``` dict-of-int-QVariant QStandardItemModel.itemData (self, QModelIndex?index) ``` 從重新實現[QAbstractItemModel.itemData](qabstractitemmodel.html#itemData)（）。 **See also** [setItemData](qstandarditemmodel.html#setItemData)（）。 ``` QStandardItem QStandardItemModel.itemFromIndex (self, QModelIndex?index) ``` [](qstandarditem.html) [返回一個指針](qstandarditem.html)[QStandardItem](qstandarditem.html)用給定的相關聯_index_。調用此函數通常是最初的一步處理時，[QModelIndex](qmodelindex.html)從一個基于視圖的信號，如[QAbstractItemView.activated](qabstractitemview.html#activated)（）。在您的插槽，你叫itemFromIndex （），與[QModelIndex](qmodelindex.html)由信號作為參數進行，得到一個指向相應[QStandardItem](qstandarditem.html)。注意，這個函數會懶洋洋地創建索引項（使用[itemPrototype](qstandarditemmodel.html#itemPrototype)（）），并將其設置在父項的子表，如果沒有項目已經存在該索引。 If _index_是一個無效的指標，這個函數返回0 。這個函數中引入了Qt 4.2中。 **See also** [indexFromItem](qstandarditemmodel.html#indexFromItem)（）。 ``` QStandardItem QStandardItemModel.itemPrototype (self) ``` [](qstandarditem.html) [返回產品原型所使用的模型。該模型使用的項目原型作為項目的工廠時，它需要構建隨需應變的新項目（例如，當一個視圖或項目委讬調用](qstandarditem.html)[setData](qstandarditemmodel.html#setData)（））。這個函數中引入了Qt 4.2中。 **See also** [setItemPrototype](qstandarditemmodel.html#setItemPrototype)（）。 ``` QMimeData QStandardItemModel.mimeData (self, list-of-QModelIndex?indexes) ``` [ 該_QMimeData_結果 ](qmimedata.html) [從重新實現](qmimedata.html)[QAbstractItemModel.mimeData](qabstractitemmodel.html#mimeData)（）。 ``` QStringList QStandardItemModel.mimeTypes (self) ``` 從重新實現[QAbstractItemModel.mimeTypes](qabstractitemmodel.html#mimeTypes)（）。 ``` QModelIndex QStandardItemModel.parent (self, QModelIndex?child) ``` [](qmodelindex.html) [從重新實現](qmodelindex.html)[QAbstractItemModel.parent](qabstractitemmodel.html#parent)（）。 ``` QObject QStandardItemModel.parent (self) ``` [ ``` bool QStandardItemModel.removeColumns (self, int?column, int?count, QModelIndex?parent?=?QModelIndex()) ``` ](qobject.html) [從重新實現](qobject.html)[QAbstractItemModel.removeColumns](qabstractitemmodel.html#removeColumns)（）。 ``` bool QStandardItemModel.removeRows (self, int?row, int?count, QModelIndex?parent?=?QModelIndex()) ``` 從重新實現[QAbstractItemModel.removeRows](qabstractitemmodel.html#removeRows)（）。 ``` int QStandardItemModel.rowCount (self, QModelIndex?parent?=?QModelIndex()) ``` 從重新實現[QAbstractItemModel.rowCount](qabstractitemmodel.html#rowCount)（）。 **See also** [setRowCount](qstandarditemmodel.html#setRowCount)（）。 ``` QStandardItemModel.setColumnCount (self, int?columns) ``` 載列在這個模型數_columns_。如果它小于[columnCount](qstandarditemmodel.html#columnCount)（），在不需要的列中的數據將被丟棄。這個函數中引入了Qt 4.2中。 **See also** [columnCount](qstandarditemmodel.html#columnCount)（）和[setRowCount](qstandarditemmodel.html#setRowCount)（）。 ``` bool QStandardItemModel.setData (self, QModelIndex?index, QVariant?value, int?role?=?Qt.EditRole) ``` 從重新實現[QAbstractItemModel.setData](qabstractitemmodel.html#setData)（）。 **See also** [data](qstandarditemmodel.html#data)（）。 ``` bool QStandardItemModel.setHeaderData (self, int?section, Qt.Orientation?orientation, QVariant?value, int?role?=?Qt.EditRole) ``` 從重新實現[QAbstractItemModel.setHeaderData](qabstractitemmodel.html#setHeaderData)（）。 **See also** [headerData](qstandarditemmodel.html#headerData)（）。 ``` QStandardItemModel.setHorizontalHeaderItem (self, int?column, QStandardItem?item) ``` 該_item_說法有它的所有權轉移給Qt的。設置水平標題項為_column_至_item_。該模型考慮了項目的所有權。如果需要的話，列計數增加，以適應產品。以前的標題項（如果有的話）將被刪除。這個函數中引入了Qt 4.2中。 **See also** [horizontalHeaderItem](qstandarditemmodel.html#horizontalHeaderItem)（）[setHorizontalHeaderLabels](qstandarditemmodel.html#setHorizontalHeaderLabels)（）和[setVerticalHeaderItem](qstandarditemmodel.html#setVerticalHeaderItem)（）。 ``` QStandardItemModel.setHorizontalHeaderLabels (self, QStringList?labels) ``` 設置使用水平標題標籤_labels_。如果需要的話，列計數值增加到的大小_labels_。這個函數中引入了Qt 4.2中。 **See also** [setHorizontalHeaderItem](qstandarditemmodel.html#setHorizontalHeaderItem)（）。 ``` QStandardItemModel.setItem (self, int?row, int?column, QStandardItem?item) ``` 該_item_說法有它的所有權轉移給Qt的。設置項對于給定的_row_和_column_至_item_。該模型考慮了項目的所有權。如果必要，行數和列數都增加，以適應產品。在給定位置（如果有的話）上一個項目被刪除。這個函數中引入了Qt 4.2中。 **See also** [item](qstandarditemmodel.html#item)（）。 ``` QStandardItemModel.setItem (self, int?arow, QStandardItem?aitem) ``` 該_aitem_說法有它的所有權轉移給Qt的。這是一個重載函數。 ``` bool QStandardItemModel.setItemData (self, QModelIndex?index, dict-of-int-QVariant?roles) ``` 從重新實現[QAbstractItemModel.setItemData](qabstractitemmodel.html#setItemData)（）。 **See also** [itemData](qstandarditemmodel.html#itemData)（）。 ``` QStandardItemModel.setItemPrototype (self, QStandardItem?item) ``` 該_item_說法有它的所有權轉移給Qt的。設置項的原型模型的指定的_item_。該模型采用原型的所有權。該項目的原型作為一個[QStandardItem](qstandarditem.html)工廠，所依托的[QStandardItem.clone](qstandarditem.html#clone)（）函數。提供自己的原型，子類[QStandardItem](qstandarditem.html)，重新實現[QStandardItem.clone](qstandarditem.html#clone)（）和set原型是您的自定義類的實例。每當[QStandardItemModel](qstandarditemmodel.html)需要按需創建一個項目（例如，視圖或項目委讬呼叫時[setData](qstandarditemmodel.html#setData)（））），該新項目將是你的自定義類的實例。這個函數中引入了Qt 4.2中。 **See also** [itemPrototype](qstandarditemmodel.html#itemPrototype)（）和[QStandardItem.clone](qstandarditem.html#clone)（）。 ``` QStandardItemModel.setRowCount (self, int?rows) ``` 設定排在這個模型數_rows_。如果它小于[rowCount](qstandarditemmodel.html#rowCount)（），在不需要的行中的數據將被丟棄。這個函數中引入了Qt 4.2中。 **See also** [rowCount](qstandarditemmodel.html#rowCount)（）和[setColumnCount](qstandarditemmodel.html#setColumnCount)（）。 ``` QStandardItemModel.setSortRole (self, int?role) ``` ``` QStandardItemModel.setVerticalHeaderItem (self, int?row, QStandardItem?item) ``` 該_item_說法有它的所有權轉移給Qt的。設置垂直標題項為_row_至_item_。該模型考慮了項目的所有權。如果必要，行計數增加，以適應產品。以前的標題項（如果有的話）將被刪除。這個函數中引入了Qt 4.2中。 **See also** [verticalHeaderItem](qstandarditemmodel.html#verticalHeaderItem)（）[setVerticalHeaderLabels](qstandarditemmodel.html#setVerticalHeaderLabels)（）和[setHorizontalHeaderItem](qstandarditemmodel.html#setHorizontalHeaderItem)（）。 ``` QStandardItemModel.setVerticalHeaderLabels (self, QStringList?labels) ``` 設置使用垂直標題標籤_labels_。如果有必要，該行數將增加至大小_labels_。這個函數中引入了Qt 4.2中。 **See also** [setVerticalHeaderItem](qstandarditemmodel.html#setVerticalHeaderItem)（）。 ``` QStandardItemModel.sort (self, int?column, Qt.SortOrder?order?=?Qt.AscendingOrder) ``` 從重新實現[QAbstractItemModel.sort](qabstractitemmodel.html#sort)（）。 ``` int QStandardItemModel.sortRole (self) ``` ``` Qt.DropActions QStandardItemModel.supportedDropActions (self) ``` [](index.htm) [從重新實現](index.htm)[QAbstractItemModel.supportedDropActions](qabstractitemmodel.html#supportedDropActions)（）。 [QStandardItemModel](qstandarditemmodel.html)支持復制和移動兩種。 ``` list-of-QStandardItem QStandardItemModel.takeColumn (self, int?column) ``` 該_list-of-QStandardItem_結果刪除給定的_column_不刪除的列項，并返回指針列表的刪除的項。該模型釋放的物品的所有權。在尚未設定的列項，列表中的相應指針將是0 。這個函數中引入了Qt 4.2中。 **See also** [takeRow](qstandarditemmodel.html#takeRow)（）。 ``` QStandardItem QStandardItemModel.takeHorizontalHeaderItem (self, int?column) ``` [ 該_QStandardItem_結果刪除在水平標題項_column_從標題而不刪除它，并返回一個指向的項目。該模型發布該項目的所有權。這個函數中引入了Qt 4.2中。 ](qstandarditem.html) [**See also**](qstandarditem.html) [horizontalHeaderItem](qstandarditemmodel.html#horizontalHeaderItem)（）和[takeVerticalHeaderItem](qstandarditemmodel.html#takeVerticalHeaderItem)（）。 ``` QStandardItem QStandardItemModel.takeItem (self, int?row, int?column?=?0) ``` [ 該_QStandardItem_結果刪除的項目（_row_，_column_）而不刪除它。該模型發布該項目的所有權。這個函數中引入了Qt 4.2中。 ](qstandarditem.html) [**See also**](qstandarditem.html) [item](qstandarditemmodel.html#item)（）[takeRow](qstandarditemmodel.html#takeRow)（）和[takeColumn](qstandarditemmodel.html#takeColumn)（）。 ``` list-of-QStandardItem QStandardItemModel.takeRow (self, int?row) ``` 該_list-of-QStandardItem_結果刪除給定的_row_不刪除的行項目，并返回指針列表的刪除的項目。該模型釋放的物品的所有權。對于沒有被設置的行中的項目，列表中的相應指針將是0 。這個函數中引入了Qt 4.2中。 **See also** [takeColumn](qstandarditemmodel.html#takeColumn)（）。 ``` QStandardItem QStandardItemModel.takeVerticalHeaderItem (self, int?row) ``` [ 該_QStandardItem_結果刪除在垂直標題項_row_從標題而不刪除它，并返回一個指向的項目。該模型發布該項目的所有權。這個函數中引入了Qt 4.2中。 ](qstandarditem.html) [**See also**](qstandarditem.html) [verticalHeaderItem](qstandarditemmodel.html#verticalHeaderItem)（）和[takeHorizontalHeaderItem](qstandarditemmodel.html#takeHorizontalHeaderItem)（）。 ``` QStandardItem QStandardItemModel.verticalHeaderItem (self, int?row) ``` [ 返回行的垂直標題項_row_如果已經設置，否則返回0 。這個函數中引入了Qt 4.2中。 ](qstandarditem.html) [**See also**](qstandarditem.html) [setVerticalHeaderItem](qstandarditemmodel.html#setVerticalHeaderItem)（）和[horizontalHeaderItem](qstandarditemmodel.html#horizontalHeaderItem)（）。 * * * ## Qt Signal Documentation ``` void itemChanged (QStandardItem *) ``` 這是該信號的默認超載。這個信號被發射時的數據_item_已經改變。這個函數中引入了Qt 4.2中。