Qt--自定義Delegate

這是Model/View中的最后一篇了，Qt官方顯然弱化了Controller在MVC中的作用，提供了一個簡化版的Delegate；甚至在Model/View框架的使用中，提供了默認的委托，讓這個控制器愈加淡出開發者的實現。

實際上，Qt Model/View框架中的MVC概念是有誤的，顯而易見的就是Controller的作用，控制器應該只對交互進行控制，渲染方面的工作應該僅由View完成，但Delegate的接口中卻包含了這一塊。不過這都不是這篇文章的重點，我們只關注Delegate本身。

1. 實現一個自定義Delegate

這里我們也來實現一個自定義Delegate，懷着了解Delegate的目的，主要實現以下幾個功能：

1. 以不同顏色繪制View。
   

2. 雙擊View方格區域彈出行編輯器，默認覆蓋這個區域，顯示字母。
   

3. 輸入行編輯器內的內容會被保存，下次點開顯示。
   

4. 鼠標停留，顯示提示框。
   

2. 繼承QAbstractItemDelegate

Qt提供了幾個標准的委托：

1. QItemDelegate：Qt**曾經**默認使用的委托。
   

2. QStyledItemDelegate。：**現在**默認使用的委托，官方推薦我們使用這個。（自從Qt 4.4）
   

為了熟悉委托借口，我們繼承虛基類QAbstractItemDelegate來實現我們的自定義委托。

3. 實現虛函數

出去虛析構函數，QAbstractItemDelegate總共有9個虛函數，下面分別介紹。

paint()函數用來重繪view。我們這里選擇用隨機顏色填充背景：

void CustomeDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    if (!index.isValid() || option.state == QStyle::State_None || !index.isValid())
        return;

    painter->fillRect(option.rect, QColor(m_randomColor(m_generator)));
}

createEditor()和destroyEditor()的用途非常明顯，雙擊View的時候會彈出一個行編輯器：

QWidget* CustomeDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    return new QLineEdit(parent);
}

void CustomeDelegate::destroyEditor(QWidget *editor, const QModelIndex &index) const
{
    Q_ASSERT(dynamic_cast<QLineEdit*>(editor) != 0);

    delete dynamic_cast<QLineEdit*>(editor);
}

helpEvent()表示幫助事件，當發生QEvent::ToolTip或者QEvent::WhatsThis事件的時候，就會調用這個函數，我們這里根據事件不同顯示不同內容的Tool Tip：

bool CustomeDelegate::helpEvent(QHelpEvent *event, QAbstractItemView *view, const QStyleOptionViewItem &option, const QModelIndex &index)
{
    if (event->type() == QEvent::ToolTip) {
        QToolTip::showText(QCursor::pos(), QString("CustomeDelegate Tooltip"), reinterpret_cast<QWidget*>(view), option.rect, 1000);
    } else if (event->type() == QEvent::WhatsThis) {
        QToolTip::showText(QCursor::pos(), QString("CustomeDelegate Whatsthis"), reinterpret_cast<QWidget*>(view), option.rect, 1000);
    }
    return true;
}

當Editor顯示的時候，會調用setEditorData()這個函數來顯示默認的文字：

void CustomeDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const
{
    dynamic_cast<QLineEdit*>(editor)->setText(index.data(Qt::DisplayRole).toString());
}

setModelData()這個函數用來更新Model中的數據：

void CustomeDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const
{
    model->setData(index, dynamic_cast<QLineEdit*>(editor)->text(), Qt::DisplayRole);
}

updateEditorGeometry()這個函數也會在Editor顯示的時候被調用，雙擊不同方格時，我們用它來更新編輯器的位置和大小：

void CustomeDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    dynamic_cast<QLineEdit*>(editor)->setFixedSize(option.rect.width(), option.rect.height());
    dynamic_cast<QLineEdit*>(editor)->move(option.rect.topLeft());
}

4. 運行結果

完整代碼見此處。