清源游民 gameogre@gmail.com

Model類

基本概念
在model/view構架中，model為view和delegates使用數據提供了標準接口。在Qt中，標準接口QAbstractItemModel類中被定義。不管數據在底層以何種數據結構存儲，QAabstractItemModel的子類會以層次結構的形式來表示數據，結構中包含了數據項表。我們按這種約定來訪問model中的數據項，但這個約定不會對如何顯示這些數據有任何限制。數據發生改變時，model通過信號槽機制來通知關聯的views。

Model Indexes

為了使數據存儲與數據訪問分開，引入了model index的概念。通過model index，可以引用model中的數據項，Views和delegates都使用indexes來訪問數據項，然后再顯示出來。因此，只有model需要了解如何獲取數據，被model管理的數據類型可以非常廣泛地被定義。Model indexes包含一個指向創建它們的model的指針，這會在配合多個model工作時避免混亂。
QAbstractItemModel *model = index.model();

model indexes提供了對一項數據信息的臨時引用，通過它可以訪問或是修改model中的數據。既然model有時會重新組織內部的數據結構，這時model indexes便會失效，因此不應該保存臨時的model indexes。假如需要一個對數據信息的長期的引用，那么應該創建一個persistent model index。這個引用會保持更新。臨時的model indexes由QModelIndex提供，而具有持久能力的model indexes則由QPersistentModelIndex提供。在獲取對應一個數據項的model index時，需要考慮有關于model的三個屬性：行數，列數，父項的model index。

行與列
在最基本的形式中，一個model可作為一個簡單的表來訪問，每個數據項由行，列數來定位。這必不意味著
底層的數據用數組結構來存儲。行和列的使用僅僅是一種約定，它允許組件之間相互通訊。可以通過指定
model中的行列數來獲取任一項數據，可以得到與數據項一一對應的那個index。
QModelIndex index = model->index(row, column, ...);
Model為簡單的，單級的數據結構如list與tables提供了接口，它們如上面代碼所顯示的那樣，不再需要別的信息被提供。當我們在獲取一個model index時，我們需要提供另外的信息。

上圖代表一個基本的table model，它的每一項用一對行列數來定位。通過行列數，可以獲取代表一個數據項的model index .
QModelIndex indexA = model->index(0, 0, QModelIndex());
 QModelIndex indexB = model->index(1, 1, QModelIndex());
 QModelIndex indexC = model->index(2, 1, QModelIndex());
一個model的頂級項,由QModelIndex()取得，它們上式被用作父項。

父項
類似于表的接口在搭配使用table或list view時理想的，這種行列系統與view顯示的方式是確切匹配的。
然則，像tree views這種結構需要model提供更為靈活的接口來訪問數據項。每個數據項可能是別的項的
父項，上級的項可以獲取下級項的列表。
當獲取model中數據項的index時，我們必須指定關于數據項的父項的信息。在model外部，引用一個數據
項的唯一方法就是通過model index,因此需要在求取model index時指定父項的信息。
QModelIndex index = model->index(row, column, parent);

上圖中，A項和C項作為model中頂層的兄弟項：
 QModelIndex indexA = model->index(0, 0, QModelIndex());
 QModelIndex indexC = model->index(2, 1, QModelIndex());
A有許多孩子，它的一個孩子B用以下代碼獲取：
QModelIndex indexB = model->index(1, 0, indexA);

項角色
model中的項可以作為各種角色來使用，這允許為不同的環境提供不同的數據。舉例來說，Qt::DisplayRole被用于訪問一個字符串，它作為文本會在view中顯示。典型地，每個數據項都可以為許多不同的角色提供數據，標準的角色在Qt::ItemDataRole中定義。我們可以通過指定model index與角色來獲取我們需要的數據：
QVariant value = model->data(index, role);

角色指出了從model中引用哪種類型的數據。views可以用不同的形式顯示角色，因此為每個角色提供正確
的信息是非常重要的。通過為每個角色提供適當數據，model也為views和delegates提供了暗示，如何正確地
把這些數據項顯給用戶。不同的views可以自由地解析或忽略這些數據信息，對于特殊的場合，也可以定義
一些附加的角色。
概念總結：
1，Model indexes為views與delegages提供model中數據項定位的信息，它與底層的數據結構無關。
2，通過指定行，列數，父項的model index來引用數據項。
3,依照別的組件的要求，model indexes被model構建。
4，使用index()時，如果指定了有效的父項的model index,那么返回得到的model index對應于父項的某個孩子。
5，使用index()時，如果指定了無效的父項的model index,那么返回得到的model index對應于頂層項的某個孩子。
6, 角色對一個數據項包含的不同類型的數據給出了區分。

使用Model Indexes
QDirModel *model = new QDirModel;
     QModelIndex parentIndex = model->index(QDir::currentPath());
     int numRows = model->rowCount(parentIndex);
 for (int row = 0; row < numRows; ++row)
 {
         QModelIndex index = model->index(row, 0, parentIndex);
         tring text = model->data(index, Qt::DisplayRole).toString();
         // Display the text in a widget.

     }
以上的例子說明了從model中獲取數據的基本原則：
1，model的尺寸可以從rowCount()與columnCount()中得出。這些函數通常都需要一個表示父項的model index。
2，model indexes用來從model中訪問數據項，數據項用行，列，父項model index定位。
3, 為了訪問model頂層項，可以使用QModelIndex()指定。
4, 數據項為不同的角色提供不同的數據。為了獲取數據，除了model index之外，還要指定角色。