`
qimo601
  • 浏览: 3445986 次
  • 性别: Icon_minigender_1
  • 来自: 苏州
社区版块
存档分类
最新评论

基于QStyledItemDelegate的例子 Star Delegate Example

    博客分类:
  • Qt
阅读更多
 class StarDelegate : public QStyledItemDelegate
 {
     Q_OBJECT

 public:
     StarDelegate(QWidget *parent = 0) : QStyledItemDelegate(parent) {}

     void paint(QPainter *painter, const QStyleOptionViewItem &option,
                const QModelIndex &index) const;
     QSize sizeHint(const QStyleOptionViewItem &option,
                    const QModelIndex &index) const;
     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;

 private slots:
     void commitAndCloseEditor();
 };

All public functions are reimplemented virtual functions from QItemDelegate to provide custom rendering and editing.

StarDelegate Class Implementation

The paint() function is reimplemented from QItemDelegate and is called whenever the view needs to repaint an item:

 void StarDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option,
                          const QModelIndex &index) const
 {
     if (qVariantCanConvert<StarRating>(index.data())) {
         StarRating starRating = qVariantValue<StarRating>(index.data());

         if (option.state & QStyle::State_Selected)
             painter->fillRect(option.rect, option.palette.highlight());

         starRating.paint(painter, option.rect, option.palette,
                          StarRating::ReadOnly);
     } else {
         QStyledItemDelegate::paint(painter, option, index);
     }

The function is invoked once for each item, represented by a QModelIndex object from the model. If the data stored in the item is aStarRating, we paint it ourselves; otherwise, we let QItemDelegate paint it for us. This ensures that the StarDelegate can handle the most common data types.

In the case where the item is a StarRating, we draw the background if the item is selected, and we draw the item usingStarRating::paint(), which we will review later.

StartRatings can be stored in a QVariant thanks to the Q_DECLARE_METATYPE() macro appearing in starrating.h. More on this later.

The createEditor() function is called when the user starts editing an item:

 QWidget *StarDelegate::createEditor(QWidget *parent,
                                     const QStyleOptionViewItem &option,
                                     const QModelIndex &index) const

 {
     if (qVariantCanConvert<StarRating>(index.data())) {
         StarEditor *editor = new StarEditor(parent);
         connect(editor, SIGNAL(editingFinished()),
                 this, SLOT(commitAndCloseEditor()));
         return editor;
     } else {
         return QStyledItemDelegate::createEditor(parent, option, index);
     }
 }

If the item is a StarRating, we create a StarEditor and connect its editingFinished() signal to our commitAndCloseEditor() slot, so we can update the model when the editor closes.

Here's the implementation of commitAndCloseEditor():

 void StarDelegate::commitAndCloseEditor()
 {
     StarEditor *editor = qobject_cast<StarEditor *>(sender());
     emit commitData(editor);
     emit closeEditor(editor);
 }

When the user is done editing, we emit commitData() and closeEditor() (both declared in QAbstractItemDelegate), to tell the model that there is edited data and to inform the view that the editor is no longer needed.

The setEditorData() function is called when an editor is created to initialize it with data from the model:

 void StarDelegate::setEditorData(QWidget *editor,
                                  const QModelIndex &index) const
 {
     if (qVariantCanConvert<StarRating>(index.data())) {
         StarRating starRating = qVariantValue<StarRating>(index.data());
         StarEditor *starEditor = qobject_cast<StarEditor *>(editor);
         starEditor->setStarRating(starRating);
     } else {
         QStyledItemDelegate::setEditorData(editor, index);
     }
 }

We simply call setStarRating() on the editor.

The setModelData() function is called when editing is finished, to commit data from the editor to the model:

 void StarDelegate::setModelData(QWidget *editor, QAbstractItemModel *model,
                                 const QModelIndex &index) const
 {
     if (qVariantCanConvert<StarRating>(index.data())) {
         StarEditor *starEditor = qobject_cast<StarEditor *>(editor);
         model->setData(index, qVariantFromValue(starEditor->starRating()));
     } else {
         QStyledItemDelegate::setModelData(editor, model, index);
     }
 }

The sizeHint() function returns an item's preferred size:

 QSize StarDelegate::sizeHint(const QStyleOptionViewItem &option,
                              const QModelIndex &index) const
 {
     if (qVariantCanConvert<StarRating>(index.data())) {
         StarRating starRating = qVariantValue<StarRating>(index.data());
         return starRating.sizeHint();
     } else {
         return QStyledItemDelegate::sizeHint(option, index);
     }
 }

We simply forward the call to StarRating.

StarEditor Class Definition

The StarEditor class was used when implementing StarDelegate. Here's the class definition:

 class StarEditor : public QWidget
 {
     Q_OBJECT

 public:
     StarEditor(QWidget *parent = 0);

     QSize sizeHint() const;
     void setStarRating(const StarRating &starRating) {
         myStarRating = starRating;
     }
     StarRating starRating() { return myStarRating; }

 signals:
     void editingFinished();

 protected:
     void paintEvent(QPaintEvent *event);
     void mouseMoveEvent(QMouseEvent *event);
     void mouseReleaseEvent(QMouseEvent *event);

 private:
     int starAtPosition(int x);

     StarRating myStarRating;
 };

The class lets the user edit a StarRating by moving the mouse over the editor. It emits the editingFinished() signal when the user clicks on the editor.

The protected functions are reimplemented from QWidget to handle mouse and paint events. The private function starAtPosition() is a helper function that returns the number of the star under the mouse pointer.

StarEditor Class Implementation

Let's start with the constructor:

 StarEditor::StarEditor(QWidget *parent)
     : QWidget(parent)
 {
     setMouseTracking(true);
     setAutoFillBackground(true);
 }

We enable mouse tracking on the widget so we can follow the cursor even when the user doesn't hold down any mouse button. We also turn on QWidget's auto-fill background feature to obtain an opaque background. (Without the call, the view's background would shine through the editor.)

The paintEvent() function is reimplemented from QWidget:

 void StarEditor::paintEvent(QPaintEvent *)
 {
     QPainter painter(this);
     myStarRating.paint(&painter, rect(), this->palette(),
                        StarRating::Editable);
 }

We simply call StarRating::paint() to draw the stars, just like we did when implementing StarDelegate.

 void StarEditor::mouseMoveEvent(QMouseEvent *event)
 {
     int star = starAtPosition(event->x());

     if (star != myStarRating.starCount() && star != -1) {
         myStarRating.setStarCount(star);
         update();
     }
 }

In the mouse event handler, we call setStarCount() on the private data member myStarRating to reflect the current cursor position, and we call QWidget::update() to force a repaint.

 void StarEditor::mouseReleaseEvent(QMouseEvent * /* event */)
 {
     emit editingFinished();
 }

When the user releases a mouse button, we simply emit the editingFinished() signal.

 int StarEditor::starAtPosition(int x)
 {
     int star = (x / (myStarRating.sizeHint().width()
                      / myStarRating.maxStarCount())) + 1;
     if (star <= 0 || star > myStarRating.maxStarCount())
         return -1;

     return star;
 }

The starAtPosition() function uses basic linear algebra to find out which star is under the cursor.

StarRating Class Definition

 class StarRating
 {
 public:
     enum EditMode { Editable, ReadOnly };

     StarRating(int starCount = 1, int maxStarCount = 5);

     void paint(QPainter *painter, const QRect &rect,
                const QPalette &palette, EditMode mode) const;
     QSize sizeHint() const;
     int starCount() const { return myStarCount; }
     int maxStarCount() const { return myMaxStarCount; }
     void setStarCount(int starCount) { myStarCount = starCount; }
     void setMaxStarCount(int maxStarCount) { myMaxStarCount = maxStarCount; }

 private:
     QPolygonF starPolygon;
     QPolygonF diamondPolygon;
     int myStarCount;
     int myMaxStarCount;
 };

 Q_DECLARE_METATYPE(StarRating)

The StarRating class represents a rating as a number of stars. In addition to holding the data, it is also capable of painting the stars on aQPaintDevice, which in this example is either a view or an editor. The myStarCount member variable stores the current rating, andmyMaxStarCount stores the highest possible rating (typically 5).

The Q_DECLARE_METATYPE() macro makes the type StarRating known to QVariant, making it possible to store StarRating values inQVariant.

StarRating Class Implementation

The constructor initializes myStarCount and myMaxStarCount, and sets up the polygons used to draw stars and diamonds:

 StarRating::StarRating(int starCount, int maxStarCount)
 {
     myStarCount = starCount;
     myMaxStarCount = maxStarCount;

     starPolygon << QPointF(1.0, 0.5);
     for (int i = 1; i < 5; ++i)
         starPolygon << QPointF(0.5 + 0.5 * cos(0.8 * i * 3.14),
                                0.5 + 0.5 * sin(0.8 * i * 3.14));

     diamondPolygon << QPointF(0.4, 0.5) << QPointF(0.5, 0.4)
                    << QPointF(0.6, 0.5) << QPointF(0.5, 0.6)
                    << QPointF(0.4, 0.5);
 }

The paint() function paints the stars in this StarRating object on a paint device:

 void StarRating::paint(QPainter *painter, const QRect &rect,
                        const QPalette &palette, EditMode mode) const
 {
     painter->save();

     painter->setRenderHint(QPainter::Antialiasing, true);
     painter->setPen(Qt::NoPen);

     if (mode == Editable) {
         painter->setBrush(palette.highlight());
     } else {
         painter->setBrush(palette.foreground());
     }

     int yOffset = (rect.height() - PaintingScaleFactor) / 2;
     painter->translate(rect.x(), rect.y() + yOffset);
     painter->scale(PaintingScaleFactor, PaintingScaleFactor);

     for (int i = 0; i < myMaxStarCount; ++i) {
         if (i < myStarCount) {
             painter->drawPolygon(starPolygon, Qt::WindingFill);
         } else if (mode == Editable) {
             painter->drawPolygon(diamondPolygon, Qt::WindingFill);
         }
         painter->translate(1.0, 0.0);
     }

     painter->restore();
 }

We first set the pen and brush we will use for painting. The mode parameter can be either Editable or ReadOnly. If mode is editable, we use the Highlight color instead of the Foreground color to draw the stars.

Then we draw the stars. If we are in Edit mode, we paint diamonds in place of stars if the rating is less than the highest rating.

The sizeHint() function returns the preferred size for an area to paint the stars on:

 QSize StarRating::sizeHint() const
 {
     return PaintingScaleFactor * QSize(myMaxStarCount, 1);
 }

The preferred size is just enough to paint the maximum number of stars. The function is called by both StarDelegate::sizeHint() andStarEditor::sizeHint().

The main() Function

Here's the program's main() function:

 int main(int argc, char *argv[])
 {
     QApplication app(argc, argv);

     QTableWidget tableWidget(4, 4);
     tableWidget.setItemDelegate(new StarDelegate);
     tableWidget.setEditTriggers(QAbstractItemView::DoubleClicked
                                 | QAbstractItemView::SelectedClicked);
     tableWidget.setSelectionBehavior(QAbstractItemView::SelectRows);

     QStringList headerLabels;
     headerLabels << "Title" << "Genre" << "Artist" << "Rating";
     tableWidget.setHorizontalHeaderLabels(headerLabels);

     populateTableWidget(&tableWidget);

     tableWidget.resizeColumnsToContents();
     tableWidget.resize(500, 300);
     tableWidget.show();

     return app.exec();
 }

The main() function creates a QTableWidget and sets a StarDelegate on it. DoubleClicked and SelectedClicked are set as edit triggers, so that the editor is opened with a single click when the star rating item is selected.

The populateTableWidget() function fills the QTableWidget with data:

 void populateTableWidget(QTableWidget *tableWidget)
 {
     static const struct {
         const char *title;
         const char *genre;
         const char *artist;
         int rating;
     } staticData[] = {
         { "Mass in B-Minor", "Baroque", "J.S. Bach", 5 },
     ...
         { 0, 0, 0, 0 }
     };

     for (int row = 0; staticData[row].title != 0; ++row) {
         QTableWidgetItem *item0 = new QTableWidgetItem(staticData[row].title);
         QTableWidgetItem *item1 = new QTableWidgetItem(staticData[row].genre);
         QTableWidgetItem *item2 = new QTableWidgetItem(staticData[row].artist);
         QTableWidgetItem *item3 = new QTableWidgetItem;
         item3->setData(0,
                        qVariantFromValue(StarRating(staticData[row].rating)));

         tableWidget->setItem(row, 0, item0);
         tableWidget->setItem(row, 1, item1);
         tableWidget->setItem(row, 2, item2);
         tableWidget->setItem(row, 3, item3);
     }
 }

Notice the call to qVariantFromValue to convert a StarRating to a QVariant.

Possible Extensions and Suggestions

There are many ways to customize Qt's model/view framework. The approach used in this example is appropriate for most custom delegates and editors. Examples of possibilities not used by the star delegate and star editor are:

分享到:
评论

相关推荐

    DelegateExample

    `DelegateExample` 提供了一个关于委托(Delegate)模式的简单示例。委托是一种设计模式,它允许类或对象将某些职责委派给其他对象,而不是直接执行这些职责。在Objective-C中,委托模式通过遵循特定的协议来实现。 ...

    DelegateExample.zip

    这是C#委托很经典很简单的一个例子,根据刘猛铁老师的C#语言入门详解系列视频中的案例的代码,适合初学者学习。这是C#委托很经典很简单的一个例子,根据刘猛铁老师的C#语言入门详解系列视频中的案例的代码,适合初学...

    事件触发最简单例子event delegate

    事件触发是事件驱动编程的核心,而委托(Delegate)则是实现事件处理的关键机制。本文将深入探讨事件触发与委托的概念,并通过一个简单的例子来演示它们的工作原理。 首先,让我们理解什么是事件。事件是一种封装了...

    qt model view Delegate的例子

    这个例子中的“qt model view Delegate”可能是为了演示如何有效地使用这些组件来实现复杂的用户界面功能。 在Qt中,模型(Model)存储和管理数据,可以是简单的列表或表格,也可以是复杂的数据结构。视图(View)...

    QT 自定义混合控件——基于View/Model/Delegate的QTableView/QTreewidget/Combobox实现

    在本项目"QT自定义混合控件——基于View/Model/Delegate的QTableView/QTreewidget/Combobox实现"中,我们将深入探讨如何利用QT库中的核心组件构建一个强大的数据展示和交互界面。 首先,我们要理解View/Model/...

    DelegateExample.rar_C#编程_C#_

    标题中的"DelegateExample.rar"表明这是一个关于C#编程中委托(Delegate)的示例应用,而"C#编程_C#"进一步确认了我们正在讨论的是使用C#语言进行程序设计的主题。描述中的"simple application"提示我们将要探讨的是一...

    C# Delegate小例子

    在这个"C# Delegate小例子"中,我们将深入探讨Delegate的概念、使用方式以及它在实际编程中的应用。 1. **Delegate概念**: Delegate在C#中是一种类,它代表对方法的引用。这种引用是类型安全的,意味着在编译时就...

    iOS delegate 简单小例子

    iOS 的delegate代码是http://blog.csdn.net/ilikeprograming/article/details/26206075的附件。这份代码有助于新手理解delegate。

    QT 基于View/Model/Delegate的QTableView/QTreewidget/QCombox

    在本项目中,我们关注的是基于View/Model/Delegate的QTableView、QTreewidget和QComboBox的实现。这三个组件是QT中用于数据展示和交互的重要控件。 首先,让我们详细了解View/Model/Delegate模式。这是QT中的一个...

    ios app:Delegate例子

    下面,我们通过一个简单的例子来演示如何使用Delegate: 1. 首先,定义一个协议。假设我们有一个名为`MessageSender`的类,它需要向另一个对象发送消息。我们可以创建一个名为`MessageDelegate`的协议,其中包含一...

    在qt的MVC模式中,运用控件在delegate中显示的方法

    在名为`example`的压缩包中,可能包含了一个简单的示例,展示了如何创建一个Delegate来显示一个自定义的日期选择器控件。在这个例子中,我们可能看到`MyDateDelegate`类的定义,以及如何将其应用到QTableView的代码...

    DelegateExample:委托和Segue的使用

    DelegateExample项目可能包含了一系列示例,演示了如何在实际应用中使用委托和UIStoryboardSegue。例如,一个简单的场景可能是:在一个登录界面,用户输入用户名和密码后点击“登录”按钮,触发一个...

    iOS设计模式——委托(delegate)例子

    在上面的例子中,`MyViewController`作为委托对象,实现了`MyDelegate`协议中的`didReceiveEvent`方法。当`DelegateOwner`触发`triggerEvent`时,它会通过`delegate`引用调用`didReceiveEvent`,将事件传递给`...

    简单的delegate实现

    在这个例子中,ViewController类不仅继承自UIViewController,还遵循了SimpleDelegate协议,因此它必须实现`didTapButton:`方法。 3. **设置Delegate**: 在需要使用委托的对象中,通常会有一个属性来存储...

    unity delegate和event的例子

    我自己写的一个博文配的例子,博文地址待审核后加上去。

    C#例子代码 A0031_delegate

    C#例子代码 A0031_delegateC#例子代码 A0031_delegateC#例子代码 A0031_delegateC#例子代码 A0031_delegateC#例子代码 A0031_delegateC#例子代码 A0031_delegateC#例子代码 A0031_delegateC#例子代码 A0031_...

    iOS Delegate传值通俗理解

    在iOS开发中,Delegate是一种非常重要的设计模式,用于对象间通信。它允许一个对象(委托者)通知另一个对象(委托对象)关于特定事件的发生。在iOS应用中,Delegate经常用于控制器间的通信,如UIViewController和...

    C# delegate thread范例

    在`Thread_delegateExample-master`这个项目中,可能包含了一个或者多个C#源文件,如`.cs`,展示了如何定义委托,创建线程,以及在不同线程之间使用委托来调用方法。 项目中的关键部分可能包括: 1. 委托的定义,如...

    iPhone编程delegate示例

    在Objective-C中,`delegate`是一种关键的编程模式,用于实现对象间的通信。本文将深入探讨如何在iPhone编程中使用`delegate`,并以一个名为"MyDelegateSample"的示例项目来说明。 首先,`delegate`是Objective-C中...

    delegate、NSNotification、block比较

    在iOS和macOS开发中,`delegate`、`NSNotification`和`block`是三种常见的对象间通信机制。它们各自有着不同的特性和应用场景,理解这些差异对于优化代码结构和提高程序性能至关重要。 首先,我们来看看`delegate`...

Global site tag (gtag.js) - Google Analytics