Ubuntu下基于Qt的C++程序如何获取鼠标光标图像？

问题原因 #

你提到的这些光标属于Ubuntu（X11）系统的原生光标，Qt的QCursor::pixmap()方法对于这类光标无法直接返回有效像素图——因为Qt并没有将X11原生光标资源转换为Qt内部的像素图对象，而是直接使用窗口系统提供的光标句柄。

解决方案：调用X11的Xcursor库获取 #

要获取这些光标的图像，需要直接通过X11的Xcursor API加载系统光标资源，再转换为QPixmap。以下是具体实现步骤：

1. 安装依赖 #

首先确保Ubuntu系统上安装了Xcursor开发库：

sudo apt-get install libxcursor-dev

2. 修改项目配置文件（.pro） #

在Qt项目的.pro文件中添加X11和Xcursor的链接依赖：

QT += gui
LIBS += -lX11 -lXcursor

3. 实现光标获取函数 #

首先建立Qt光标枚举与X11光标名称的映射，然后编写函数加载并转换光标图像：

#include <QGuiApplication>
#include <QPlatformNativeInterface>
#include <QPixmap>
#include <QImage>
#include <X11/Xlib.h>
#include <X11/Xcursor/Xcursor.h>

// Qt光标类型到X11光标名称的映射
QHash<Qt::CursorShape, QString> cursorNameMap = {
    {Qt::ArrowCursor, "left_ptr"},
    {Qt::CrossCursor, "cross"},
    {Qt::OpenHandCursor, "openhand"},
    {Qt::ClosedHandCursor, "closedhand"},
    {Qt::SizeVerCursor, "size_ver"},
    {Qt::SizeHorCursor, "size_hor"}
};

QPixmap getSystemCursorPixmap(Qt::CursorShape shape) {
    // 获取当前X11显示对象
    Display* display = static_cast<Display*>(
        QGuiApplication::platformNativeInterface()->nativeResourceForWindow("display", nullptr)
    );
    if (!display) {
        return QPixmap();
    }

    // 查找对应的X11光标名称
    auto nameIter = cursorNameMap.find(shape);
    if (nameIter == cursorNameMap.end()) {
        // 非目标光标类型，尝试用Qt原生方法获取
        return QCursor(shape).pixmap();
    }
    const QByteArray cursorName = nameIter.value().toUtf8();

    // 加载X11光标
    Cursor xCursor = XcursorLibraryLoadCursor(display, cursorName.constData());
    if (!xCursor) {
        return QPixmap();
    }

    // 获取光标图像数据
    XcursorImage* cursorImage = XcursorImageLoadCursor(display, xCursor);
    if (!cursorImage) {
        XFreeCursor(display, xCursor);
        return QPixmap();
    }

    // 将Xcursor图像转换为QImage
    QImage image(cursorImage->width, cursorImage->height, QImage::Format_ARGB32);
    uchar* imageBits = image.bits();
    const int pixelSize = 4; // ARGB32每个像素占4字节

    for (int y = 0; y < cursorImage->height; ++y) {
        for (int x = 0; x < cursorImage->width; ++x) {
            const int pixelIndex = y * cursorImage->width + x;
            XcursorPixel xPixel = cursorImage->pixels[pixelIndex];

            // Xcursor像素格式是ABGR，转换为QImage的ARGB
            uint32_t argbPixel = (xPixel & 0xFF000000)       // Alpha通道
                               | ((xPixel & 0x00FF0000) >> 16) // Red ↔ Blue交换
                               | (xPixel & 0x0000FF00)       // Green通道保留
                               | ((xPixel & 0x000000FF) << 16); // Blue ↔ Red交换

            // 写入QImage数据
            memcpy(imageBits + pixelIndex * pixelSize, &argbPixel, pixelSize);
        }
    }

    // 清理X11资源
    XcursorImageDestroy(cursorImage);
    XFreeCursor(display, xCursor);

    // 转换为QPixmap返回
    return QPixmap::fromImage(image);
}

4. 使用示例 #

你可以直接调用这个函数获取指定光标像素图：

QPixmap arrowCursorPixmap = getSystemCursorPixmap(Qt::ArrowCursor);
if (!arrowCursorPixmap.isNull()) {
    // 使用像素图，比如显示在QComboBox或QLabel中
}

注意事项 #

• 该实现仅适用于X11环境的Ubuntu系统，符合你的应用场景；
• 确保你的Qt应用使用的是X11平台插件（默认情况下Ubuntu上的Qt应用会自动使用）；
• 若系统光标主题变更，该方法会自动加载当前主题下的对应光标图像。

内容的提问来源于stack exchange，提问作者gvanvoor