Qt Model/View/Delegate浅谈 - roleNames()

原创
2016/04/18 15:14
阅读数 2.2K

role,也就是俗称的角色.

##roleNames()函数介绍及默认值 roleNames()函数返回一个model的所有角色名称. 在Qt中默认的角色名称如下:

Qt Role QML Role Name
Qt::DisplayRole display
Qt::DecorationRole decoration
Qt::EditRole edit
Qt::ToolTipRole toolTip
Qt::StatusTipRole statusTip
Qt::WhatsThisRole whatsThis

##自定义roleNames() Qt旧版本中,可以通过setRoleNames()函数来实现自己想要的角色名,

This function is obsolete. Reimplement roleNames() instead.

但是根据Qt5.6.0新版本相关文档的介绍,该函数已经过时,需要通过重新实现roleNames()来替代setRoleNames(). 这意味着:如果我们想要自定义的角色名,则需要重新实现虚函数roleNames().

接下来,我们看看到底如何自定义roleNames():

  • 首先在头文件中添加枚举类型(注意枚举类型命名规则)
//customModel.h

#include <QAbstractItemModel>

class customModel : public QAbstractItemModel
{
    Q_OBJECT
public:
    enum StringListRoles{
        IconRole = Qt::UserRole + 1, //都是Role结尾的
        TextRole = Qt::UserRole + 2,
        UrlRole = Qt::UserRole + 3
    }; 
    explicit customModel(QObject *parent = 0);
    ~customModel();
        
    QHash<int, QByteArray> roleNames() const; //重新实现roleNames()
}
  • 然后重新实现roleNames()
//customModel.cpp

//角色名
QHash<int, QByteArray> customModel::roleNames() const
{
    //这里插入的值需要和前面定义的枚举类型对应
    QHash<int, QByteArray> roleNames;
    roleNames.insert(customModel::IconRole, QByteArray("icon"));
    roleNames.insert(customModel::TextRole, QByteArray("text"));
    roleNames.insert(customModel::UrlRole, QByteArray("url"));
    return roleNames;
}

然后就可以自由使用自己想要的role了.

注意: QListView & QTreeView & QTableView等视图默认使用的是Qt里roleNames()返回的默认角色,所以如果想要视图识别和读取自定义的角色名,还要重新实现对应的delegate.

展开阅读全文
打赏
1
1 收藏
分享
加载中
更多评论
打赏
0 评论
1 收藏
1
分享
返回顶部
顶部