三十、鼠标及键盘事件

发布时间:2023年12月19日

三十、鼠标及键盘事件

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 <QMainWindow>

#include<QMouseEvent>
#include<QMessageBox>
#include<QLabel>
#include<QStatusBar>

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的子类。这个类主要处理了鼠标的移动、点击事件,以及显示图片的功能。

  1. 构造函数

    • MainWindow的构造函数中,首先初始化了用户界面,然后设置了鼠标追踪,并设置了窗口的大小。
    • 接着,加载并显示了一个图片。
  2. 鼠标移动事件处理函数

    • 当鼠标在窗口内移动时,会更新鼠标位置的显示标签内容。
  3. 鼠标按下事件处理函数

    • 当鼠标被按下时,会根据按下的按钮类型(左键、右键、中键)在状态栏显示相应的消息。
  4. 鼠标释放事件处理函数

    • 当鼠标被释放时,会在状态栏显示消息,告知用户已经释放了鼠标。
  5. 显示图片函数

    • 这个函数用于加载并显示图片。如果图片加载失败,会弹出信息框提示用户。

从代码中可以看出,这个MainWindow类主要实现了鼠标事件的响应和图片的加载与显示功能。这些功能都是通过重写QMainWindow中的事件处理函数来实现的。同时,代码中也使用了Qt的一些常用组件,如QLabelQImage等来进行界面和图片的操作。

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 <QWidget>
#include<QKeyEvent>
#include<QPaintEvent>
#include<QPainter>

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;i<width;i=i+step)
    {
        painter->begin(pix);           // 开始绘图到指定的位图上
        painter->setPen(pen);          // 设置画笔颜色为网格线颜色
        painter->drawLine(QPoint(i,0),QPoint(i,height));  // 绘制一条从顶部到底部的水平线
        painter->end();                 // 结束绘图操作
    }
    // 绘制垂直网格线,间距为step像素,从上到下绘制,直到达到窗口高度为止
    for(int i=step;i<height;i=i+step)
    {
        painter->begin(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();
}

代码分析:

  1. 构造函数:Widget类的构造函数中,初始化了用户界面、设置了背景色、设置了窗口的大小,并创建了一个与窗口大小相同的白色位图。然后从指定路径加载了一张图片,并初始化了图片显示位置的起始点为(30,30)。最后,调用了drawPixFunc函数,开始在位图上绘制图片的边框和对角线网格。
  2. 析构函数:Widget类的析构函数负责释放创建的资源,例如删除用户界面对象。
  3. drawPixFunc函数:这个函数用于在位图上绘制网格和图片。首先将位图填充为绿色作为背景色,然后绘制了水平和垂直网格线,最后在网格中心位置绘制了图片。
  4. paintEvent函数:这个函数用于在画布上绘制图片。它创建了一个QPainter对象,并在当前对象上开始绘制,然后在画布上绘制了pixmap图片。
  5. keyPressEvent函数:这个函数用于处理键盘按键事件。当按下左键、右键、上键或下键时,它会更新图片的起始位置,并调用drawPixFunc函数进行绘制操作。最后,它更新了界面,使更改可见。
文章来源:https://blog.csdn.net/qq_67755192/article/details/135081815
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。