Класс QTouchDevice
Класс QTouchDevice описывает устройство, из которого происходят события касания. Подробнее...
| Заголовок: | #include <QTouchDevice> |
| qmake: | QT += gui |
| С момента: | Qt 5.0 |
Типы публичного доступа
| флаги | Возможности |
| перечисление | CapabilityFlag { Position, Area, Pressure, Velocity, ..., MouseEmulation } |
| перечисление | ТипУстройства { СенсорныйЭкран, СенсорнаяПоверхность } |
Функции публичного доступа
| QTouchDevice() | |
| ~QTouchDevice() | |
| Возможности | capabilities() const |
| int | maximumTouchPoints() const |
| QString | name() const |
| void | setCapabilities(Возможности caps) |
| void | setMaximumTouchPoints(int max) |
| void | setName(const QString &name) |
| void | setType(ТипУстройства devType) |
| ТипУстройства | type() const |
Статические члены публичного доступа
| QList<const QTouchDevice *> | devices() |
Подробное описание
Класс QTouchDevice описывает устройство, из которого происходят события касания.
Каждый QTouchEvent содержит указатель QTouchDevice, позволяющий получить доступ к свойствам, специфичным для устройства, таким как тип и возможности. Платформа или общие плагины должны зарегистрировать доступные устройства касания через QWindowSystemInterface до генерации каких-либо событий касания. Приложениям не нужно создавать экземпляры этого класса, они должны получать доступ к глобальным экземплярам, на которые указывает QTouchEvent::device().
Документация по типам членов
перечисление QTouchDevice::CapabilityFlagфлаги QTouchDevice::Возможности
Это перечисление используется с QTouchDevice::capabilities(), чтобы указать, какой вид информации может предоставить устройство касания или его драйвер.
| Постоянная | Значение | Описание |
|---|---|---|
QTouchDevice::Position |
0x0001 |
Указывает, что информация о позиции доступна, что означает, что функции pos() в точках касания возвращают допустимые точки. |
QTouchDevice::Area |
0x0002 |
Указывает, что информация о области касания доступна, что означает, что функции rect() в точках касания возвращают допустимые прямоугольники. |
QTouchDevice::Pressure |
0x0004 |
Указывает, что информация о давлении доступна, что означает, что pressure() возвращает допустимое значение. |
QTouchDevice::Velocity |
0x0008 |
Указывает, что информация о скорости доступна, что означает, что velocity() возвращает допустимый вектор. |
QTouchDevice::RawPositions |
0x0010 |
Указывает, что список, возвращаемый QTouchEvent::TouchPoint::rawScreenPositions(), может содержать одну или несколько позиций для каждой точки касания. Это актуально, когда входные данные касания фильтруются или корректируются на уровне драйвера. |
QTouchDevice::NormalizedPosition |
0x0020 |
Указывает, что доступна нормализованная позиция, что означает, что normalizedPos() возвращает допустимое значение. |
QTouchDevice::MouseEmulation |
0x0040 |
Указывает, что устройство имитирует события мыши. Это значение перечисления было добавлено в Qt 5.5. |
Тип Возможности — это синоним QFlags<CapabilityFlag>. Он хранит логическое ИЛИ комбинацию значений CapabilityFlag.
перечисление QTouchDevice::ТипУстройства
Это перечисление представляет тип устройства, которое сгенерировало QTouchEvent.
| Постоянная | Значение | Описание |
|---|---|---|
QTouchDevice::TouchScreen |
0 |
В этом типе устройства сенсорная поверхность и дисплей интегрированы. Это означает, что поверхность и дисплей, как правило, имеют одинаковый размер, таким образом, существует прямая связь между физическими позициями точек касания и координатами, которые сообщает QTouchEvent::TouchPoint. В результате Qt позволяет пользователю взаимодействовать напрямую с несколькими QWidgets и QGraphicsItems одновременно. |
QTouchDevice::TouchPad |
1 |
В этом типе устройства сенсорная поверхность отделена от дисплея. Нет прямой связи между физическим местоположением касания и координатами на экране. Вместо этого они вычисляются относительно текущей позиции мыши, и пользователь должен использовать сенсорную поверхность, чтобы перемещать эту точку отсчета. В отличие от сенсорных экранов, Qt позволяет пользователям взаимодействовать только с одним QWidget или QGraphicsItem одновременно. |
Документация по функциям-членам
QTouchDevice::QTouchDevice()
Создает новый экземпляр устройства касания. По умолчанию имя пустое, единственная возможность — Position, а тип — СенсорныйЭкран.
QTouchDevice::~QTouchDevice()
Уничтожает экземпляр устройства касания.
Возможности QTouchDevice::capabilities() const
Возвращает возможности устройства касания.
См. также setCapabilities().
[static] QList<const QTouchDevice *> QTouchDevice::devices()
Возвращает список всех зарегистрированных устройств.
Примечание: Возвращаемый список нельзя использовать для добавления новых устройств. Используйте QWindowSystemInterface::registerTouchDevice() вместо этого.
int QTouchDevice::maximumTouchPoints() const
Возвращает максимальное количество одновременных точек касания (пальцев), которые могут быть обнаружены.
Эта функция была добавлена в Qt 5.2.
См. также setMaximumTouchPoints().
QString QTouchDevice::name() const
Возвращает имя устройства касания.
Эта строка часто может быть пустой. Однако она полезна для систем, имеющих более одного устройства ввода касания, поскольку она может использоваться для различения устройств (т.е. для определения устройства, из которого исходит QTouchEvent).
См. также setName().
void QTouchDevice::setCapabilities(Возможности caps)
Устанавливает возможности caps, поддерживаемые устройством и его драйвером.
См. также capabilities().
void QTouchDevice::setMaximumTouchPoints(int max)
Устанавливает максимальное количество одновременных точек касания max, поддерживаемых устройством и его драйвером.
См. также maximumTouchPoints().
void QTouchDevice::setName(const QString &name)
Устанавливает name (уникальный идентификатор) для устройства. В большинстве систем достаточно оставить это значение неопределенным и сохранить имя по умолчанию — пустое. Этот идентификатор становится важным, когда есть несколько устройств касания и необходимо различать их.
См. также name().
void QTouchDevice::setType(DeviceType devType)
Устанавливает тип устройства devType.
См. также type().
DeviceType QTouchDevice::type() const
Возвращает тип сенсорного устройства.
См. также setType().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.6/qtouchdevice.html
