C/C++ Qt 給ListWidget增加右鍵選單

lyshark發表於2021-11-29
C++QT

在上一篇博文《C/C++ Qt ListWidget 列表框元件應用》中介紹了ListWidget元件的基本使用技巧，本次將給ListWidget元件增加一個右鍵選單，當使用者在ListWidget元件中的任意一個子項下右鍵，我們讓其彈出這個選單，並根據選擇提供不同的功能。

為了增加選單，我們首先需要在程式全域性增加QAction其中每一個QAction則代表一個選單選項指標。

// 全域性下設定增加選單
QAction *NewAction;
QAction *InsertAction;
QAction *DeleteAction;

其次則是通過程式碼的方式在程式中動態建立一個基礎的右鍵選單，並對該選單設定子選單以及所對應的圖示組，最後就是將訊號連線到指定的全域性選單指標上即可，這個程式碼實現如下。

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QMenuBar>
#include <QMenu>
#include <QToolBar>
#include <iostream>

// 全域性下設定增加選單
QAction *NewAction;
QAction *InsertAction;
QAction *DeleteAction;

// By: LyShark
// https://www.cnblogs.com/lyshark
MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 使用 customContextMenuRequested 訊號則需要設定
    ui->listWidget->setContextMenuPolicy(Qt::CustomContextMenu);

    // 隱藏選單欄上的右擊選單
    this->setContextMenuPolicy(Qt::NoContextMenu);

    // 建立基礎頂部選單
    QMenuBar *bar = menuBar();
    this->setMenuBar(bar);
    QMenu * fileMenu = bar->addMenu("選單1");
    bar->setVisible(false);   // 隱藏頂部選單欄

    // 新增子選單
     NewAction = fileMenu->addAction("增加IP地址");
     InsertAction = fileMenu->addAction("插入IP地址");
     DeleteAction = fileMenu->addAction("刪除IP地址");

    // 分別設定圖示
    NewAction->setIcon(QIcon(":/image/1.ico"));
    InsertAction->setIcon(QIcon(":/image/2.ico"));
    DeleteAction->setIcon(QIcon(":/image/3.ico"));

    // 繫結槽函式
    connect(NewAction,&QAction::triggered,this,[=](){
        std::cout << "new action" << std::endl;
        ui->plainTextEdit->appendPlainText(QString("新建觸發"));
    });

    connect(InsertAction,&QAction::triggered,this,[=](){
        std::cout << "insert action" << std::endl;
        ui->plainTextEdit->appendPlainText(QString("插入觸發"));
    });

    // 以刪除為例,演示如何刪除選中行
    connect(DeleteAction,&QAction::triggered,this,[=](){
        int row = ui->listWidget->currentRow();
        QListWidgetItem *aItem = ui->listWidget->takeItem(row);
        delete aItem;
        std::cout << "delete action" << std::endl;
        ui->plainTextEdit->appendPlainText(QString("刪除觸發"));
    });
}

MainWindow::~MainWindow()
{
    delete ui;
}

// 當listWidget被右鍵點選時則觸發
void MainWindow::on_listWidget_customContextMenuRequested(const QPoint &pos)
{
    std::cout << "x pos = "<< pos.x() << "y pos = " << pos.y() << std::endl;
    Q_UNUSED(pos);

    // 新建Menu選單
    QMenu *ptr = new QMenu(this);

    // 新增Actions建立選單項
    ptr->addAction(NewAction);
    ptr->addAction(InsertAction);
    // 新增一個分割線
    ptr->addSeparator();
    ptr->addAction(DeleteAction);

    // 在滑鼠游標位置顯示右鍵快捷選單
    ptr->exec(QCursor::pos());

    // 手工建立的指標必須手工刪除
    delete ptr;
}

程式碼執行效果如下:

ListWidget同樣支援一圖示方式顯示列表框內的元素，只需要設定setViewMode(QListView::IconMode)屬性即可實現圖示顯示，我們按照如上程式碼簡單改進即可，程式碼如下:

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QMenuBar>
#include <QMenu>
#include <QToolBar>
#include <iostream>

// 全域性下設定增加刪除選單
QAction *NewAction;
QAction *InsertAction;
QAction *DeleteAction;

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 使用 customContextMenuRequested 訊號則需要設定
    ui->listWidget_2->setContextMenuPolicy(Qt::CustomContextMenu);

    // 隱藏選單欄上的右擊選單
    this->setContextMenuPolicy(Qt::NoContextMenu);

    // 建立基礎頂部選單
    QMenuBar *bar = menuBar();
    this->setMenuBar(bar);
    QMenu * fileMenu = bar->addMenu("選單1");
    bar->setVisible(false);   // 隱藏頂部選單欄

    // 新增子選單
     NewAction = fileMenu->addAction("增加IP地址");
     InsertAction = fileMenu->addAction("插入IP地址");
     DeleteAction = fileMenu->addAction("刪除IP地址");

    // 分別設定圖示
    NewAction->setIcon(QIcon(":/image/1.ico"));
    InsertAction->setIcon(QIcon(":/image/2.ico"));
    DeleteAction->setIcon(QIcon(":/image/3.ico"));

    // 繫結槽函式
    connect(NewAction,&QAction::triggered,this,[=](){
        std::cout << "new action" << std::endl;
    });

    connect(InsertAction,&QAction::triggered,this,[=](){
        std::cout << "insert action" << std::endl;
    });

    // 以刪除為例,演示如何刪除選中行
    connect(DeleteAction,&QAction::triggered,this,[=](){
        int row = ui->listWidget_2->currentRow();
        QListWidgetItem *aItem = ui->listWidget_2->takeItem(row);
        delete aItem;
        std::cout << "delete action" << std::endl;
    });
	
	// 第二個ListWidget_使用圖示方式展示
    ui->listWidget_2->setViewMode(QListView::IconMode);

    // 每一行是一個QListWidgetItem
    QListWidgetItem *aItem;

    // 設定ICON的圖示
    QIcon aIcon;
    aIcon.addFile(":/image/1.ico");

    ui->listWidget_2->clear();
    for(int x=0;x<10;x++)
    {
        QString str = QString::asprintf("admin_%d",x);
        aItem = new QListWidgetItem();   // 新建一個項

        aItem->setText(str);                   // 設定文字標籤
        aItem->setIcon(aIcon);                 // 設定圖示
        //aItem->setCheckState(Qt::Checked);     // 設為選中狀態
        aItem->setFlags(Qt::ItemIsSelectable |  // 設定為不可編輯狀態
                         Qt::ItemIsUserCheckable
                        |Qt::ItemIsEnabled);

        ui->listWidget_2->addItem(aItem); //增加項
    }
}

MainWindow::~MainWindow()
{
    delete ui;
}

// By: LyShark
// https://www.cnblogs.com/lyshark
void MainWindow::on_listWidget_2_customContextMenuRequested(const QPoint &pos)
{
    std::cout << "x pos = "<< pos.x() << "y pos = " << pos.y() << std::endl;
    Q_UNUSED(pos);

    // 新建Menu選單
    QMenu *ptr = new QMenu(this);

    // 新增Actions建立選單項
    ptr->addAction(NewAction);
    ptr->addAction(InsertAction);
    // 新增一個分割線
    ptr->addSeparator();
    ptr->addAction(DeleteAction);

    // 在滑鼠游標位置顯示右鍵快捷選單
    ptr->exec(QCursor::pos());

    // 手工建立的指標必須手工刪除
    delete ptr;
}

程式碼執行效果如下:

相關文章