Qt的Model/View设计中,有一些隐藏的代码,它们大多放在私有类里,对于类的作用非常关键,体现着Qt的整体设计思想。然而,由于它们比较隐蔽,学习起来比较繁琐,受到人们的忽视。然而,体现设计思想,提高编程水平往往需要研读深层次代码。所谓奇伟鬼怪之观,大多在于险远,非有志者不能至也。
QFileSystemModel继承自QAbstractItemModel类,作为子类,需要实现一些成员函数。面向对象编程中,如何划分父类和子类的职责需要仔细权衡。拿flags函数的设计来说,目的是让model能获取肚子里的某一个node的信息。如果把它放在父类中,会出现什么问题呢?问题是,无法针对子类的个性而做出调整。
在QFileSystemModel的flags函数里面,有这样一行:
if ((index.column() == 0) && indexNode->permissions() & QFile::WriteUser) {
这里面用到了QFile::WriteUser,代表用户可以写这个node。正是由于需要根据model的项目而确定一些细节,所以要在子类中写这个flags函数。
在函数 QFileSystemModelPrivate::_q_fileSystemChanged中,调用了addNode函数。
void QFileSystemModelPrivate::_q_fileSystemChanged(const QString &path, const QVector<QPair<QString, QFileInfo> > &updates)
而在addNode函数中,又使用了populate函数,这个单词的意思是“填充”,这个词的意思对于理解这个函数的作用非常关键:对于一个文件系统的节点,它要么是文件,要么是文件夹,都需要一些信息来描述,比如对于文件夹,程序在运行的时候就会为其分配特定的图标,而对于特定文件类型,则分配对于它的文件类型的图标。除此之外,如果是文件,他就会有大小信息,这个信息也要在view中显示出来。populate函数就是用来把文件的信息“填充”到节点里面的。
另附Qt命名空间中,与flags相关的定义:
enum Qt::ItemFlag
flags Qt::ItemFlags
This enum describes the properties of an item:
Constant |
Value |
Description |
Qt::NoItemFlags |
0 |
It does not have any properties set. |
Qt::ItemIsSelectable |
1 |
It can be selected. |
Qt::ItemIsEditable |
2 |
It can be edited. |
Qt::ItemIsDragEnabled |
4 |
It can be dragged. |
Qt::ItemIsDropEnabled |
8 |
It can be used as a drop target. |
Qt::ItemIsUserCheckable |
16 |
It can be checked or unchecked by the user. |
Qt::ItemIsEnabled |
32 |
The user can interact with the item. |
Qt::ItemIsAutoTristate |
64 |
The item's state depends on the state of its children. This enables automatic management of the state of parent items in QTreeWidget (checked if all children are checked, unchecked if all children are unchecked, or partially checked if only some children are checked). |
Qt::ItemIsTristate |
ItemIsAutoTristate |
This enum value is deprecated. Use Qt::ItemIsAutoTristate instead. |
Qt::ItemNeverHasChildren |
128 |
The item never has child items. This is used for optimization purposes only. |
Qt::ItemIsUserTristate |
256 |
The user can cycle through three separate states. This value has been added in Qt 5.5. |
Note that checkable items need to be given both a suitable set of flags and an initial state, indicating whether the item is checked or not. This is handled automatically for model/view components, but needs to be explicitly set for instances of QListWidgetItem, QTableWidgetItem, and QTreeWidgetItem.
Note that it is undefined behavior to reimplement QAbstractItemModel::hasChildren to return true for an index if that index has the Qt::ItemNeverHasChildren flag set.
The ItemFlags type is a typedef for QFlags<ItemFlag>. It stores an OR combination of ItemFlag values.
See also QAbstractItemModel.
还有QFileDevice内部涉及到的定义:
enum QFileDevice::Permission
flags QFileDevice::Permissions
This enum is used by the permission() function to report the permissions and ownership of a file. The values may be OR-ed together to test multiple permissions and ownership values.
Constant |
Value |
Description |
QFileDevice::ReadOwner |
0x4000 |
The file is readable by the owner of the file. |
QFileDevice::WriteOwner |
0x2000 |
The file is writable by the owner of the file. |
QFileDevice::ExeOwner |
0x1000 |
The file is executable by the owner of the file. |
QFileDevice::ReadUser |
0x0400 |
The file is readable by the user. |
QFileDevice::WriteUser |
0x0200 |
The file is writable by the user. |
QFileDevice::ExeUser |
0x0100 |
The file is executable by the user. |
QFileDevice::ReadGroup |
0x0040 |
The file is readable by the group. |
QFileDevice::WriteGroup |
0x0020 |
The file is writable by the group. |
QFileDevice::ExeGroup |
0x0010 |
The file is executable by the group. |
QFileDevice::ReadOther |
0x0004 |
The file is readable by anyone. |
QFileDevice::WriteOther |
0x0002 |
The file is writable by anyone. |
QFileDevice::ExeOther |
0x0001 |
The file is executable by anyone. |
Warning: Because of differences in the platforms supported by Qt, the semantics of ReadUser, WriteUser and ExeUser are platform-dependent: On Unix, the rights of the owner of the file are returned and on Windows the rights of the current user are returned. This behavior might change in a future Qt version.
Note: On NTFS file systems, ownership and permissions checking is disabled by default for performance reasons. To enable it, include the following line:
extern Q_CORE_EXPORT int qt_ntfs_permission_lookup;
Permission checking is then turned on and off by incrementing and decrementing qt_ntfs_permission_lookup by 1.
qt_ntfs_permission_lookup++; // turn checking on
qt_ntfs_permission_lookup--; // turn it off again
The Permissions type is a typedef for QFlags<Permission>. It stores an OR combination of Permission values.