Qt基础：右键菜单

显示右键菜单, 其处理方式大体上有两种：

1. 基于鼠标事件实现；
2. 基于窗口的菜单策略实现。

1. 基于鼠标事件实现

1.1 原理

使用这种方式实现右键菜单的显示需要使用事件处理器函数, 在Qt中这类函数都是回调函数, 在自定义窗口类中我们还可以自定义事件处理器函数的行为（因为子类继承了父类的这个方法并且这类函数是虚函数）。
实现步骤如下：

1. 在当前窗口类中重写鼠标操作相关的的事件处理器函数，有两个可以选择

// 以下两个事件二选一即可, 只是事件函数被调用的时机不同罢了
// 这个时机对右键菜单的显示没有任何影响
[virtual protected] void QWidget::mousePressEvent(QMouseEvent *event);
[virtual protected] void QWidget::mouseReleaseEvent(QMouseEvent *event);

2. 在数据表事件处理器函数内部判断是否按下了鼠标右键
3. 如果按下了鼠标右键创建菜单对象(也可以提前先创建处理), 并将其显示出来

// 关于QMenu类型的菜单显示需要调用的 API
// 参数 p 就是右键菜单需要显示的位置, 这个坐标需要使用屏幕坐标
// 该位置坐标一般通过调用 QCursor::pos() 直接就可以得到了
QAction *QMenu::exec(const QPoint &p, QAction *action = nullptr);

1.2 操作

在头文件中添加要重写的鼠标事件处理器函数声明, 这里使用的是 mousePressEvent()。

// mainwindow.h中重写父类中的虚函数
protected:// 鼠标按下, 该函数被Qt框架调用, 需要重写该函数void mousePressEvent(QMouseEvent *event);
};

在源文件中重写从父类继承的虚函数mousePressEvent()

// mainwindow.cpp
void MainWindow::mousePressEvent(QMouseEvent *event)
{// 判断用户按下的是哪一个鼠标键if(event->button() == Qt::RightButton){// 弹出一个菜单, 菜单项是 QAction 类型QMenu menu;QAction* act = menu.addAction("C++");connect(act, &QAction::triggered, this, [=](){QMessageBox::information(this, "title", "您选择的是C++...");});menu.addAction("Java");menu.addAction("Python");menu.exec(QCursor::pos()); // 右键菜单被模态显示出来了}
}

2. 基于窗口的菜单策略实现

这种方式是使用 Qt 中 QWidget类中的右键菜单函数 QWidget::setContextMenuPolicy(Qt::ContextMenuPolicy policy) 来实现, 因为这个函数的参数可以指定不同的值, 因此不同参数对应的具体的实现方式也不同。
这个函数的函数原型如下：

// 函数原型:
void QWidget::setContextMenuPolicy(Qt::ContextMenuPolicy policy);
参数: 	- Qt::NoContextMenu	     --> 不能实现右键菜单- Qt::PreventContextMenu   --> 不能实现右键菜单- Qt::DefaultContextMenu   --> 基于事件处理器函数 QWidget::contextMenuEvent() 实现- Qt::ActionsContextMenu   --> 添加到当前窗口中所有 QAction 都会作为右键菜单项显示出来- Qt::CustomContextMenu    --> 基于 QWidget::customContextMenuRequested() 信号实现

2.1 Qt::DefaultContextMenu

使用这个策略实现右键菜单, 需要借助窗口类从父类继承的虚函数QWidget::contextMenuEvent()并重写它来实现。
要做的
第一步：是在窗口类的头文件中添加这个函数的声明

protected:// 如果窗口设置了 Qt::DefaultContextMenu 策略, // 点击鼠标右键该函数被Qt框架调用void contextMenuEvent(QContextMenuEvent *event);

第二步：在这个窗口类的构造函数设置右键菜单策略

	// 给窗口设置策略: Qt::DefaultContextMenu// 在窗口中按下鼠标右键, 这个事件处理器函数被qt框架调用 QWidget::contextMenuEvent()setContextMenuPolicy(Qt::DefaultContextMenu);

第三步：在这个窗口类的源文件中重写事件处理器函数 contextMenuEvent()

// mainwindow.cpp
void MainWindow::contextMenuEvent(QContextMenuEvent *event)
{// 弹出一个菜单, 菜单项是 QAction 类型QMenu menu;QAction* act = menu.addAction("C++");connect(act, &QAction::triggered, this, [=](){QMessageBox::information(this, "title", "您选择的是C++...");});menu.addAction("Java");menu.addAction("Python");menu.exec(QCursor::pos());	// 右键菜单被模态显示出来了
}

2.2 Qt::ActionsContextMenu

使用这个策略实现右键菜单, 是最简单的一种, 我们只需要创建一些 QAction类型的对象并且将他们添加到当前的窗口中, 当我们在窗口中点击鼠标右键这些QAction类型的菜单项就可以显示出来了。
虽然这种方法比较简单，但是它有一定的局限性，就是在一个窗口中不能根据不同的需求制作不同的右键菜单，这种方式只能得到一个唯一的右键菜单。
相关的处理代码如下：

// mainwindow.cpp
MainWindow::MainWindow(QWidget *parent) :QMainWindow(parent),ui(new Ui::MainWindow)
{ui->setupUi(this);// 只要将某个QAction添加给对应的窗口, 这个action就是这个窗口右键菜单中的一个菜单项了// 在窗口中点击鼠标右键, 就可以显示这个菜单setContextMenuPolicy(Qt::ActionsContextMenu);// 给当前窗口添加QAction对象QAction* act1  = new QAction("C++");QAction* act2 = new QAction("Java");QAction* act3  = new QAction("Python");this->addAction(act1);this->addAction(act2);this->addAction(act3);connect(act1, &QAction::triggered, this, [=](){QMessageBox::information(this, "title", "您选择的是C++...");});
}

2.3 Qt::CustomContextMenu

使用这个策略实现右键菜单, 当点击鼠标右键，窗口会产生一个 QWidget::customContextMenuRequested() 信号，注意仅仅只是发射信号，意味着要自己写显示右键菜单的槽函数（slot），这个信号是QWidget唯一与右键菜单有关的信号。
我们先来看一下这个信号的函数原型:

// 注意: 信号中的参数pos为当前窗口的坐标，并非屏幕坐标，右键菜单显示需要使用屏幕坐标
[signal] void QWidget::customContextMenuRequested(const QPoint &pos)

实现代码：

// 策略 Qt::CustomContextMenu// 当在窗口中点击鼠标右键, 窗口会发出一个信号: QWidget::customContextMenuRequested()// 对应发射出的这个信号, 需要添加一个槽函数, 用来显示右键菜单this->setContextMenuPolicy(Qt::CustomContextMenu);connect(this, &MainWindow::customContextMenuRequested, this, [=](const QPoint &pos){// 参数 pos 是鼠标按下的位置, 但是不能直接使用, 这个坐标不是屏幕坐标, 是当前窗口的坐标// 如果要使用这个坐标需要将其转换为屏幕坐标QMenu menu;QAction* act = menu.addAction("C++");connect(act, &QAction::triggered, this, [=](){QMessageBox::information(this, "title", "您选择的是C++...");});menu.addAction("Java");menu.addAction("Python");//直接得到屏幕坐标// menu.exec(QCursor::pos());// 将窗口坐标转换为屏幕坐标QPoint newpt = this->mapToGlobal(pos);menu.exec(newpt);});