Qt5 中 关于Widget Mapper的简单应用

近期，在解读一个项目的Demo时，用到了不少Qt 开发的一些技术，其中有一个内容就是Wigdet Mapper功能。有些看不明白，对照《QtCreator快速入门》这本书的相关介绍，才知道这是有关模型、视图编程的内容。在处理一些大容量数据上会很方便。

数据-窗口映射器（QDataWidgetMapper）类在数据模型的一个区域和一个窗口部件提供了一个映射。这样就可以实现在一个窗口部件上显示和编辑一个模型中的一行数据。

Qt5 的官方提供了一个简单的实例 效果如下：
这个实例非常简单，首先会创建一个窗体（window）,该窗体的一些部件会显示一些数据。通过按钮可是显示数据模型中的不同记录。

具体实现过程如下：

定义一个窗体的类用来实现4项内容：
1、构造窗体
2、添加信号槽用于更新记录
3、私有对象中添加实现建立数据模型的函数
4、以代码方式添加相关的控件。

  class Window : public QWidget
  {
      Q_OBJECT

  public:
      Window(QWidget *parent = nullptr);

  private slots:
      void updateButtons(int row);

  private:
      void setupModel();

      QLabel *nameLabel;
      QLabel *addressLabel;
      QLabel *ageLabel;
      QLineEdit *nameEdit;
      QTextEdit *addressEdit;
      QSpinBox *ageSpinBox;
      QPushButton *nextButton;
      QPushButton *previousButton;

      QStandardItemModel *model;
      QDataWidgetMapper *mapper;
  };

这里，数据-窗口映射器（QDataWidgetMapper）来实现用户的接口。
标准数据模型来处理数据。

窗体类的实现

窗体的构造函数实现三个部分
1、创建控件，并且将标签（Lable）和输入部件（input Widget）建立伙伴关系。

  Window::Window(QWidget *parent)
      : QWidget(parent)
  {
      setupModel();

      nameLabel = new QLabel(tr("Na&me:"));
      nameEdit = new QLineEdit();
      addressLabel = new QLabel(tr("&Address:"));
      addressEdit = new QTextEdit();
      ageLabel = new QLabel(tr("A&ge (in years):"));
      ageSpinBox = new QSpinBox();
      nextButton = new QPushButton(tr("&Next"));
      previousButton = new QPushButton(tr("&Previous"));

      nameLabel->setBuddy(nameEdit);
      addressLabel->setBuddy(addressEdit);
      ageLabel->setBuddy(ageSpinBox);

2、建立控件的映射（widget mapper），同时通过按钮（Next）和按钮（Previous）分别与信号槽 toNext() 和 toPrevious() 相连接。

      mapper = new QDataWidgetMapper(this);
      mapper->setModel(model);
      mapper->addMapping(nameEdit, 0);
      mapper->addMapping(addressEdit, 1);
      mapper->addMapping(ageSpinBox, 2);

      connect(previousButton, &QAbstractButton::clicked, mapper, &QDataWidgetMapper::toPrevious);
      connect(nextButton, &QAbstractButton::clicked, mapper, &QDataWidgetMapper::toNext);
      connect(mapper, &QDataWidgetMapper::currentIndexChanged, this, &Window::updateButtons);

3、通过栅格化布局窗体部件的呈现方式，同时也设置好窗体的名称，并将数据定位到数据模型的最前面一项。

     QGridLayout *layout = new QGridLayout();
      layout->addWidget(nameLabel, 0, 0, 1, 1);
      layout->addWidget(nameEdit, 0, 1, 1, 1);
      layout->addWidget(previousButton, 0, 2, 1, 1);
      layout->addWidget(addressLabel, 1, 0, 1, 1);
      layout->addWidget(addressEdit, 1, 1, 2, 1);
      layout->addWidget(nextButton, 1, 2, 1, 1);
      layout->addWidget(ageLabel, 3, 0, 1, 1);
      layout->addWidget(ageSpinBox, 3, 1, 1, 1);
      setLayout(layout);

      setWindowTitle(tr("Simple Widget Mapper"));
      mapper->toFirst();

建立数据模型

setupModel()函数建立5行3列的标准数据模型，同时，初始化相关的一些数据

  void Window::setupModel()
  {
      model = new QStandardItemModel(5, 3, this);

      QStringList names;
      names << "Alice" << "Bob" << "Carol" << "Donald" << "Emma";

      QStringList addresses;
      addresses << "<qt>123 Main Street<br/>Market Town</qt>"
                << "<qt>PO Box 32<br/>Mail Handling Service"
                   "<br/>Service City</qt>"
                << "<qt>The Lighthouse<br/>Remote Island</qt>"
                << "<qt>47338 Park Avenue<br/>Big City</qt>"
                << "<qt>Research Station<br/>Base Camp<br/>Big Mountain</qt>";

      QStringList ages;
      ages << "20" << "31" << "32" << "19" << "26";

      for (int row = 0; row < 5; ++row) {
        QStandardItem *item = new QStandardItem(names[row]);
        model->setItem(row, 0, item);
        item = new QStandardItem(addresses[row]);
        model->setItem(row, 1, item);
        item = new QStandardItem(ages[row]);
        model->setItem(row, 2, item);
      }
  }

这样，就实现了数据模型与窗体控件的对应关系：

这样，基本就实现了。如果想让导航按钮（previous 、next）的显示更友好，可以添加下面的代码：

  void Window::updateButtons(int row)
  {
      previousButton->setEnabled(row > 0);
      nextButton->setEnabled(row < model->rowCount() - 1);
  }