（轉）Qt Model/View 學習筆記 (七)——Delegate類

Qt Model/View 學習筆記 (七)

Delegate  類

概念

與MVC模式不一樣，model/view結構沒有用於與用戶交互的徹底獨立的組件。通常來說， view負責把數據展現

給用戶，也處理用戶的輸入。爲了得到更多的靈性性，交互經過delegagte執行。它既提供輸入功能又負責渲染view中的每一個數據項。 控制delegates的標準接口在QAbstractItemDelegate類中定義。Delegates經過實現paint()和sizeHint()以達到渲染內容的目的。然而，簡單的基於widget的delegates,能夠從QItemDelegate子類化，而不是QAbstractItemDelegate,這樣可使用它提供的上述函數的缺省實現。delegate可使用widget來處理編輯過程，也能夠直接對事件進行處理。

使用現成的delegate

Qt提供的標準views都使用QItemDelegate的實例來提供編輯功能。它以普通的風格來爲每一個標準view渲染數據項。這些標準的views包括：QListView,QTableView,QTreeView。全部標準的角色都經過標準views包含的缺省delegate進行處理。一個view使用的delegate能夠用itemDelegate()函數取得,而setItemDelegate() 函數能夠安裝一個定製delegate。

一個簡單的delegate

這個delegate使用QSpinBox來提供編輯功能。它主要想用於顯示整數的models上。儘管咱們已經創建了一個基於整數的table model,但咱們也可使用QStandardItemModel，由於delegate能夠控制數據的錄入。咱們又建了一個table view來顯示model的內容，用咱們定製的delegate來編輯。

咱們從QItemDelegate子類化，這樣能夠利用它缺省實現的顯示功能。固然咱們必需提供函數來管理用於編輯的widget:

class SpinBoxDelegate : public QItemDelegate

 {

     Q_OBJECT

 public:

     SpinBoxDelegate(QObject *parent = 0);

     QWidget *createEditor(QWidget *parent, const QStyleOptionViewItem &option,

                           const QModelIndex &index) const;

     void setEditorData(QWidget *editor, const QModelIndex &index) const;

     void setModelData(QWidget *editor, QAbstractItemModel *model,

                       const QModelIndex &index) const;

     void updateEditorGeometry(QWidget *editor,

         const QStyleOptionViewItem &option, const QModelIndex &index) const;

 };

須要注意的是,當一個delegate建立時，不須要安裝一個widget，只有在真正須要時才建立這個用於編輯的widget。

提供編輯器

在這個例子中，當table view須要提供一個編輯器時，它要求delegate提供一個可用於編輯的widget,它應該適用於當前正被修改的數據項。這正是createEditor()函數應該實現的：

QWidget *SpinBoxDelegate::createEditor(QWidget *parent,

     const QStyleOptionViewItem &/* option */,

     const QModelIndex &/* index */) const

 {

     QSpinBox *editor = new QSpinBox(parent);

     editor->setMinimum(0);

     editor->setMaximum(100);

     return editor;

 }

咱們不須要跟蹤這個widget的指針，由於view會在不須要時銷燬這個widget。咱們也給編輯安裝了delegate缺省的事件過濾器，這提供了用戶指望的標準編輯快捷鍵。view經過咱們定義相應的函數來保證編輯器的數據與幾何佈局被正確的設置。咱們也能夠根據不一樣的model index來建立不一樣的編輯器，好比，咱們有一列整數，一列字符串，咱們能夠根據哪一種列被編輯來建立一個QSpinBox或是QLineEdit。delegate必需提供一個函數把model中的數據拷貝到編輯器中。

void SpinBoxDelegate::setEditorData(QWidget *editor,

                                     const QModelIndex &index) const

 {

     int value = index.model()->data(index, Qt::DisplayRole).toInt();

     QSpinBox *spinBox = static_cast<QSpinBox*>(editor);

     spinBox->setValue(value);

 }

向model提交數據

這須要咱們實現另一個函數setModelData():

void SpinBoxDelegate::setModelData(QWidget *editor, QAbstractItemModel *model,

                                    const QModelIndex &index) const

 {

     QSpinBox *spinBox = static_cast<QSpinBox*>(editor);

     spinBox->interpretText();

     int value = spinBox->value();

     model->setData(index, value);

 }

標準的QItemDelegate類當它完成編輯時會發射closeEditor()信號來通知view。view保證編輯器widget關閉與銷燬。本例中咱們只提供簡單的編輯功能，所以不須要發送個信號。

更新編輯器幾何佈局

delegate負責管理編輯器的幾何佈局。這些幾何佈局信息在編輯建立時或view的尺寸位置發生改變時，

都應當被提供。幸運的是，view經過一個view option能夠提供這些必要的信息。

 void SpinBoxDelegate::updateEditorGeometry(QWidget *editor,

     const QStyleOptionViewItem &option, const QModelIndex &/* index */) const

 {

     editor->setGeometry(option.rect);

 }

編輯提示

編輯完成後，delegate會給別的組件提供有關於編輯處理結果的提示，也提供用於後續編輯操做的一些提示。

這能夠經過發射帶有某種hint的closeEditor()信號完成。這些信號會被安裝在spin box上的缺省的QItemDelegate事件過濾器捕獲。對這個缺省的事件過濾來說，當用戶按下回車鍵，delegate會對model中的數據進行提交，並關閉spin box。

咱們能夠安裝本身的事件過濾器以迎合咱們的須要，例如，咱們能夠發射帶有EditNextItem hint的

closeEditor()信號來實現自動開始編輯view中的下一項。