---

前言

在图形用户界面（GUI）应用程序中，鼠标指针（光标）是用户与应用程序交互的重要工具。Qt 提供了 QCursor 类来管理和控制鼠标指针的外观和行为。本文将详细介绍 QCursor 的概念、作用及其主要函数，并提供三个示例代码来帮助理解其使用方法。

---

QCursor

概念

QCursor 是 Qt 中用于表示和操作鼠标指针的类。它可以设置和获取鼠标指针的形状、位置，以及管理自定义光标图像。通过使用 QCursor，开发者可以灵活地改变应用程序中的鼠标指针，以提升用户体验。

作用

QCursor 的主要作用包括：

1. 改变光标形状：可以设置各种预定义的光标形状，例如箭头、等待光标、十字光标等。
2. 设置自定义光标：支持使用自定义图像作为光标。
3. 获取和设置光标位置：可以获取和设置光标在屏幕上的位置。

为什么需要 QCursor

在一些交互性较强的应用程序中，不同的操作和状态可能需要不同的光标形状来提示用户。例如，在绘图软件中，当用户选择不同的工具时，光标形状会相应改变。QCursor 提供了一种简单且高效的方式来实现这一点，从而增强用户体验。

QCursor 的主要函数和成员

函数列表

• QCursor()

  作用：构造一个默认的 QCursor 对象。

  参数：无。

  返回值：无。

• QCursor(Qt::CursorShape shape)

  作用：构造一个指定形状的 QCursor 对象。

  参数：

  • shape：光标的形状（例如 Qt::ArrowCursor、Qt::WaitCursor 等）。
    更多：

ConstantValueDescription	值	描述
Qt::ArrowCursor	0	标准箭头光标。
Qt::UpArrowCursor	1	指向屏幕顶部的向上箭头光标。
Qt::CrossCursor	2	十字光标，通常用于帮助用户精确选择屏幕上的一个点。
Qt::WaitCursor	3	沙漏或手表光标，通常在操作期间显示，这些操作会阻止用户与应用程序交互。
Qt::IBeamCursor	4	插入符号或文本光标，表示小部件可以接受和显示文本输入。
Qt::SizeVerCursor	5	用于垂直调整顶级窗口大小的光标。
Qt::SizeHorCursor	6	用于水平调整顶级窗口大小的光标。
Qt::SizeBDiagCursor	7	用于在右上角和左下角对顶级窗口进行对角线调整大小的光标。
Qt::SizeFDiagCursor	8	用于在左上角和右下角对顶级窗口进行对角线调整大小的光标。
Qt::SizeAllCursor	9	用于在任意方向调整顶级窗口大小的光标。
Qt::BlankCursor	10	空白/不可见光标，通常在需要隐藏光标形状时使用。
Qt::SplitVCursor	11	用于垂直分隔器的光标，表示可以水平拖动手柄以调整可用空间的使用。
Qt::SplitHCursor	12	用于水平分隔器的光标，表示可以垂直拖动手柄以调整可用空间的使用。
Qt::PointingHandCursor	13	指示手光标，通常用于可点击元素，如超链接。
Qt::ForbiddenCursor	14	禁止光标，通常在拖放操作期间显示，以指示拖动的内容不能放置在特定小部件或区域内。
Qt::OpenHandCursor	17	表示打开的手光标，通常用于表示光标下的区域是画布的可见部分，用户可以点击并拖动以滚动查看。
Qt::ClosedHandCursor	18	表示关闭的手光标，通常用于指示正在进行的涉及滚动的拖动操作。
Qt::WhatsThisCursor	15	带问号的箭头光标，通常用于指示小部件存在“这是什么？”帮助。
Qt::BusyCursor	16	沙漏或手表光标，通常在后台操作期间显示，这些操作允许用户与应用程序交互。
Qt::DragMoveCursor	20	通常在拖动项目时使用的光标。
Qt::DragCopyCursor	19	通常在拖动项目以复制时使用的光标。
Qt::DragLinkCursor	21	通常在拖动项目以创建链接时使用的光标。
Qt::BitmapCursor	24	位图光标。

返回值：无。

• QCursor(const QBitmap &bitmap, const QBitmap &mask, int hotX = -1, int hotY = -1)

  作用：使用指定的位图和掩码构造一个自定义 QCursor 对象。

  参数：

  • bitmap：光标的位图。
  • mask：光标的掩码。
  • hotX：光标热点的 X 坐标（默认为 -1）。
  • hotY：光标热点的 Y 坐标（默认为 -1）。

  返回值：无。

• Qt::CursorShape shape() const

  作用：返回 QCursor 的当前形状。

  参数：无。

  返回值：光标的形状。

• void setShape(Qt::CursorShape shape)

  作用：设置 QCursor 的形状。

  参数：

  • shape：新的光标形状。

  返回值：无。

• QPoint pos() const

  作用：返回当前光标的位置。

  参数：无。

  返回值：光标的位置。

• void setPos(int x, int y)

  作用：设置光标的位置。

  参数：

  • x：光标的 X 坐标。
  • y：光标的 Y 坐标。

  返回值：无。

示例代码

示例 1：改变光标形状

以下示例展示了如何改变窗口中的光标形状：

#include <QApplication>
#include <QWidget>
#include <QCursor>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QWidget window;
    window.setCursor(Qt::CrossCursor); // 设置光标为十字形
    window.resize(400, 300);
    window.show();

    return app.exec();
}

示例 2：自定义光标

以下示例展示了如何使用自定义图像设置光标：

#include <QApplication>
#include <QWidget>
#include <QCursor>
#include <QBitmap>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QBitmap bitmap(":/images/cursor_bitmap.png"); // 自定义光标的位图
    QBitmap mask(":/images/cursor_mask.png");     // 自定义光标的掩码
    QCursor customCursor(bitmap, mask, 0, 0);     // 创建自定义光标

    QWidget window;
    window.setCursor(customCursor); // 设置自定义光标
    window.resize(400, 300);
    window.show();

    return app.exec();
}

示例 3：获取和设置光标位置

以下示例展示了如何获取和设置光标的位置：

#include <QApplication>
#include <QWidget>
#include <QCursor>
#include <QTimer>
#include <QDebug>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QWidget window;
    window.resize(400, 300);
    window.show();

    // 定时器每秒获取和设置光标位置
    QTimer timer;
    QObject::connect(&timer, &QTimer::timeout, [&]() {
        QPoint pos = QCursor::pos(); // 获取光标位置
        qDebug() << "Current cursor position:" << pos;

        // 将光标位置设置到窗口中心
        QPoint center = window.rect().center();
        QCursor::setPos(window.mapToGlobal(center));
    });
    timer.start(1000); // 每秒触发一次

    return app.exec();
}

---

总结

QCursor 是 Qt 提供的一个强大且灵活的类，用于管理和控制鼠标指针的外观和行为。通过使用 QCursor，开发者可以轻松地改变光标形状、设置自定义光标以及获取和设置光标位置。在交互性较强的应用程序中，合理地使用 QCursor 可以显著提升用户体验。希望通过本文和示例代码，读者能够更好地理解和掌握 QCursor 的使用方法。