三十、鼠标及键盘事件
三十、鼠标及键盘事件
30.1 鼠标事件QMouseEvent
发生鼠标事件，当在 Widget 内按下 （或释放） 鼠标按钮 （或移动鼠标光标） 时。
才发生鼠标移动事件当按下鼠标按钮时，除非启用鼠标跟踪采用 QWidget：：setMouseTracking （）.
Qt 自动抓取鼠标当在 Widget 内按下鼠标按钮时;Widget 将继续接收鼠标事件，直到最后释放鼠标按钮。
鼠标事件包含特殊接受标志 (指示接收者是否想要事件)。应该调用 ignore （） 若鼠标事件未被 Widget 所处理。鼠标事件会沿父级 Widget 链向上传播，直到小部件接受它采用 accept （），或由事件过滤器消耗掉它。
注意 ： 若鼠标事件被传播给 widget 其中 Qt：：WA_NoMousePropagation 有设置，该鼠标事件将不会沿父级 Widget 链向上进一步传播。
可以找到键盘修饰符键的状态通过调用 modifiers（） 函数，继承自 QInputEvent .
函数 pos （）， x （），和 y （） 给出光标相对于接收鼠标事件的小部件的位置.如果由于鼠标事件而移动小部件，请使用 globalPos （） 返回的全局位置以避免晃动。
QWidget：：setEnabled （） 函数可用于启用 （或禁用） 小部件的鼠标事件和键盘事件。
重实现 QWidget 事件处理程序， QWidget：：mousePressEvent （）， QWidget：：mouseReleaseEvent （）， QWidget：：mouseDoubleClickEvent （），和 QWidget： ：mouseMoveEvent （） 以在自己的 Widget 中接收鼠标事件。
实现以下功能
mainwindow.h
#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include
#include
#include
#include
#include
QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACE
class MainWindow : public QMainWindow
{
Q_OBJECT
public:
MainWindow(QWidget *parent = nullptr);
~MainWindow();
private:
Ui::MainWindow *ui;
QLabel *statusLabel;
QLabel *mouseLabel;
void dispPicture();
protected:
void mouseMoveEvent(QMouseEvent *e);
void mousePressEvent(QMouseEvent *e);
void mouseReleaseEvent(QMouseEvent *e);
};
#endif // MAINWINDOW_H
mainwindow.cpp
#include "mainwindow.h"
#include "ui_mainwindow.h"
// MainWindow构造函数
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent) // 继承了QWidget类，创建一个主窗口
, ui(new Ui::MainWindow) // 初始化用户界面
{
ui->setupUi(this); // 配置用户界面
// 创建两个标签，用于显示鼠标的坐标
statusLabel=new QLabel("鼠标在当前窗口坐标为："); // 鼠标当前位置的标签
statusLabel->setFixedWidth(200); // 设置标签宽度为200像素
mouseLabel=new QLabel(); // 鼠标位置的显示标签
mouseLabel->setFixedWidth(200); // 设置标签宽度为200像素
// 将这两个标签添加到状态栏
statusBar()->addPermanentWidget(statusLabel);
statusBar()->addPermanentWidget(mouseLabel);
// 开启鼠标追踪，即可以获取鼠标的移动事件
this->setMouseTracking(true);
resize(800,600); // 设置窗口大小为800x600像素
// 加载并显示图片
dispPicture();
}
// MainWindow析构函数
MainWindow::~MainWindow()
{
delete ui; // 删除用户界面对象，释放内存
}
// 鼠标移动事件处理函数
void MainWindow::mouseMoveEvent(QMouseEvent *e)
{
// 更新鼠标位置的显示标签内容
mouseLabel->setText("("+QString::number(e->x())+","+QString::number(e->y())+")");
}
// 鼠标按下事件处理函数
void MainWindow::mousePressEvent(QMouseEvent *e)
{
QString str="("+QString::number(e->x())+","+QString::number(e->y())+")"; // 鼠标坐标字符串
if(e->button()==Qt::LeftButton) // 如果按下的是左键
{
statusBar()->showMessage("按下左键"+str); // 在状态栏显示消息
}
else if(e->button()==Qt::RightButton) // 如果按下的是右键
{
statusBar()->showMessage("按下右键"+str); // 在状态栏显示消息
}
else if(e->button()==Qt::MidButton) // 如果按下的是中键
{
statusBar()->showMessage("按下中键"+str); // 在状态栏显示消息
}
}
// 鼠标释放事件处理函数
void MainWindow::mouseReleaseEvent(QMouseEvent *e)
{
QString str="("+QString::number(e->x())+","+QString::number(e->y())+")"; // 鼠标坐标字符串
statusBar()->showMessage("用户已经释放鼠标坐标"+str); // 在状态栏显示消息
}
// 显示图片函数
void MainWindow::dispPicture()
{
QString str("D:/wallhaven-9d5x5k.png"); // 图片路径字符串
QImage *image=new QImage; // 创建QImage对象用于加载图片
QLabel *imageLabel=new QLabel(this); // 创建QLabel对象用于显示图片
imageLabel->move(20,20); // 设置图片标签的位置，距离窗口左上角20,20像素的位置开始显示图片
imageLabel->setFixedSize(700,400); // 设置图片标签的大小为700x400像素，即图片的大小为700x400像素
if(!(image->load(str))) // 如果图片加载失败（例如文件不存在、文件格式不正确等）
{
QMessageBox::information(this,"失败","图片加载失败"); // 弹出信息框提示用户图片加载失败
delete image; // 删除QImage对象，释放内存
return; // 结束函数执行，不再继续执行后续代码，因为已经无法加载图片了。
}
imageLabel->setPixmap(QPixmap::fromImage(*image)); // 将加载的图片转换为QPixmap对象，然后设置到QLabel对象上，显示图片。这里使用*image是因为QImage是const的，不能直接赋值给非const对象。需要先解引用一下。
}
代码提供了一个名为MainWindow的类，它是QMainWindow的子类。这个类主要处理了鼠标的移动、点击事件，以及显示图片的功能。
-
构造函数：
- 在
MainWindow的构造函数中，首先初始化了用户界面，然后设置了鼠标追踪，并设置了窗口的大小。 - 接着，加载并显示了一个图片。
- 在
-
鼠标移动事件处理函数：
- 当鼠标在窗口内移动时，会更新鼠标位置的显示标签内容。
-
鼠标按下事件处理函数：
- 当鼠标被按下时，会根据按下的按钮类型（左键、右键、中键）在状态栏显示相应的消息。
-
鼠标释放事件处理函数：
- 当鼠标被释放时，会在状态栏显示消息，告知用户已经释放了鼠标。
-
显示图片函数：
- 这个函数用于加载并显示图片。如果图片加载失败，会弹出信息框提示用户。
从代码中可以看出，这个MainWindow类主要实现了鼠标事件的响应和图片的加载与显示功能。这些功能都是通过重写QMainWindow中的事件处理函数来实现的。同时，代码中也使用了Qt的一些常用组件，如QLabel、QImage等来进行界面和图片的操作。
void QStatusBar::addPermanentWidget(QWidget *widget, int stretch = 0)：
将给定的小部件永久地添加到这个状态栏，如果小部件还不是这个QStatusBar对象的子部件，则重新定位它。随着状态栏的增长和收缩，stretch参数用于计算给定小部件的合适大小。默认的拉伸因子是0，即给小部件一个最小的空间。
永久意味着小部件可能不会被临时消息所掩盖。它位于状态栏的最右边。
void setMouseTracking(bool enable)：
此属性保存是否为小部件启用鼠标跟踪
如果禁用了鼠标跟踪(默认值)，则当移动鼠标时至少按下一个鼠标按钮时，小部件仅接收鼠标移动事件。
如果启用了鼠标跟踪，即使没有按下按钮，小部件也会接收鼠标移动事件。
void QStatusBar::showMessage(const QString &message, int timeout = 0)：
隐藏正常状态指示，并在指定的毫秒数(超时)内显示给定消息。如果timeout为0(默认值)，则消息保持显示，直到clearMessage()槽被调用，或者直到showMessage()槽被再次调用以更改消息。
请注意，调用showMessage()是为了显示工具提示文本的临时解释，因此传递超时0不足以显示永久消息。
bool QImage::load(const QString &fileName, const char *format = nullptr)：
从具有给定文件名的文件中加载图像。如果图像已成功加载，则返回true;否则将使图像无效并返回false。
加载程序尝试使用指定的格式读取图像，例如PNG或JPG。如果没有指定格式(这是默认的)，它会根据文件的后缀和头自动检测。具体操作请参见QImageReader::setAutoDetectImageFormat()。
30.2 键盘事件QKeyEvent
当按下或释放按键时，按键事件将发送到具有键盘输入焦点的小部件。
密钥事件包含一个特殊的接受标志，该标志指示接收方是否将处理密钥事件。默认情况下，QEvent：：KeyPress 和 QEvent：：KeyRelease 设置了此标志，因此在对键事件执行操作时无需调用 accept （）。对于 QEvent：：ShortcutOverride，接收方需要显式接受事件以触发覆盖。对关键事件调用 ignore （） 会将其传播到父小部件。该事件在父小部件链上向上传播，直到小部件接受它或事件过滤器使用它。
QWidget：：setEnabled （） 函数可用于启用 （或禁用） 小部件的鼠标事件和键盘事件。
事件处理程序 QWidget：：keyPressEvent （）， QWidget ：：keyReleaseEvent （）， QGraphicsItem：： keyPressEvent （） 和 QGraphicsItem ： ：keyReleaseEvent （） 接收键事件。
实现以下功能，可以上下左右移动
widget.h
#ifndef WIDGET_H
#define WIDGET_H
#include
#include
#include
#include
QT_BEGIN_NAMESPACE
namespace Ui { class Widget; }
QT_END_NAMESPACE
class Widget : public QWidget
{
Q_OBJECT
public:
Widget(QWidget *parent = nullptr);
~Widget();
void drawPixFunc();
void paintEvent(QPaintEvent *);
void keyPressEvent(QKeyEvent *);
private:
Ui::Widget *ui;
QPixmap *pix;
QImage image;
int startX;
int startY;
int width;
int height;
int step;
};
#endif // WIDGET_H
widget.cpp
#include "widget.h"
#include "ui_widget.h"
// Widget类的构造函数
Widget::Widget(QWidget *parent)
: QWidget(parent) // 调用基类QWidget的构造函数
, ui(new Ui::Widget) // 初始化用户界面
{
ui->setupUi(this); // 设置用户界面
// 自动填充背景色为白色
setAutoFillBackground(true);
// 设置窗口的背景颜色为白色
QPalette p=this->palette();
p.setColor(QPalette::Window,Qt::white);
setPalette(p);
// 设置窗口的最小和最大尺寸为800x600
setMinimumSize(800,600);
setMaximumSize(800,600);
// 获取窗口的宽度和高度
width=size().width();
height=size().height();
// 创建一个与窗口大小相同的白色位图
pix=new QPixmap(width,height);
pix->fill(Qt::white);
// 从指定路径加载一张图片
image.load("D:/file.jpg");
// 初始化图片显示位置的起始点为(30,30)
startX=30;
startY=30;
step=30;
// 调用drawPixFunc函数，开始在位图上绘制图片的边框和对角线网格
drawPixFunc();
}
// Widget类的析构函数，负责释放创建的资源
Widget::~Widget()
{
delete ui; // 删除用户界面对象，释放内存
}
// drawPixFunc函数，绘制位图上的网格和图片
void Widget::drawPixFunc()
{
pix->fill(Qt::green); // 将位图填充为绿色，作为背景色
QPainter *painter=new QPainter; // 创建一个QPainter对象，用于绘图
QPen pen(Qt::DashDotLine); // 创建一个画笔，用于绘制网格线
// 绘制水平网格线，间距为step像素，从左到右绘制，直到达到窗口宽度为止
for(int i=step;ibegin(pix); // 开始绘图到指定的位图上
painter->setPen(pen); // 设置画笔颜色为网格线颜色
painter->drawLine(QPoint(i,0),QPoint(i,height)); // 绘制一条从顶部到底部的水平线
painter->end(); // 结束绘图操作
}
// 绘制垂直网格线，间距为step像素，从上到下绘制，直到达到窗口高度为止
for(int i=step;ibegin(pix); // 开始绘图到指定的位图上
painter->setPen(pen); // 设置画笔颜色为网格线颜色
painter->drawLine(QPoint(0,i),QPoint(width,i)); // 绘制一条从左到右的垂直线
painter->end(); // 结束绘图操作
}
// 在网格中心位置绘制图片，起始点为(startX, startY)位置，大小为图片的实际大小（width和height已定义为窗口大小）
painter->begin(pix); // 开始绘图到指定的位图上
painter->drawImage(QPoint(startX,startY),image); // 绘制图片到指定位置和大小
painter->end(); // 结束绘图操作
}
// Widget 类的 paintEvent 函数，用于在画布上绘制图片
void Widget::paintEvent(QPaintEvent *)
{
// 创建一个 QPainter 对象，用于在画布上绘制
QPainter pt;
// 在当前对象上开始绘制
pt.begin(this);
// 在画布上绘制 pixmap 图片，起始位置为 (0,0)
pt.drawPixmap(QPoint(0,0),*pix);
// 结束绘制
pt.end();
}
// Widget 类的 keyPressEvent 函数，用于处理键盘按键事件
void Widget::keyPressEvent(QKeyEvent *e)
{
// 检查按键是否为左键、右键、上键或下键
if(e->key() == Qt::Key_Left) {
// 处理左键事件
startX = (startX - step < 0) ? startX : startX - step;
} else if(e->key() == Qt::Key_Right) {
// 处理右键事件
startX = (startX + step > width) ? startX : startX + step;
} else if(e->key() == Qt::Key_Up) {
// 处理上键事件
startY = (startY - step < 0) ? startY : startY - step;
} else if(e->key() == Qt::Key_Down) {
// 处理下键事件
startY = (startY + step > height) ? startY : startY + step;
}
// 调用 drawPixFunc 函数进行绘制操作
drawPixFunc();
// 更新界面，使更改可见
update();
}
代码分析：
- 构造函数：Widget类的构造函数中，初始化了用户界面、设置了背景色、设置了窗口的大小，并创建了一个与窗口大小相同的白色位图。然后从指定路径加载了一张图片，并初始化了图片显示位置的起始点为(30,30)。最后，调用了drawPixFunc函数，开始在位图上绘制图片的边框和对角线网格。
- 析构函数：Widget类的析构函数负责释放创建的资源，例如删除用户界面对象。
- drawPixFunc函数：这个函数用于在位图上绘制网格和图片。首先将位图填充为绿色作为背景色，然后绘制了水平和垂直网格线，最后在网格中心位置绘制了图片。
- paintEvent函数：这个函数用于在画布上绘制图片。它创建了一个QPainter对象，并在当前对象上开始绘制，然后在画布上绘制了pixmap图片。
- keyPressEvent函数：这个函数用于处理键盘按键事件。当按下左键、右键、上键或下键时，它会更新图片的起始位置，并调用drawPixFunc函数进行绘制操作。最后，它更新了界面，使更改可见。