Qt实战案例（52）——利用Qt实现打开最近图片功能（利用QPushButton按钮实现）

上文【Qt实战案例（51）——利用Qt实现打开最近图片功能】和上上文【Qt实战案例（50）——利用Qt实现打开最近文档功能】分别介绍了利用菜单栏action实现打开最近图片功能和打开最近文档功能，并在菜单栏显示最近图片和最近文档名称。本文将介绍利用按钮QPushButton实现打开最近图片功能并在按钮上显示图片名称。

一、项目介绍

本文介绍利用QPushButton按钮和QButtonGroup按钮组实现打开最近图片功能。（存储在QSettings中）

二、项目基本配置

新建一个Qt案例，项目名称为“PhotoTest”，基类选择“QWidget”，点击选中创建UI界面复选框，完成项目创建。

三、UI界面设置

UI界面如下： UI界面控件布局如下：

序号名称类型属性①pbn_chooseQPushButtontext：选择②pbn1QPushButtontext：③pbn2QPushButtontext：④pbn3QPushButtontext：⑤label_recentQLabeltext：最近⑥labelQLabel/ 四、主程序实现 4.1 widget.h头文件

头文件中声明两个槽函数和若干个私有变量和函数：

private slots:
    void on_pbn_choose_clicked();
    void slot_CheckBoxGroupClicked(int id);

private:
    QButtonGroup *group;
    const int maxFileNr=3;//最大显示三个最近
    QList recentList;
    QString currentFilePath;

    void loadFile(const QString &filePath);
    void updateRecentList();
    void adjustForCurrentFile(const QString &filePath);

4.2 widget.cpp源文件

需要在构造函数中首先定义一个QButtonGroup按钮组，包含三个按钮：pbn1、pbn2和pbn3并设置相应的id，然后设置按钮默认不可见，设置按钮可选（By default, the button is not checkable.）之后将按钮组连接信号与槽，保证能够识别哪个按钮被按下，最后更新RecentList，代码如下：

    //按钮组
    group = new  QButtonGroup(this);
    group->setObjectName("group");
    group->addButton(ui->pbn1,0);
    group->addButton(ui->pbn2,1);
    group->addButton(ui->pbn3,2);
    //不可见
    group->button(0)->setVisible(false);
    group->button(1)->setVisible(false);
    group->button(2)->setVisible(false);
    //按钮可选
    group->button(0)->setCheckable(true);
    group->button(1)->setCheckable(true);
    group->button(2)->setCheckable(true);
    
    // 连接信号和槽
     connect(group, SIGNAL(idClicked(int)), this, SLOT(slot_CheckBoxGroupClicked(int)));


    updateRecentList();

on_pbn_choose_clicked槽函数用于响应用户点击“选择”按钮的操作：

//选择图片并加载
void Widget::on_pbn_choose_clicked()
{
    QString filePath = QFileDialog::getOpenFileName(
                this, tr("Choose Photo"), "",
                tr("Images (*.png *.xpm *.jpg *.gif)"));
    if (!filePath.isEmpty())
        loadFile(filePath);
}

loadFile函数将图片进行加载并在label中显示并居中对齐：

//加载图片
void Widget::loadFile(const QString &filePath){
    QFile file(filePath);
    //如果不能打开
    if (!file.open(QFile::ReadOnly)) {
        QMessageBox::warning(this, tr("Recent Photos"),
                             tr("This file could not be found:\n%1.")
                             .arg(filePath));
        return;
    }

    QPixmap pMap(filePath);
    //如果图片为空
    if (pMap.isNull()) {
        QMessageBox::information(this, tr("Recent Photos"),
                      tr("Cannot load:\n%1.")
                      .arg(filePath));
        return;
    }

    ui->label->setPixmap(pMap);                //显示图像
    ui->label->setAlignment(Qt::AlignCenter);  //居中对齐
    adjustForCurrentFile(filePath);
}

按钮组对应的槽函数定义如下：

void Widget::slot_CheckBoxGroupClicked(int id)
{
    if( group->button(id)->isChecked())
    {
          loadFile(group->button(id)->accessibleDescription());
    }
}

该函数用于获取点击的按钮组的按钮的id并将该按钮的描述性文本accessibleDescription进行读取并显示在label中。

adjustForCurrentFile函数用于调整当前文件，使得每次新打开的文件都在最上方，代码如下：

//调整当前文件(使得每次新打开的文件都在最上方)
void Widget::adjustForCurrentFile(const QString &filePath){
    currentFilePath = filePath;
    setWindowFilePath(currentFilePath);

    QSettings settings("Recently", "Recent Photos");
    QStringList recentFilePaths = settings.value("recentPhotos").toStringList();//获取键对应的值
    recentFilePaths.removeAll(filePath);    //移除filePath
    recentFilePaths.prepend(filePath);      //在开头增加filePath
    //如果尺寸超过最大尺寸，则删除最后一项
    while (recentFilePaths.size() > maxFileNr)
        recentFilePaths.removeLast();
    settings.setValue("recentPhotos", recentFilePaths);//设置键recentPhotos对应的值

    updateRecentList();
}

updateRecentList函数用于更新group->button，该函数首先获取recentFilePaths路径并获取其尺寸，然后逐个遍历获取其文件名strippedName（不包含路径），并将按钮组中button(i)的按钮名称设置为strippedName，将按钮组中button(i)的描述性信息设置为recentFilePaths（AccessibleDescription存放完整路径），并将其设置为可见，将其他按钮设置为不可见，代码如下：

//更新group
void Widget::updateRecentList(){
    QSettings settings("Recently", "Recent Photos");
    QStringList recentFilePaths = settings.value("recentPhotos").toStringList();//获取键对应的值

    auto itEnd = 0;
    if(recentFilePaths.size() setText(strippedName);  //设置按钮名称

        group->button(i)->setAccessibleDescription(recentFilePaths.at(i));
        //group->button(i)->setData(recentFilePaths.at(i)); //数据
        //qDebug()