就業培訓     下載中心     Wiki     聯絡
登錄   注冊
  1. 首頁
  2. Qt 6.5.1
  3. Qt Core
  4. C++ 類
  5. QModelIndex

QModelIndex 類

QModelIndex 類用於在數據模型中定位數據。 更多...

頭： #include <QModelIndex>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

公共函數

QModelIndex ()
int column () const
const void * constInternalPointer () const
QVariant data (int role = Qt::DisplayRole) const
Qt::ItemFlags flags () const
quintptr internalId () const
void * internalPointer () const
bool isValid () const
const QAbstractItemModel * model () const
void multiData (QModelRoleDataSpan roleDataSpan ) const
QModelIndex parent () const
int row () const
QModelIndex sibling (int row , int column ) const
QModelIndex siblingAtColumn (int column ) const
QModelIndex siblingAtRow (int row ) const
bool operator!= (const QModelIndex & other ) const
bool operator< (const QModelIndex & other ) const
bool operator== (const QModelIndex & other ) const
QModelIndexList

詳細描述

此類用作項模型的索引，派生自 QAbstractItemModel 。用於項視圖、委托及選定模型的索引，能定位模型項。

通過模型創建新 QModelIndex 對象是使用 QAbstractItemModel::createIndex () 函數。 無效 模型索引的構造可以采用 QModelIndex 構造函數。無效索引經常用作父級索引，當引用模型中的頂級項時。

模型索引引用模型中的項，且包含指定它們在這些模型中位置要求的所有信息。各索引位於給定行和列，且可能擁有父級索引；使用 row (), column ()，和 parent () 能獲得這種信息。模型中的各頂級項都是由不擁有父級索引的模型索引所錶示的 - 在此情況下， parent () 將返迴無效模型索引，相當於采用 QModelIndex() 構造函數的 0 自變量形式構造索引。

要獲得引用模型中現有項的模型索引，調用 QAbstractItemModel::index () 采用要求的行和列值，及父級的模型索引。當引用模型中的頂級項時，提供 QModelIndex() 作為父級索引。

The model () 函數返迴索引所引用的模型如 QAbstractItemModel 。child() 函數用於審查由模型索引所保持的項。 sibling () 函數允許在如索引的同一級彆遍曆模型項。

注意： 模型索引應立即使用，然後丟棄。不應依賴要保持有效的索引，在調用改變模型結構 (或刪除項) 的模型函數後。若需要隨時間推移保持模型索引，使用 QPersistentModelIndex .

另請參閱 模型/視圖編程 , QPersistentModelIndex ，和 QAbstractItemModel .

成員函數文檔編製

[constexpr] QModelIndex:: QModelIndex ()

創建新的空模型索引。這種類型的模型索引用於指示模型的位置無效。

另請參閱 isValid () 和 QAbstractItemModel .

[constexpr] int QModelIndex:: column () const

返迴此模型索引所引用的列。

const void *QModelIndex:: constInternalPointer () const

返迴 const void * 指針用於模型，以將索引關聯內部數據結構。

另請參閱 QAbstractItemModel::createIndex ().

QVariant QModelIndex:: data ( int role = Qt::DisplayRole) const

返迴數據為給定 role 對於項引用通過索引。

Qt::ItemFlags QModelIndex:: flags () const

返迴由索引所引用的項標誌。

[constexpr] quintptr QModelIndex:: internalId () const

返迴 quintptr 用於模型，以將索引關聯內部數據結構。

另請參閱 QAbstractItemModel::createIndex ().

void *QModelIndex:: internalPointer () const

返迴 void * 指針用於模型，以將索引關聯內部數據結構。

另請參閱 QAbstractItemModel::createIndex ().

[constexpr] bool QModelIndex:: isValid () const

返迴 true 若此模型索引有效；否則返迴 false .

有效索引屬於模型，且擁有非負行號和列號。

另請參閱 model (), row ()，和 column ().

[constexpr] const QAbstractItemModel *QModelIndex:: model () const

返迴包含此索引所引用項的模型指針。

返迴模型 const 指針，因為調用模型的非 const 函數會使模型索引無效，並可能會使應用程序崩潰。

[since 6.0] void QModelIndex:: multiData ( QModelRoleDataSpan roleDataSpan ) const

Populates the given roleDataSpan 對於項引用通過索引。

該函數在 Qt 6.0 引入。

QModelIndex QModelIndex:: parent () const

返迴模型索引的父級，或 QModelIndex () 若它沒有父級。

另請參閱 sibling () 和 model ().

[constexpr] int QModelIndex:: row () const

返迴此模型索引所引用的行。

QModelIndex QModelIndex:: sibling ( int row , int column ) const

返迴同級在 row and column 。若此位置沒有同級，無效 QModelIndex 被返迴。

另請參閱 parent (), siblingAtColumn ()，和 siblingAtRow ().

QModelIndex QModelIndex:: siblingAtColumn ( int column ) const

返迴同級在 column 對於當前行。若此位置沒有同級，無效 QModelIndex 被返迴。

另請參閱 sibling () 和 siblingAtRow ().

QModelIndex QModelIndex:: siblingAtRow ( int row ) const

返迴同級在 row 對於當前列。若此位置沒有同級，無效 QModelIndex 被返迴。

另請參閱 sibling () 和 siblingAtColumn ().

[constexpr] bool QModelIndex:: operator!= (const QModelIndex & other ) const

返迴 true 若此模型索引未引用同一位置如 other 模型索引；否則返迴 false .

[constexpr] bool QModelIndex:: operator< (const QModelIndex & other ) const

返迴 true 若此模型索引 < other 模型索引；否則返迴 false .

< 計算對開發者並非直接有用 - 沒有定義采用不同父級的索引比較方式。此運算符纔存在，以便類可以用於 QMap .

[constexpr] bool QModelIndex:: operator== (const QModelIndex & other ) const

返迴 true 若此模型索引引用同一位置如 other 模型索引；否則返迴 false .

使用內部數據指針、行、列及模型值，當比較另一模型索引時。

相關非成員

QModelIndexList

同義詞 QList < QModelIndex >.

內容

  1. 公共函數

  2. 相關非成員

  3. 詳細描述