QInputDevice 类

成员函数文档

QInputDevice::QInputDevice(QObject *parent = nullptr)

创建一个新的无效输入设备实例，作为 parent 的子级。

QInputDevice::QInputDevice(const QString &name, qint64 id, QInputDevice::DeviceType type, const QString &seatName = QString(), QObject *parent = nullptr)

创建一个新的输入设备实例。提供的 name 通常是在可用时由制造商分配的型号名称，或者某些可识别的东西；id 是平台特定的数字，对于每个设备来说是唯一的（例如 X11 上的 xinput ID）；type 用来标识设备类型。在能够同时处理来自多个用户或输入设备集的输入的窗口系统（如 Wayland 或 X11）上，seatName 用来标识将一起使用的设备集的名称。如果设备是子设备或从设备（例如，可以交替移动“核心指针”的多个鼠标之一），则应将其主设备作为 parent 提供。

平台插件创建、注册并继续拥有每个设备实例；通常即使没有特定设备的主设备，也应提供 parent 以进行内存管理。

默认情况下，能力() 为 None。

QRect QInputDevice::availableVirtualGeometry() const

返回该设备可以在其中访问的虚拟桌面内的区域。

例如，一个固定的 TouchScreen 输入设备位于单个物理屏幕上，并且通常校准，使该区域与 QScreen::geometry() 相同；而 鼠标 可能可以访问虚拟桌面上的所有屏幕。Wacom图形板可以配置为映射到所有屏幕，或只映射到用户希望绘制的地方的屏幕，或映射到绘图发生的窗口。一个与触摸屏集成的 Stylus 设备可能在物理上是受限制的，仅限于该屏幕。

如果返回的矩形为 null，则表示该设备可以访问整个虚拟桌面。

QInputDevice::Capabilities QInputDevice::capabilities() const

返回设备功能。

[static] QList<const QInputDevice *> QInputDevice::devices()

返回所有已注册输入设备（键盘和指针设备）的列表。

bool QInputDevice::hasCapability(QInputDevice::Capability capability) const

返回设备功能是否包含指定的 功能。

QString QInputDevice::name() const

返回设备名称。

此字符串可能为空。但在具有多个输入设备的系统中很有用：它可以用来区分 QPointerEvent 的来源。

[static] const QInputDevice *QInputDevice::primaryKeyboard(const QString &seatName = QString())

返回给定 seatName 的核心或主键盘。

QString QInputDevice::seatName() const

如果有，返回与设备关联的 seat；否则为空。

旨在由同一用户共同使用的设备可以配置为具有相同的 seat 名称。目前这只在 Wayland 和 X11 平台上可行。

[static, since 6.3] QStringList QInputDevice::seatNames()

返回所有已注册输入设备（键盘和指针设备）的 seat 名称列表。

此函数是在 Qt 6.3 中引入的。

qint64 QInputDevice::systemId() const

返回平台特定的系统ID（例如X11平台的xinput ID）。

预期所有平台为每个设备提供一个唯一的系统ID。

QInputDevice::DeviceType QInputDevice::type() const

返回设备类型。