Класс QInputDevice

Класс QInputDevice описывает устройство, из которого исходит событие QInputEvent. Подробнее...

• Список всех членов, включая унаследованные

Типы публичного доступа

Публичные функции

Сигналы

Статические публичные члены

Подробное описание

Каждое событие QInputEvent содержит указатель QInputDevice, чтобы получить доступ к свойствам устройства, таким как тип, возможности и местоположение. Ответственность платформы или общих плагинов — обнаружить, создать и зарегистрировать экземпляр этого класса, соответствующий каждому доступному устройству ввода, с помощью QWindowSystemInterface::registerInputDevice(), прежде чем генерировать любое событие ввода, относящееся к этому устройству.

Приложениям не нужно создавать экземпляры этого класса, но они могут прочитать экземпляры, на которые указывают QInputEvent::device() и QInputDevice::devices().

Документация по типам членов

перечисление QInputDevice::Возможностьфлаги QInputDevice::Возможности

Указывает, какой тип информации устройство ввода или его драйвер могут предоставить.

Тип Возможности — псевдоним для QFlags<Возможность>. Он хранит логическое ИЛИ сочетание значений Возможность.

перечисление QInputDevice::ТипУстройствафлаги QInputDevice::ТипыУстройств

Это перечисление представляет тип устройства, которое сгенерировало QPointerEvent.

Тип DeviceTypes — это псевдоним для QFlags<DeviceType>. Он хранит логическое ИЛИ сочетание значений DeviceType.

Документация по функциям-членам

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

Создаёт новый экземпляр устройства ввода. Переданное значение name обычно является именем модели, назначенным производителем, если доступно, или чем-то другим, что можно идентифицировать; id — это платформа-специфическое число, которое будет уникальным для каждого устройства (например, идентификатор xinput на X11); type определяет тип устройства. В системах окон, которые способны обрабатывать ввод от нескольких пользователей или наборов устройств ввода одновременно (таких как Wayland или X11), seatName определяет имя набора устройств, которые будут использоваться вместе. Если устройство является дочерним или подчиненным устройством (например, одна из нескольких мышей, которые могут по очереди перемещать «главный указатель»), то в качестве parent должно быть указано главное устройство.

Плагин платформы создаёт, регистрирует и продолжает владеть каждым экземпляром устройства; обычно parent должен быть указан для управления памятью, даже если для конкретного устройства нет главного устройства.

По умолчанию capabilities() равны None.

QInputDevice::QInputDevice(QObject *parent = nullptr)

Создаёт новый экземпляр недействительного устройства ввода, как дочернее устройство для parent.

QRect QInputDevice::availableVirtualGeometry() const

Возвращает область на виртуальном рабочем столе виртуального рабочего стола, к которой может получить доступ это устройство.

Например, устройство ввода TouchScreen зафиксировано на одной физической панели и обычно откалибровано так, что эта область совпадает с QScreen::geometry; в то время как устройство ввода Mouse может, вероятно, получить доступ ко всем экранам на виртуальном рабочем столе. Графический планшет Wacom может быть настроен так, что он отображается на всех экранах или только на экране, где пользователь предпочитает создавать рисунки, или на окне, в котором происходит рисование. Устройство Stylus, интегрированное с сенсорным экраном, может быть физически ограничено этим экраном.

Если возвращаемый прямоугольник равен нулю, это означает, что это устройство может получить доступ ко всему виртуальному рабочему столу.

Примечание: Функция-геттер для свойства availableVirtualGeometry.

QInputDevice::Capabilities QInputDevice::capabilities() const

Возвращает возможности устройства.

Примечание: Функция-геттер для свойства capabilities.

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

Возвращает список всех зарегистрированных устройств ввода (клавиатур и указательных устройств).

Примечание: Возвращаемый список нельзя использовать для добавления новых устройств. Для добавления имитируемого сенсорного экрана для автоматизированного тестирования можно использовать QTest::createTouchDevice(). Плагины платформы должны вызывать QWindowSystemInterface::registerInputDevice() для добавления устройств по мере их обнаружения.

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

Возвращает значение, указывающее, содержит ли набор возможностей устройства переданную возможность capability.

QString QInputDevice::name() const

Возвращает имя устройства.

Эта строка может быть пустой. Однако она полезна в системах с несколькими устройствами ввода: её можно использовать для различения, из какого устройства исходит QPointerEvent.

Примечание: Функция-геттер для свойства name.

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

Возвращает основную или главную клавиатуру на заданном сиденье seatName.

QString QInputDevice::seatName() const

Возвращает сиденье, с которым связано устройство, если известно; в противном случае пустую строку.

Устройства, предназначенные для совместного использования одним пользователем, могут быть настроены так, чтобы иметь одинаковое имя сиденья. Это возможно только на платформах Wayland и X11.

Примечание: Функция-геттер для свойства seatName.

qint64 QInputDevice::systemId() const

Возвращает платформенно-специфический системный идентификатор (например, идентификатор xinput на платформе X11).

Все платформы должны предоставлять уникальный системный идентификатор для каждого устройства.

Примечание: Функция-геттер для свойства systemId.

QInputDevice::DeviceType QInputDevice::type() const

Возвращает тип устройства.

Примечание: Функция-геттер для свойства type.