清源游民 gameogre@gmail.com

Delegate  類

概念

與MVC模式不同，model/view結構沒有用于與用戶交互的完全獨立的組件。一般來講， view負責把數(shù)據(jù)展示
給用戶，也處理用戶的輸入。為了獲得更多的靈性性，交互通過delegagte執(zhí)行。它既提供輸入功能又負責渲染view中的每個數(shù)據(jù)項。 控制delegates的標準接口在QAbstractItemDelegate類中定義。Delegates通過實現(xiàn)paint()和sizeHint()以達到渲染內容的目的。然而，簡單的基于widget的delegates,可以從QItemDelegate子類化，而不是QAbstractItemDelegate,這樣可以使用它提供的上述函數(shù)的缺省實現(xiàn)。delegate可以使用widget來處理編輯過程，也可以直接對事件進行處理。

使用現(xiàn)成的delegate
Qt提供的標準views都使用QItemDelegate的實例來提供編輯功能。它以普通的風格來為每個標準view渲染數(shù)據(jù)項。這些標準的views包括：QListView,QTableView,QTreeView。所有標準的角色都通過標準views包含的缺省delegate進行處理。一個view使用的delegate可以用itemDelegate()函數(shù)取得,而setItemDelegate() 函數(shù)可以安裝一個定制delegate。

一個簡單的delegate
這個delegate使用QSpinBox來提供編輯功能。它主要想用于顯示整數(shù)的models上。盡管我們已經(jīng)建立了一個基于整數(shù)的table model,但我們也可以使用QStandardItemModel，因為delegate可以控制數(shù)據(jù)的錄入。我們又建了一個table view來顯示model的內容，用我們定制的delegate來編輯。

我們從QItemDelegate子類化，這樣可以利用它缺省實現(xiàn)的顯示功能。當然我們必需提供函數(shù)來管理用于編輯的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創(chuàng)建時，不需要安裝一個widget，只有在真正需要時才創(chuàng)建這個用于編輯的widget。

提供編輯器
在這個例子中，當table view需要提供一個編輯器時，它要求delegate提供一個可用于編輯的widget,它應該適用于當前正被修改的數(shù)據(jù)項。這正是createEditor()函數(shù)應該實現(xiàn)的：
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通過我們定義相應的函數(shù)來保證編輯器的數(shù)據(jù)與幾何布局被正確的設置。我們也可以根據(jù)不同的model index來創(chuàng)建不同的編輯器，比如，我們有一列整數(shù)，一列字符串，我們可以根據(jù)哪種列被編輯來創(chuàng)建一個QSpinBox或是QLineEdit。delegate必需提供一個函數(shù)把model中的數(shù)據(jù)拷貝到編輯器中。
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提交數(shù)據(jù)
這需要我們實現(xiàn)另外一個函數(shù)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類當它完成編輯時會發(fā)射closeEditor()信號來通知view。view保證編輯器widget關閉與銷毀。本例中我們只提供簡單的編輯功能，因此不需要發(fā)送個信號。

更新編輯器幾何布局

delegate負責管理編輯器的幾何布局。這些幾何布局信息在編輯創(chuàng)建時或view的尺寸位置發(fā)生改變時，
都應當被提供。幸運的是，view通過一個view option可以提供這些必要的信息。
 void SpinBoxDelegate::updateEditorGeometry(QWidget *editor,
     const QStyleOptionViewItem &option, const QModelIndex &/* index */) const
 {
     editor->setGeometry(option.rect);
 }

編輯提示
編輯完成后，delegate會給別的組件提供有關于編輯處理結果的提示，也提供用于后續(xù)編輯操作的一些提示。
這可以通過發(fā)射帶有某種hint的closeEditor()信號完成。這些信號會被安裝在spin box上的缺省的QItemDelegate事件過濾器捕獲。對這個缺省的事件過濾來講，當用戶按下回車鍵，delegate會對model中的數(shù)據(jù)進行提交，并關閉spin box。
我們可以安裝自己的事件過濾器以迎合我們的需要，例如，我們可以發(fā)射帶有EditNextItem hint的
closeEditor()信號來實現(xiàn)自動開始編輯view中的下一項。