「Qt Widget中文示例指南」如何实现一个快捷编辑器(一)
Qt是目前最先进、最完整的跨平台C++开发工具。它不仅完全实现了一次编写,所有平台无差别运行,更提供了几乎所有开发过程中需要用到的工具。如今,Qt已被运用于超过70个行业、数千家企业,支持数百万设备及应用。
快捷编辑器示例展示了如何创建一个基本的读写层次模型,来与Qt的标准视图和QKeySequenceEdit类一起使用。
Qt的模型/视图架构为视图提供了一种标准的方式来操作数据源中的信息,使用数据的抽象模型来简化和标准化访问数据的方式。快捷编辑器模型将操作表示为项目树,并允许视图通过基于索引的系统访问此数据。更一般地说,可以使用模型以树结构的形式表示数据,方法是允许每个项作为子项表的父项。
设计及概念
我们用来表示数据结构的数据结构采用由ShortcutEditorModelItem对象构建的树表单,每个ShortcutEditorModelItem表示树视图中的一个项,并包含两列数据。
快捷编辑器结构
数据使用ShortcutEditorModelItem对象存储在模型内部,这些对象在基于指针的树结构中链接在一起。通常每个ShortcutEditorModelItem都有一个父项,并且可以有许多子项。但是树结构中的根项没有父项,也不会在模型之外被引用。
每个ShortcutEditorModelItem都包含有关其在树结构中的位置的信息,它可以返回父项及其行号。有了这些随时可用的信息,就可以更容易地实现模型。
由于树视图中的每个项通常包含几列数据(在本例中是一个名称和一个快捷方式),因此将这些信息存储在每个项中是很自然的。为简单起见,我们将使用一个QVariant对象列表来存储项目中每一列的数据。
使用基于指针的树结构意味着,当将模型索引传递给视图时,我们可以记录索引中相应项的地址(参见QAbstractItemModel::createIndex()),并稍后使用QModelIndex::internalPointer()检索它。这使得编写模型更容易,并确保引用同一项的所有模型索引具有相同的内部数据指针。
有了适当的数据结构,我们就可以用最少的额外代码创建树模型,为其他组件提供模型索引和数据。
ShortcutEditorModelItem类定义
ShortcutEditorModelItem类定义如下:
这个类是一个基本的c++类,它不继承QObject,也不提供信号和插槽。它用于保存qvariables列表,其中包含列数据和关于其在树结构中的位置的信息。这些函数提供以下特性:
- appendChildItem()用于在模型首次构造时添加数据,在正常使用期间不会使用。
- child()和childCount()函数允许模型获取任何子项的信息。
- 与项目相关联的列数信息由columnCount()提供,每列中的数据可以通过data()函数获得。
- row()和parent()函数用于获取项的行号和父项。
父项和列数据存储在parentItem和itemData私有成员变量中,childItems变量包含一个指向该项自身子项的指针列表。
ShortcutEditorModel类定义
ShortcutEditorModel类定义如下:
class ShortcutEditorModel : public QAbstractItemModel { Q_OBJECT class ShortcutEditorModelItem { public: explicit ShortcutEditorModelItem(const QList<QVariant> &data, ShortcutEditorModelItem *parentItem = nullptr); ~ShortcutEditorModelItem(); void appendChild(ShortcutEditorModelItem *child); ShortcutEditorModelItem *child(int row) const; int childCount() const; int columnCount() const; QVariant data(int column) const; int row() const; ShortcutEditorModelItem *parentItem() const; QAction *action() const; private: QList<ShortcutEditorModelItem *> m_childItems; QList<QVariant> m_itemData; ShortcutEditorModelItem *m_parentItem; }; public: explicit ShortcutEditorModel(QObject *parent = nullptr); ~ShortcutEditorModel() override; QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override; Qt::ItemFlags flags(const QModelIndex &index) const override; QVariant headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const override; QModelIndex index(int row, int column, const QModelIndex &parent = QModelIndex()) const override; QModelIndex parent(const QModelIndex &index) const override; int rowCount(const QModelIndex &index = QModelIndex()) const override; int columnCount(const QModelIndex &index = QModelIndex()) const override; bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override; void setActions(); private: void setupModelData(ShortcutEditorModelItem *parent); ShortcutEditorModelItem *m_rootItem; };这个类类似于提供读写模型的QAbstractItemModel的大多数其他子类,只有构造函数的表单和setupModelData()函数是特定于这个模型的。此外,我们还提供了一个析构函数,以便在模型被销毁时进行清理。